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;")