workspace-v1/projects/erp-construccion/docs/97-adr/ADR-004-sistema-constantes-ssot.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

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

Referencias