100 lines
2.6 KiB
Markdown
100 lines
2.6 KiB
Markdown
# 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:**
|
|
```json
|
|
{
|
|
"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
|
|
- [x] Crear estructura de carpetas
|
|
- [x] Configurar npm workspaces
|
|
- [x] 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
|
|
|
|
## Referencias
|
|
- [ERP Generico ADR-002](../../erp-generic/docs/adr/ADR-002-arquitectura-modular.md)
|
|
- [Gamilit Backend Patterns](../../shared/reference/gamilit/backend-patterns.md)
|