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

ERP Generico ADR-005

1.5 KiB Raw Blame History