Files
admin-edu-space/backend/app/services/audit_service.py
T

86 lines
2.8 KiB
Python

from typing import Optional, List, Dict, Any
import json
from app import db
from app.models.audit_log import AuditLog
from app.models.user import User
class AuditService:
"""Servicio para la captura y consulta de la bitácora inmutable de auditoría."""
@staticmethod
def log(action: str, module: str, entity_id: Optional[int] = None,
details: Optional[Any] = None, user: Optional[User] = None,
ip_address: Optional[str] = None,
user_id: Optional[int] = None,
user_email: Optional[str] = None,
status: Optional[str] = None,
**kwargs) -> AuditLog:
"""
Registra un evento de auditoría de forma segura e inmutable.
"""
if status:
if isinstance(details, dict):
details['status'] = status
elif details:
details = f"[{status.upper()}] {details}"
else:
details = {'status': status}
# 1. Determinar usuario actuante
if user:
user_id = user.id
user_email = user.email
# 2. IP de origen
if not ip_address:
ip_address = '127.0.0.1'
# 3. Serializar detalles si es estructura de datos
details_str = None
if details is not None:
if isinstance(details, (dict, list)):
try:
details_str = json.dumps(details, ensure_ascii=False)
except Exception:
details_str = str(details)
else:
details_str = str(details)
audit_entry = AuditLog(
action=action,
module=module,
entity_id=entity_id,
details=details_str,
user_id=user_id,
user_email=user_email,
ip_address=ip_address
)
try:
db.session.add(audit_entry)
db.session.commit()
except Exception:
db.session.rollback()
return audit_entry
@staticmethod
def get_logs(module: Optional[str] = None, action: Optional[str] = None,
user_id: Optional[int] = None, limit: int = 50) -> List[AuditLog]:
"""Recupera los eventos más recientes con filtros opcionales."""
query = AuditLog.query
if module:
query = query.filter(AuditLog.module == module)
if action:
query = query.filter(AuditLog.action == action)
if user_id:
query = query.filter(AuditLog.user_id == user_id)
return query.order_by(AuditLog.created_at.desc()).limit(limit).all()
@staticmethod
def get_recent_logs(limit: int = 50, module: Optional[str] = None,
action: Optional[str] = None) -> List[AuditLog]:
return AuditService.get_logs(module=module, action=action, limit=limit)