workspace-v1/projects/erp-construccion/docs/97-adr/ADR-005-path-aliases.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
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
2026-01-04 03:37:42 -06:00

66 lines
1.5 KiB
Markdown

# ADR-005: Path Aliases
**Estado:** Aceptada
**Fecha:** 2025-11-24
**Responsable:** Architecture-Analyst
**Proyecto:** ERP Construccion
## Contexto
Imports relativos profundos dificultan refactoring y legibilidad.
## Decision
**Path aliases** en Backend y Frontend:
```typescript
// Antes
import { Button } from '../../../shared/ui/Button';
// Despues
import { Button } from '@shared/ui';
import { ProjectStatus } from '@construccion/constants';
```
**Aliases:**
- `@shared` - Componentes compartidos
- `@modules` - Modulos de negocio
- `@construccion` - Modulos especificos de construccion
- `@erp-generic` - Imports del ERP Generico
## Justificacion
### Referencia a Gamilit
- Imports limpios y consistentes
- Refactoring facil
### Especifico para Construccion
- Separacion clara entre generico y especifico
- `@construccion` para modulos de obra, INFONAVIT, etc.
## Consecuencias
### Positivas
- Imports limpios
- Refactoring facil (mover carpetas sin romper imports)
- Claridad en origen de modulos
### Negativas
- Configuracion inicial en tsconfig
- Mitigacion: Setup una sola vez
## Implementacion
### Acciones Requeridas
- [ ] Configurar tsconfig.json con aliases
- [ ] Configurar vite.config.ts con aliases
- [ ] Refactorizar imports existentes
### Criterios de Aceptacion
- Todos los imports usan aliases
- Build funcional con aliases
- IDE resuelve aliases correctamente
## Referencias
- [ERP Generico ADR-005](../../erp-generic/docs/adr/ADR-005-path-aliases.md)