0011. Entidades con patrón party y dos proyecciones¶
Estado: Aceptado (enmendado por el ADR 0067 de identidad)
Fecha: 2026-10-27
Autor: Duval Alcivar
Módulo(s) afectado(s): panel administrativo (core-admin): dominio entidades
Evidencia: commit 388ac27 (2026-10-27) y las superficies /entidades/admin, /personas, /juridicas, /existe/{id}
Nota (ADR 0067 de identidad): las proyecciones pasaron a llamarse persona (
PERSONA) y persona comercial (PERSONA_COMERCIAL), y/juridicases hoy/comerciales(renombrado duro, sin alias). El panel las expone como/entidades/admin/personasy/entidades/admin/comerciales, con las vistasPersonaView.vueyPersComercialView.vuey las rutasentidades/personasyentidades/personas-comerciales. La persona comercial exigetipo_contribuyente(PERSONA_NATURALoPERSONA_JURIDICA). Este ADR conserva los nombres de su fecha.
Contexto¶
Identidad modela las entidades con patrón party: una entidad raíz común y dos proyecciones, persona natural y persona jurídica, según el ADR 0025 de identidad. El panel debía reflejar esa forma sin duplicar la identidad de una misma entidad.
Decisión¶
Se expone una entidad raíz en /entidades/admin con consulta de existencia en
/existe/{id}, y dos proyecciones, /personas y /juridicas, que reutilizan
CatalogCrud con campos distintos. Los contratos siguen los definidos por el ADR
0025 de identidad.
Alternativas descartadas¶
- Dos tablas separadas sin entidad común — una misma entidad podría existir dos veces y se rompería la referencia única que exige el backend.
Consecuencias¶
Las reglas compartidas (existencia, identificación) viven en la entidad raíz y cada proyección declara solo sus campos propios. La validación de forma queda repartida entre el descriptor de cada proyección y el backend.
Documentado a posteriori desde el código y el historial de Git del repositorio core-admin; la fecha corresponde al commit que introdujo la decisión, no a la fecha de publicación en este sitio (2026-11-09).