Saltar a contenido

0024. Esquema plano por servicio

Estado: Aceptado Fecha: 2026-10-06 Autor: Duval Alcivar Módulo(s) afectado(s): app/core/db.py, .env.example Modifica a: ADR 0004 transversal (allí el esquema es <producto>.<servicio>, p. ej. crm.clientes) Evidencia: commit b6d89f5 (2026-10-06) «refactor(db): renombrar el esquema a fuerza_ventas»; ADR 0014 del servicio (2026-10-06); app/core/db.py (search_path desde DATABASE_SCHEMAS); .env.example.

Contexto

El transversal 0004 propone un esquema con producto y servicio (crm.fuerza_ventas). La separación entre productos ya la da la base (core_sigfa, crm_sigfapro, erp_sigfa); repetir el producto en el esquema duplica una información que la conexión ya determina.

Decisión

Cada microservicio usa un esquema plano con su nombre: identidad, clientes, fuerza_ventas. El search_path de la conexión se arma con DATABASE_SCHEMAS y cada tabla declara __table_args__ = {"schema": ...}.

Alternativas descartadas

  • crm.fuerza_ventas — lo que propone el transversal 0004; repite el producto que ya fija la base.
  • Prefijos de tabla en un esquema único — ya descartado por el propio transversal.

Consecuencias

docs-sql y los ADR transversales deben hablar de esquemas planos. Las consultas sin calificar dependen del search_path de la conexión.


Estos ADR se escribieron después de la implementación; la fecha corresponde al commit que introdujo la decisión, no a la publicación en este sitio (2026-11-09).