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[Any] = None, details: Optional[Any] = None, user: Optional[Any] = None, ip_address: Optional[str] = None, user_id: Optional[Any] = None, user_email: Optional[Any] = None, status: Optional[str] = None, **kwargs) -> Optional[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 = getattr(user, 'id', None) user_email = getattr(user, 'email', None) if user_id is not None: try: user_id = int(user_id) except Exception: pass if user_email is not None: user_email = str(user_email) if entity_id is not None: try: entity_id = int(entity_id) except Exception: pass # 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)