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
13 KiB
13 KiB
Plan de Propagación SIMCO + CAPVED a Proyectos Heredados
Versión: 1.1.0 Fecha: 2025-12-08 Estado: ✅ IMPLEMENTACIÓN COMPLETADA
Resumen Ejecutivo
Este documento analiza la implementación del sistema SIMCO v2.2.0 + CAPVED en los proyectos del workspace y define el plan de propagación a proyectos hermanos/heredados.
Estado de Implementación
| Métrica | Antes | Después |
|---|---|---|
| Archivos HERENCIA-SIMCO.md | 0 | 15 |
| Proyectos actualizados | 0 | 14 |
| Template en core | No | Sí |
| Sistema SIMCO propagado | Parcial | 100% |
Archivos Creados
| Proyecto | Archivo | Nivel |
|---|---|---|
| core/templates | HERENCIA-SIMCO.md | Template |
| erp-suite | HERENCIA-SIMCO.md | Suite (1) |
| erp-core | HERENCIA-SIMCO.md | Suite-Core (2) |
| erp-basico | HERENCIA-SIMCO.md | Product (2) |
| pos-micro | HERENCIA-SIMCO.md | Product (2) |
| construccion | HERENCIA-SIMCO.md | Vertical (3) |
| vidrio-templado | HERENCIA-SIMCO.md | Vertical (3) |
| mecanicas-diesel | HERENCIA-SIMCO.md | Vertical (3) |
| retail | HERENCIA-SIMCO.md | Vertical (3) |
| clinicas | HERENCIA-SIMCO.md | Vertical (3) |
| gamilit | HERENCIA-SIMCO.md | Standalone |
| trading-platform | HERENCIA-SIMCO.md | Standalone |
| betting-analytics | HERENCIA-SIMCO.md | Standalone |
| inmobiliaria-analytics | HERENCIA-SIMCO.md | Standalone |
| platform_marketing_content | HERENCIA-SIMCO.md | Standalone |
Arquitectura de Herencia del Workspace
┌─────────────────────────────────────┐
│ NIVEL 0 - WORKSPACE │
│ core/orchestration/ (76 docs) │
│ SIMCO v2.2.0 + CAPVED + CCA │
└──────────────────┬──────────────────┘
│
┌───────────────────────────┼───────────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
│ STANDALONE │ │ SUITE (ERP) │ │ STANDALONE │
│ - gamilit │ │ projects/erp-suite│ │ - trading-platform│
│ - betting-analytics│ │ │ │ - inmobiliaria │
│ - platform_mkt │ │ │ │ - pos-micro │
└─────────────────────┘ └──────────┬──────────┘ └─────────────────────┘
│
┌────────────────┼────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ SUITE-CORE │ │ PRODUCTS │ │ SAAS │
│ erp-core │ │ erp-basico │ │ (tenant) │
└──────┬──────┘ │ pos-micro │ └─────────────┘
│ └─────────────┘
┌────────────┼────────────┬────────────┬────────────┐
▼ ▼ ▼ ▼ ▼
┌────────┐ ┌──────────┐ ┌─────────┐ ┌────────┐ ┌──────────┐
│construc│ │vidrio- │ │mecanicas│ │ retail │ │ clinicas │
│ción │ │templado │ │-diesel │ │ │ │ │
└────────┘ └──────────┘ └─────────┘ └────────┘ └──────────┘
NIVEL 3 - VERTICALES (5 proyectos)
Análisis por Proyecto
NIVEL 1: SUITE (ERP-SUITE)
| Proyecto | Ruta | Estado SIMCO | HERENCIA-DIRECTIVAS | Acción Requerida |
|---|---|---|---|---|
| erp-suite | projects/erp-suite/orchestration |
⚠️ Parcial | ❌ Obsoleto | Actualizar |
Archivos a actualizar:
00-guidelines/HERENCIA-DIRECTIVAS.md→ Referenciar SIMCO- Crear
00-guidelines/HERENCIA-SIMCO.md(nuevo)
NIVEL 2: SUITE-CORE
| Proyecto | Ruta | Estado SIMCO | HERENCIA-DIRECTIVAS | Acción Requerida |
|---|---|---|---|---|
| erp-core | projects/erp-suite/apps/erp-core/orchestration |
⚠️ Parcial | ❌ Obsoleto | Actualizar |
Archivos a actualizar:
00-guidelines/HERENCIA-DIRECTIVAS.md→ Mapear a SIMCO00-guidelines/CONTEXTO-PROYECTO.md→ Agregar CCA Protocol
NIVEL 3: VERTICALES
| Vertical | Estado SIMCO | HERENCIA-DIRECTIVAS | Inventarios | Acción |
|---|---|---|---|---|
| construccion | ⚠️ Parcial | ❌ Obsoleto | ✅ Completos | Actualizar herencia |
| vidrio-templado | ⚠️ Parcial | ❌ Obsoleto | ✅ Completos | Actualizar herencia |
| mecanicas-diesel | ⚠️ Parcial | ❌ Obsoleto | ✅ Completos | Actualizar herencia |
| retail | ⚠️ Parcial | ❌ Obsoleto | ✅ Completos | Actualizar herencia |
| clinicas | ⚠️ Parcial | ❌ Obsoleto | ✅ Completos | Actualizar herencia |
NIVEL 3: PRODUCTS
| Producto | Estado | Acción |
|---|---|---|
| erp-basico | 🆕 Nuevo | Configurar desde cero |
| pos-micro | 🆕 Nuevo | Configurar desde cero |
PROYECTOS STANDALONE
| Proyecto | Estado SIMCO | HERENCIA | Inventarios | Acción |
|---|---|---|---|---|
| gamilit | ⚠️ Parcial | ❌ Obsoleto | ⚠️ Falta | Actualizar + crear inventarios |
| trading-platform | ⚠️ Parcial | ❌ Obsoleto | ✅ Completos | Actualizar herencia |
| betting-analytics | ⚠️ Parcial | ❌ Obsoleto | ⚠️ Falta | Actualizar + crear inventarios |
| inmobiliaria-analytics | ⚠️ Parcial | ❌ Obsoleto | ✅ Completos | Actualizar herencia |
| platform_marketing_content | ⚠️ Parcial | ❌ Obsoleto | ✅ Completos | Actualizar herencia |
Referencias Obsoletas a Eliminar/Actualizar
Los siguientes archivos referencian directivas del sistema antiguo:
16 archivos con referencias a:
- DIRECTIVA-FLUJO-5-FASES.md → Reemplazar por SIMCO-TAREA.md + CAPVED
- DIRECTIVA-VALIDACION-SUBAGENTES.md → Reemplazar por SIMCO-VALIDAR.md
- POLITICAS-USO-AGENTES.md → Reemplazar por SIMCO-DELEGACION.md
Archivos Específicos a Actualizar
| Archivo | Proyecto | Prioridad |
|---|---|---|
HERENCIA-DIRECTIVAS.md |
erp-suite | ALTA |
HERENCIA-DIRECTIVAS.md |
erp-core | ALTA |
HERENCIA-DIRECTIVAS.md |
construccion | ALTA |
HERENCIA-DIRECTIVAS.md |
vidrio-templado | MEDIA |
HERENCIA-DIRECTIVAS.md |
mecanicas-diesel | MEDIA |
HERENCIA-DIRECTIVAS.md |
retail | MEDIA |
HERENCIA-DIRECTIVAS.md |
clinicas | MEDIA |
HERENCIA-DIRECTIVAS.md |
gamilit | MEDIA |
HERENCIA-DIRECTIVAS.md |
trading-platform | MEDIA |
HERENCIA-DIRECTIVAS.md |
inmobiliaria-analytics | BAJA |
HERENCIA-DIRECTIVAS.md |
betting-analytics | BAJA |
HERENCIA-DIRECTIVAS.md |
platform_marketing_content | BAJA |
Plan de Propagación
FASE 1: Crear Template de Herencia SIMCO (INMEDIATO)
Crear archivo HERENCIA-SIMCO.md en core/orchestration/templates/ que los proyectos heredarán.
Contenido del template:
nivel: "{STANDALONE|SUITE|SUITE_CORE|VERTICAL}"
hereda_de:
- core/orchestration/directivas/simco/ # OBLIGATORIO
- core/orchestration/directivas/principios/ # OBLIGATORIO
- core/orchestration/patrones/ # RECOMENDADO
- core/orchestration/impactos/ # SEGÚN NECESIDAD
simco_version: "2.2.0"
capved_enabled: true
cca_protocol: true
FASE 2: Actualizar Proyectos de Alta Prioridad
Orden de actualización:
- erp-suite (Nivel 1) - Base para verticales
- erp-core (Nivel 2) - Core compartido
- construccion (Nivel 3) - Vertical más avanzada
- gamilit (Standalone) - Proyecto activo
Por cada proyecto:
- Actualizar
HERENCIA-DIRECTIVAS.mdcon mapeo SIMCO - Crear/actualizar
CONTEXTO-PROYECTO.mdcon variables CCA - Verificar que
ALIASES.ymldel proyecto referencie core
FASE 3: Actualizar Proyectos de Media Prioridad
- vidrio-templado
- mecanicas-diesel
- retail
- clinicas
- trading-platform
FASE 4: Actualizar Proyectos de Baja Prioridad
- inmobiliaria-analytics
- betting-analytics
- platform_marketing_content
FASE 5: Configurar Productos Nuevos
- erp-basico
- pos-micro
Mapeo de Directivas: Antiguo → Nuevo
| Sistema Antiguo | Sistema SIMCO | Alias |
|---|---|---|
DIRECTIVA-FLUJO-5-FASES.md |
SIMCO-TAREA.md + PRINCIPIO-CAPVED.md |
@TAREA, @CAPVED |
DIRECTIVA-VALIDACION-SUBAGENTES.md |
SIMCO-VALIDAR.md |
@VALIDAR |
POLITICAS-USO-AGENTES.md |
SIMCO-DELEGACION.md |
@DELEGAR |
DIRECTIVA-DOCUMENTACION-OBLIGATORIA.md |
SIMCO-DOCUMENTAR.md |
@DOCUMENTAR |
DIRECTIVA-CALIDAD-CODIGO.md |
PATRON-VALIDACION.md + ANTIPATRONES.md |
@PATRONES |
DIRECTIVA-DISENO-BASE-DATOS.md |
SIMCO-DDL.md |
@OP_DDL |
ESTANDARES-API-REST-GENERICO.md |
SIMCO-BACKEND.md |
@OP_BACKEND |
DIRECTIVA-CONTROL-VERSIONES.md |
(sin cambio, mantener) | - |
Template: HERENCIA-SIMCO.md para Proyectos
# Herencia SIMCO - {NOMBRE_PROYECTO}
## Configuración
| Propiedad | Valor |
|-----------|-------|
| **Nivel** | {STANDALONE/SUITE/SUITE_CORE/VERTICAL} |
| **SIMCO Version** | 2.2.0 |
| **CAPVED** | Habilitado |
| **CCA Protocol** | Habilitado |
## Directivas Heredadas (OBLIGATORIAS)
Ubicación: `core/orchestration/`
### Ciclo de Vida (usar SIEMPRE)
| Alias | Ruta | Uso |
|-------|------|-----|
| @TAREA | `directivas/simco/SIMCO-TAREA.md` | Punto de entrada para toda HU |
| @CAPVED | `directivas/principios/PRINCIPIO-CAPVED.md` | Ciclo de 6 fases |
| @INICIALIZACION | `directivas/simco/SIMCO-INICIALIZACION.md` | Bootstrap de agentes |
### Operaciones Universales
| Alias | Ruta | Uso |
|-------|------|-----|
| @CREAR | `directivas/simco/SIMCO-CREAR.md` | Crear archivos |
| @MODIFICAR | `directivas/simco/SIMCO-MODIFICAR.md` | Modificar archivos |
| @VALIDAR | `directivas/simco/SIMCO-VALIDAR.md` | Validar código |
| @DOCUMENTAR | `directivas/simco/SIMCO-DOCUMENTAR.md` | Documentar trabajo |
| @BUSCAR | `directivas/simco/SIMCO-BUSCAR.md` | Buscar información |
| @DELEGAR | `directivas/simco/SIMCO-DELEGACION.md` | Delegar a subagentes |
### Por Dominio (según proyecto)
| Alias | Ruta | Aplica a |
|-------|------|----------|
| @OP_DDL | `directivas/simco/SIMCO-DDL.md` | Proyectos con PostgreSQL |
| @OP_BACKEND | `directivas/simco/SIMCO-BACKEND.md` | Proyectos con NestJS/Express |
| @OP_FRONTEND | `directivas/simco/SIMCO-FRONTEND.md` | Proyectos con React |
| @OP_MOBILE | `directivas/simco/SIMCO-MOBILE.md` | Proyectos con React Native |
| @OP_ML | `directivas/simco/SIMCO-ML.md` | Proyectos con ML/AI |
### Principios (OBLIGATORIOS)
- `PRINCIPIO-DOC-PRIMERO.md`
- `PRINCIPIO-ANTI-DUPLICACION.md`
- `PRINCIPIO-VALIDACION-OBLIGATORIA.md`
- `PRINCIPIO-ECONOMIA-TOKENS.md`
## Patrones Heredados (RECOMENDADOS)
| Patrón | Cuándo Usar |
|--------|-------------|
| `PATRON-VALIDACION.md` | Toda validación de inputs |
| `PATRON-EXCEPTION-HANDLING.md` | Manejo de errores |
| `PATRON-TESTING.md` | Escribir tests |
| `PATRON-LOGGING.md` | Configurar logs |
| `PATRON-SEGURIDAD.md` | Implementar auth/seguridad |
## Extensiones Específicas del Proyecto
*(Agregar directivas específicas que EXTIENDEN las de core)*
| Directiva Local | Extiende | Propósito |
|-----------------|----------|-----------|
| `./directivas/...` | `@OP_DDL` | Schemas específicos |
---
**Regla de Oro:** Las directivas locales pueden EXTENDER las de core, nunca REDUCIRLAS.
Estimación de Esfuerzo
| Fase | Proyectos | Archivos | Complejidad |
|---|---|---|---|
| 1 | 1 template | 1 | Baja |
| 2 | 4 proyectos | ~16 | Media |
| 3 | 5 proyectos | ~20 | Media |
| 4 | 3 proyectos | ~12 | Baja |
| 5 | 2 proyectos | ~8 | Baja |
| TOTAL | 15 proyectos | ~57 archivos | - |
Siguiente Paso Recomendado
- Aprobar este plan de propagación
- Ejecutar Fase 1: Crear template
HERENCIA-SIMCO.mden core - Ejecutar Fase 2: Comenzar con erp-suite (proyecto padre)
Autor: Sistema SIMCO v2.2.0 Fecha: 2025-12-08