workspace/projects/erp-suite/apps/verticales/construccion/docs/97-adr/ADR-005-path-aliases.md
rckrdmrd ea1879f4ad feat: Initial workspace structure with multi-level Git configuration
- Configure workspace Git repository with comprehensive .gitignore
- Add Odoo as submodule for ERP reference code
- Include documentation: SETUP.md, GIT-STRUCTURE.md
- Add gitignore templates for projects (backend, frontend, database)
- Structure supports independent repos per project/subproject level

Workspace includes:
- core/ - Reusable patterns, modules, orchestration system
- projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.)
- knowledge-base/ - Reference code and patterns (includes Odoo submodule)
- devtools/ - Development tools and templates
- customers/ - Client implementations template

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-08 10:44:23 -06:00

1.5 KiB

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:

// 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