Saltar a contenido

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 /juridicas es hoy /comerciales (renombrado duro, sin alias). El panel las expone como /entidades/admin/personas y /entidades/admin/comerciales, con las vistas PersonaView.vue y PersComercialView.vue y las rutas entidades/personas y entidades/personas-comerciales. La persona comercial exige tipo_contribuyente (PERSONA_NATURAL o PERSONA_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).