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',
)