66161b1566
Sistema NEXUS v3.4 migrado con: Estructura principal: - core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles) - core/catalog: Catalogo de funcionalidades reutilizables - shared/knowledge-base: Base de conocimiento compartida - devtools/scripts: Herramientas de desarrollo - control-plane/registries: Control de servicios y CI/CD - orchestration/: Configuracion de orquestacion de agentes Proyectos incluidos (11): - gamilit (submodule -> GitHub) - trading-platform (OrbiquanTIA) - erp-suite con 5 verticales: - erp-core, construccion, vidrio-templado - mecanicas-diesel, retail, clinicas - betting-analytics - inmobiliaria-analytics - platform_marketing_content - pos-micro, erp-basico Configuracion: - .gitignore completo para Node.js/Python/Docker - gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git) - Sistema de puertos estandarizado (3005-3199) Generated with NEXUS v3.4 Migration System EPIC-010: Configuracion Git y Repositorios
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)
|