Saltar a contenido

0008 - trx_marcaciones

"""trx_marcaciones (particionada por rango de fecha_marcacion)

Revision ID: 0008
Revises: 0007
Create Date: 2026-09-21
"""
from typing import Sequence, Union

from alembic import op

# revision identifiers, used by Alembic.
revision: str = "0008"
down_revision: str | None = "0007"
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None


def upgrade() -> None:
    # La partición mensual se gestiona fuera de esta especificación: aquí solo
    # se define la tabla base con PARTITION BY RANGE (fecha_marcacion).
    op.execute(
        """
        CREATE TABLE IF NOT EXISTS core.notificaciones.trx_marcaciones (
            id UUID NOT NULL DEFAULT gen_random_uuid(),
            empresa_id BIGINT NOT NULL,
            dispositivo_id UUID NOT NULL,
            tipo_marcacion_id UUID,
            identificacion_empleado TEXT NOT NULL,
            empleado_id UUID,
            fecha_marcacion TIMESTAMPTZ NOT NULL,
            origen TEXT NOT NULL DEFAULT 'dispositivo',
            payload_crudo JSONB,
            fecha_publicado_rrhh TIMESTAMPTZ,

            -- Auditoría ligera (solo inserción)
            created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
            created_by UUID,

            CONSTRAINT pk_trx_marcaciones PRIMARY KEY (id, fecha_marcacion),
            CONSTRAINT fk_trx_marcaciones_dispositivo
                FOREIGN KEY (empresa_id, dispositivo_id)
                REFERENCES core.notificaciones.mae_dispositivos_biometricos (empresa_id, id),
            CONSTRAINT fk_trx_marcaciones_tipo
                FOREIGN KEY (tipo_marcacion_id)
                REFERENCES core.notificaciones.cat_tipos_marcacion (id),
            -- El reloj reenvía al reconectar: la clave descarta el duplicado sola.
            CONSTRAINT uq_trx_marcaciones_dispositivo_empleado_fecha UNIQUE (dispositivo_id, identificacion_empleado, fecha_marcacion)
        ) PARTITION BY RANGE (fecha_marcacion);

        CREATE INDEX IF NOT EXISTS ix_trx_marcaciones_empleado ON core.notificaciones.trx_marcaciones (identificacion_empleado, fecha_marcacion);
        CREATE INDEX IF NOT EXISTS ix_trx_marcaciones_empresa_id ON core.notificaciones.trx_marcaciones (empresa_id);
        CREATE INDEX IF NOT EXISTS ix_trx_marcaciones_sin_publicar ON core.notificaciones.trx_marcaciones (fecha_marcacion) WHERE fecha_publicado_rrhh IS NULL;
        CREATE INDEX IF NOT EXISTS ix_trx_marcaciones_tipo_marcacion_id ON core.notificaciones.trx_marcaciones (tipo_marcacion_id);

        -- Comentarios
        COMMENT ON TABLE core.notificaciones.trx_marcaciones IS 'Única fuente de verdad de la marcación cruda. svc-rrhh la recibe por evento: cierra el gap de las dos asistencias sin puente ETL.';
        COMMENT ON COLUMN core.notificaciones.trx_marcaciones.empresa_id IS 'Empresa propietaria de la marcación';
        COMMENT ON COLUMN core.notificaciones.trx_marcaciones.dispositivo_id IS 'Dispositivo biométrico que registró la marcación (FK compuesta con empresa_id)';
        COMMENT ON COLUMN core.notificaciones.trx_marcaciones.tipo_marcacion_id IS 'Tipo de marcación (catálogo global)';
        COMMENT ON COLUMN core.notificaciones.trx_marcaciones.identificacion_empleado IS 'Identificación del empleado tal como la reportó el dispositivo';
        COMMENT ON COLUMN core.notificaciones.trx_marcaciones.empleado_id IS 'Empleado resuelto por svc-rrhh (referencia lógica, sin FK)';
        COMMENT ON COLUMN core.notificaciones.trx_marcaciones.fecha_marcacion IS 'Fecha y hora de la marcación (clave de partición)';
        COMMENT ON COLUMN core.notificaciones.trx_marcaciones.origen IS 'Origen de la marcación: dispositivo u otro';
        COMMENT ON COLUMN core.notificaciones.trx_marcaciones.payload_crudo IS 'Respuesta cruda del dispositivo (trazabilidad y reproceso)';
        COMMENT ON COLUMN core.notificaciones.trx_marcaciones.fecha_publicado_rrhh IS 'Fecha en que svc-rrhh consumió el evento; NULL si aún no se publicó';
        """
    )


def downgrade() -> None:
    op.execute("DROP TABLE IF EXISTS core.notificaciones.trx_marcaciones;")