Saltar a contenido

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).