101 lines
3.2 KiB
Python
101 lines
3.2 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[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)
|