Saltar a contenido

Orden de Ejecución: core.notificaciones

Esquema: core.notificaciones
Base de Datos: core
Servicio: svc-notificaciones

Propósito: Definir el orden obligatorio de creación de objetos del esquema. El desorden rompe la migración: cada objeto que referencia a otro debe ejecutarse después de su dependencia (FKs, tipos y esquemas previos).


1. Justificación y Mejoras de Arquitectura

  • Un único orden de ejecución evita errores de dependencia entre objetos (FKs compuestas, enum, esquemas).
  • El enum estado_mensaje es un tipo de dato; debe existir antes que cualquier tabla que lo use (trx_mensajes).
  • Las tablas padre con tenencia exponen la clave alterna uq_<tabla>_empresa_id UNIQUE (empresa_id, id) que las tablas hijas referencian en sus FKs compuestas.
  • Tablas globales (cat_canales, cat_tipos_marcacion) no dependen de nada interno y se crean temprano.

2. Orden de Ejecución

# Objeto Sentencia / Comando Depende de Qué falla si se ejecuta fuera de orden
1 Esquema CREATE SCHEMA IF NOT EXISTS core.notificaciones; — Todo: ningún objeto puede crearse sin el esquema
2 Tipo ENUM CREATE TYPE core.notificaciones.estado_mensaje AS ENUM ('pendiente','enviando','enviado','fallido','cancelado'); 1 trx_mensajes falla: la columna estado usa el tipo
3 Catálogo cat_canales 1 FK de mae_plantillas_mensaje y trx_mensajes falla
4 Catálogo cat_tipos_marcacion 1 FK de trx_marcaciones falla
5 Maestra mae_plantillas_mensaje 1, 3 FK a cat_canales falla si el catálogo no existe
6 Maestra mae_grupos_destinatarios 1 — (sin dependencias internas)
7 Maestra mae_dispositivos_biometricos 1 — (sin dependencias internas)
8 Relación rel_grupo_destinatario_usuario 1, 6 FK compuesta a mae_grupos_destinatarios falla
9 Transaccional trx_mensajes 1, 2, 3, 5, y core.identidad.mae_documentos FKs a cat_canales, mae_plantillas_mensaje y mae_documentos (núcleo) fallan; el enum debe existir
10 Transaccional trx_marcaciones 1, 4, 7 FK a mae_dispositivos_biometricos y cat_tipos_marcacion fallan

3. Notas finales

  • Procedimientos, triggers y bandejas de eventos salientes se documentarán en una etapa posterior.
  • trx_eventos_salientes y las tablas log_* no pertenecen a este servicio.
  • La partición mensual de trx_marcaciones se gestiona fuera de esta especificación: aquí solo se define la tabla base con PARTITION BY RANGE (fecha_marcacion).
  • core.identidad.mae_documentos es un objeto externo del núcleo; debe existir antes de ejecutar el paso 9.