0002. Estructura por dominios con una capa compartida¶
Estado: Aceptado
Fecha: 2026-10-23
Autor: Duval Alcivar
Módulo(s) afectado(s): panel administrativo (core-admin): organización del código
Evidencia: commit 5c3ab19 (2026-10-23) y los árboles src/domains, src/shared y src/app
Contexto¶
En el corte inicial el código estaba agrupado por capa técnica: src/views,
src/layouts, src/router, src/api, src/components, src/utils y
src/session.ts. Cada funcionalidad obligaba a tocar cuatro carpetas para
encontrar su vista, su llamada de API y sus componentes, y no había un lugar
obvio donde mirar el estado completo de un módulo.
Decisión¶
Se reorganiza el código por dominio, no por capa técnica: src/app (router),
src/domains/<dominio>/{api,components,composables,views},
src/shared/{http,layouts,components,views}, más src/config, src/types y
src/utils. Un dominio se reconoce por su carpeta y un dominio nuevo se crea
clonando la forma de otro.
Alternativas descartadas¶
- Mantener la estructura por capas del 2026-10-21 — cada feature seguía dispersa en cuatro carpetas y el límite del dominio quedaba implícito.
Consecuencias¶
Un módulo completo se lee en una sola carpeta y se puede extraer o reasignar sin
tocar el resto. El costo es la duplicación inicial de la forma por dominio y la
necesidad de decidir, para cada pieza nueva, si pertenece al dominio o a
shared.
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).