Saltar a contenido

Log de Sesión — core.identidad.log_sesiones

Bitácora transaccional de intentos y eventos de sesión (login/logout/fallos).

from datetime import datetime, date
from typing import Optional
import uuid

from sqlalchemy import (
    BigInteger,
    Boolean,
    CheckConstraint,
    Date,
    DateTime,
    ForeignKey,
    Identity,
    Index,
    Integer,
    SmallInteger,
    String,
    Text,
    UniqueConstraint,
    text,
)
from sqlalchemy.dialects import postgresql
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column


class Base(DeclarativeBase):
    pass

class LogSesion(Base):
    __tablename__ = 'log_sesiones'
    __table_args__ =         {"schema": 'core.identidad'},

    id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        primary_key=True,
        server_default=text("gen_random_uuid()"),
    )
    empresa_id: Mapped[int | None] = mapped_column(
        BigInteger,
        comment='Empresa de la sesión (NULL en intentos pre-autenticación)',
    )
    usuario_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        ForeignKey("mae_usuarios.id"),
        comment='Usuario involucrado',
    )
    username_ingresado: Mapped[str] = mapped_column(
        String(50),
        nullable=False,
        comment='Nombre de usuario capturado al inicio del intento',
    )
    accion: Mapped[str | None] = mapped_column(
        String(20),
        comment='Acción registrada (login, logout, fallo)',
    )
    token_jti: Mapped[uuid.UUID | None] = mapped_column(
        UUID(as_uuid=True),
        comment='Identificador del JWT emitido',
    )
    ip: Mapped[str | None] = mapped_column(
        String(45),
        comment='IP origen',
    )
    user_agent: Mapped[str | None] = mapped_column(
        String(300),
        comment='User-Agent del cliente',
    )
    exitoso: Mapped[bool | None] = mapped_column(
        Boolean,
        comment='Resultado de la acción',
    )
    razon_fallo: Mapped[str | None] = mapped_column(
        String(100),
        comment='Motivo del fallo',
    )

    # Auditoría General
    created_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True),
        nullable=False,
        server_default=text("now()"),
        comment='Fecha de creación',
    )