from __future__ import annotations from fastapi import Request from sqlalchemy.orm import Session from sakura_cloud.models.admin import AdminAuditLog from sakura_cloud.models.user import User def write_admin_audit_log( db: Session, admin: User, *, action: str, target_type: str | None = None, target_id: str | None = None, request: Request | None = None, detail: dict | None = None, ) -> AdminAuditLog: ip_address = request.client.host if request is not None and request.client is not None else None user_agent = request.headers.get("User-Agent") if request is not None else None row = AdminAuditLog( admin_user_id=admin.id, action=action, target_type=target_type, target_id=target_id, ip_address=ip_address, user_agent=user_agent, detail_json=_redact_detail(detail or {}), ) db.add(row) db.commit() db.refresh(row) return row def _redact_detail(value: dict) -> dict: redacted: dict = {} for key, item in value.items(): lowered = str(key).lower() if any(marker in lowered for marker in ("password", "token", "secret", "cookie", "key")): redacted[key] = "***" else: redacted[key] = item return redacted