Marcación — core.notificaciones.trx_marcaciones¶
Única fuente de verdad de la marcación biométrica cruda: cada fila es una marcación de un dispositivo, recibida por evento y publicada a svc-rrhh.
"""``core.notificaciones.trx_marcaciones``: fuente de verdad de la marcación biométrica cruda.
Auditoría ligera solo-inserción (created_at, created_by): tabla de registro
transaccional de alto volumen, sin borrado lógico ni actualización (mismo
criterio que trx_refresh_tokens en core.identidad).
"""
import uuid
from datetime import datetime
from sqlalchemy import (
BigInteger,
ForeignKeyConstraint,
Index,
PrimaryKeyConstraint,
Text,
UniqueConstraint,
text,
)
from sqlalchemy.dialects.postgresql import JSONB, TIMESTAMPTZ, UUID
from sqlalchemy.orm import Mapped, mapped_column
from app.db.base import Base
class TrxMarcacion(Base):
__tablename__ = "trx_marcaciones"
__table_args__ = (
# PK compuesta: el id UUID es local por partición y la fecha participa
# de la unicidad global.
PrimaryKeyConstraint("id", "fecha_marcacion", name="pk_trx_marcaciones"),
ForeignKeyConstraint(
["empresa_id", "dispositivo_id"],
[
"core.notificaciones.mae_dispositivos_biometricos.empresa_id",
"core.notificaciones.mae_dispositivos_biometricos.id",
],
name="fk_trx_marcaciones_dispositivo",
),
ForeignKeyConstraint(
["tipo_marcacion_id"],
["core.notificaciones.cat_tipos_marcacion.id"],
name="fk_trx_marcaciones_tipo",
),
# El reloj reenvía al reconectar: la clave descarta el duplicado sola.
UniqueConstraint(
"dispositivo_id",
"identificacion_empleado",
"fecha_marcacion",
name="uq_trx_marcaciones_dispositivo_empleado_fecha",
),
Index("ix_trx_marcaciones_empleado", "identificacion_empleado", "fecha_marcacion"),
Index("ix_trx_marcaciones_empresa_id", "empresa_id"),
# Índice parcial para el barrido de marcaciones sin publicar a svc-rrhh.
Index(
"ix_trx_marcaciones_sin_publicar",
"fecha_marcacion",
postgresql_where=text("fecha_publicado_rrhh IS NULL"),
),
Index("ix_trx_marcaciones_tipo_marcacion_id", "tipo_marcacion_id"),
{"schema": "core.notificaciones"},
)
id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True), server_default=text("gen_random_uuid()")
)
empresa_id: Mapped[int] = mapped_column(BigInteger, nullable=False)
dispositivo_id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True), nullable=False
)
tipo_marcacion_id: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True), nullable=True
)
identificacion_empleado: Mapped[str] = mapped_column(Text, nullable=False)
# Referencia lógica a svc-rrhh (sin FK): lo resuelve por evento, igual que
# en la spec.
empleado_id: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True), nullable=True
)
fecha_marcacion: Mapped[datetime] = mapped_column(
TIMESTAMPTZ, nullable=False
)
origen: Mapped[str] = mapped_column(
Text, nullable=False, server_default=text("'dispositivo'")
)
payload_crudo: Mapped[object | None] = mapped_column(JSONB, nullable=True)
fecha_publicado_rrhh: Mapped[datetime | None] = mapped_column(
TIMESTAMPTZ, nullable=True
)
# Auditoría ligera (solo inserción)
created_at: Mapped[datetime] = mapped_column(
TIMESTAMPTZ, nullable=False, server_default=text("now()")
)
created_by: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True), nullable=True
)