Saltar a contenido

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
    )