from app import db from datetime import datetime class AuditLog(db.Model): """ Bitácora inmutable de auditoría para registro de eventos críticos y trazabilidad de operaciones institucionales. """ __tablename__ = 'audit_logs' id = db.Column(db.Integer, primary_key=True) user_id = db.Column(db.Integer, db.ForeignKey('users.id', ondelete='SET NULL'), nullable=True) user_email = db.Column(db.String(255), nullable=True) action = db.Column(db.String(50), nullable=False, index=True) # CREATE, UPDATE, DELETE, LOGIN, LOGOUT module = db.Column(db.String(50), nullable=False, index=True) # classrooms, reservations, auth, users entity_id = db.Column(db.Integer, nullable=True) # ID del registro afectado details = db.Column(db.Text, nullable=True) # Detalles de cambios o parámetros ip_address = db.Column(db.String(45), nullable=True) # Soporta IPv4 e IPv6 created_at = db.Column(db.DateTime, default=datetime.utcnow, nullable=False, index=True) # Relación con usuario user = db.relationship('User', foreign_keys=[user_id], backref=db.backref('audit_records', lazy='dynamic')) def __repr__(self): return f"" def to_dict(self): """Serializa el registro de auditoría a diccionario JSON.""" return { 'id': self.id, 'user_id': self.user_id, 'user_email': self.user_email, 'action': self.action, 'module': self.module, 'entity_id': self.entity_id, 'details': self.details, 'ip_address': self.ip_address, 'created_at': self.created_at.strftime('%Y-%m-%d %H:%M:%S') if self.created_at else None, 'created_at_iso': self.created_at.isoformat() if self.created_at else None }