"""Helper de auditoría: registra acciones clave en la tabla audit_log. El registro nunca debe romper la acción principal: si algo falla, se ignora. Llamar DESPUÉS de confirmar (commit) la acción principal del endpoint. """ from typing import Optional from fastapi import Request from sqlalchemy.orm import Session from app.models.audit_log import AuditLog from app.models.user import User def client_ip(request: Optional[Request]) -> Optional[str]: if request is None: return None fwd = request.headers.get("x-forwarded-for") if fwd: return fwd.split(",")[0].strip() return request.client.host if request.client else None def log_action( db: Session, *, account_id: int, user_id: int, action: str, resource: str, details: Optional[dict] = None, ip: Optional[str] = None, ) -> None: try: db.add(AuditLog( account_id=account_id, user_id=user_id, action=action, resource=resource, details=details, ip_address=ip, )) db.commit() except Exception: db.rollback() def log_for( db: Session, actor: User, action: str, resource: str, details: Optional[dict] = None, request: Optional[Request] = None, ) -> None: """Atajo: registra una acción hecha por `actor`.""" log_action( db, account_id=actor.account_id, user_id=actor.id, action=action, resource=resource, details=details, ip=client_ip(request), )