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
1.9 KiB
1.9 KiB
ADR-004: Sistema de Constantes SSOT
Estado: Aceptada Fecha: 2025-11-24 Responsable: Architecture-Analyst Proyecto: ERP Construccion
Contexto
Necesitamos eliminar duplicacion de constantes (enums, estados, schemas) entre capas para evitar inconsistencias.
Decision
Backend como Single Source of Truth (SSOT) con sincronizacion automatica a Frontend.
// backend/src/shared/constants/database.constants.ts
export const DB_SCHEMAS = {
AUTH: 'auth_management',
PROJECTS: 'project_management', // Especifico construccion
ESTIMATES: 'estimates_management', // Especifico construccion
// ...
};
export const PROJECT_STATUS = {
PLANNING: 'planning',
IN_PROGRESS: 'in_progress',
COMPLETED: 'completed',
SUSPENDED: 'suspended',
};
Script sync-enums.ts genera constantes para Frontend automaticamente.
Justificacion
Referencia a Gamilit
- Elimina 96% de duplicacion
- Refactoring 10x mas rapido
- Validacion pre-commit de consistencia
Especifico para Construccion
- Estados de obra sincronizados (planeacion, ejecucion, terminada)
- Estados INFONAVIT unificados
- Constantes de presupuesto centralizadas
Consecuencias
Positivas
- Eliminacion de duplicacion: 96%
- Reduccion de bugs por inconsistencias: 80%
- Tiempo de refactoring: -60%
Negativas
- Requiere disciplina para usar constantes
- Mitigacion: Validacion pre-commit
Implementacion
Acciones Requeridas
- Implementar script sync-enums.ts
- Centralizar constantes en backend/src/shared/constants/
- Agregar constantes especificas de construccion
- Agregar validacion pre-commit
Criterios de Aceptacion
- Frontend usa constantes generadas desde Backend
- Zero hardcoding de valores criticos
- Validacion pre-commit funcional