talos-access / backend /app /utils /audit.py
Greg
Claude Opus 4.7 (1M context)
Quick wins de asistencia: auditoría, tardanzas, dashboard, portal representante y matrícula
8381024
Raw History Blame Contribute Delete
1.58 kB
"""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),
)