ADR-002: Arquitectura Modular Monorepo

Estado: Aceptada Fecha: 2025-11-24 Responsable: Architecture-Analyst Proyecto: ERP Construccion

Contexto

Necesitamos organizar el codigo en una estructura escalable y mantenible que soporte:

Multiples aplicaciones (backend, frontend, mobile)
Componentes compartidos con ERP Generico
Modulos especificos de construccion
Desarrollo en equipo

Decision

Monorepo con estructura:

erp-construccion/
+-- apps/
|   +-- database/       # DDL, seeds
|   +-- backend/        # API REST
|   +-- frontend/       # Web app
|   +-- mobile/         # React Native (asistencias)
+-- packages/           # Librerias compartidas
+-- docs/               # Documentacion
+-- devops/             # Scripts, CI/CD

Dependencia de ERP Generico:

{
  "dependencies": {
    "@erp-generic/core": "^1.0.0",
    "@erp-generic/financial": "^1.0.0",
    "@erp-generic/purchasing": "^1.0.0",
    "@erp-generic/ui-components": "^1.0.0"
  }
}

Justificacion

Referencia a Gamilit

Estructura probada en produccion
Organizacion clara por aplicacion
Facil navegacion y onboarding

Alineacion con ERP Generico

Misma estructura permite reutilizacion
Modulos especificos se agregan sin conflicto

Especifico para Construccion

Modulo mobile separado para asistencias GPS
Modulos especificos: proyectos-obra, estimaciones, INFONAVIT

Consecuencias

Positivas

Escalabilidad (agregar nuevas apps)
Reutilizacion de codigo (packages compartidos + ERP Generico)
Desarrollo en equipo sin conflictos
Testing aislado por app
61% de reutilizacion del ERP Generico

Negativas

Complejidad inicial de setup
Requiere herramientas monorepo (npm workspaces)
Gestion de versiones con ERP Generico

Alternativas Consideradas

1. Repositorios separados

Rechazada: Dificulta sincronizacion con ERP Generico

2. Monolito unico

Rechazada: No escalable, no permite reutilizacion

3. Fork del ERP Generico

Rechazada: Perdemos actualizaciones automaticas

Implementacion

Acciones Requeridas

Crear estructura de carpetas
Configurar npm workspaces
Setup path aliases
Configurar dependencias de ERP Generico

Criterios de Aceptacion

Apps pueden importar packages compartidos
Apps pueden importar modulos de ERP Generico
Build independiente por app funcional
Modulos especificos no afectan al generico

2.6 KiB Raw Permalink Blame History