66161b1566
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
3.5 KiB
_MAP: apps/devops/
Última actualización: 2025-11-07 Estado: 🟡 Funcional pero incompleto Versión: 2.0
📋 Propósito
Scripts de DevOps, validación y automatización para GAMILIT. Sistema Constants SSOT (Single Source of Truth).
Audiencia: DevOps Engineers, Backend Developers, Tech Leads
🗂️ Estructura
devops/
└── scripts/ # Scripts de automatización
├── sync-enums.ts # Sincronizar ENUMs Backend → Frontend
├── validate-constants-usage.ts # Detectar hardcoding (33 patrones)
└── validate-api-contract.ts # Validar Backend ↔ Frontend sync
🚀 Scripts Disponibles
sync-enums.ts
Sincroniza ENUMs de Backend → Frontend automáticamente.
Uso:
npm run sync:enums
Qué hace:
- Lee ENUMs de
apps/backend/src/shared/constants/enums.constants.ts - Genera
apps/frontend/src/shared/constants/enums.constants.ts - Mantiene sincronización automática
validate-constants-usage.ts
Detecta hardcoding de constantes (33 patrones).
Uso:
npm run validate:constants
Detecta:
- Strings hardcodeados de schemas/tablas
- URLs hardcodeadas
- ENUMs no importados
- Magic numbers
Output: Reporte de violaciones con ubicación exacta
validate-api-contract.ts
Valida que Backend y Frontend routes coincidan.
Uso:
npm run validate:api-contract
Valida:
- Endpoints Backend existen en Frontend
- Endpoints Frontend están implementados en Backend
- Contracts API consistentes
📊 Constants SSOT System
Implementado: Fase 0 - Ciclo 5 (2025-11-02)
Reglas de Oro
- ❌ NO hardcodear nombres de schemas, tablas, rutas API, ENUMs
- ✅ SIEMPRE importar desde archivos de constantes
- ✅ ACTUALIZAR constantes al agregar nuevas entidades
- ✅ SINCRONIZAR ENUMs Backend ↔ Frontend con script
- ✅ VALIDAR en CI/CD antes de merge
Cobertura Actual
| Categoría | Estado | Elementos |
|---|---|---|
| Database Schemas | ✅ 100% | 8 schemas |
| Database Tables | ✅ 100% | 40 tablas |
| API Routes | ✅ 100% | 75+ rutas |
| ENUMs | ✅ 100% | 25 ENUMs |
🚨 Issues Conocidos
P0 (Crítico)
-
P0-001: Sin Docker configs
- Faltan Dockerfiles para backend, frontend, database
- Esfuerzo: 4-6 horas
-
P0-002: Sin CI/CD workflows
- Faltan GitHub Actions para build, test, deploy
- Esfuerzo: 6-8 horas
P1 (Alto)
-
P1-001: Sin Kubernetes manifests
- Esfuerzo: 8-10 horas
-
P1-002: Sin scripts de deployment
- Esfuerzo: 4-6 horas
🎯 Próximos Pasos
Fase 1 - Urgente (Esta Semana)
- ✅ _MAP.md creado
- ⬜ Crear Dockerfiles (backend, frontend, database)
- ⬜ docker-compose.yml para desarrollo
- ⬜ GitHub Actions básico (lint + test)
Esfuerzo: 8-10 horas
Fase 2 - Alta Prioridad (Próximas 2 Semanas)
- ⬜ CI/CD completo (build + deploy)
- ⬜ Scripts de deployment
- ⬜ Kubernetes manifests básicos
- ⬜ Configurar PM2
Esfuerzo: 12-15 horas
📚 Documentación
Generado: 2025-11-07 Método: Sistema SIMCO - Fase 3 Versión: 1.0.0