workspace-v1/orchestration/procesos/PLAN-PROPAGACION-SIMCO-CAPVED.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

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
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 SIMCO
  • 00-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:

  1. erp-suite (Nivel 1) - Base para verticales
  2. erp-core (Nivel 2) - Core compartido
  3. construccion (Nivel 3) - Vertical más avanzada
  4. gamilit (Standalone) - Proyecto activo

Por cada proyecto:

  1. Actualizar HERENCIA-DIRECTIVAS.md con mapeo SIMCO
  2. Crear/actualizar CONTEXTO-PROYECTO.md con variables CCA
  3. Verificar que ALIASES.yml del 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

  1. Aprobar este plan de propagación
  2. Ejecutar Fase 1: Crear template HERENCIA-SIMCO.md en core
  3. Ejecutar Fase 2: Comenzar con erp-suite (proyecto padre)

Autor: Sistema SIMCO v2.2.0 Fecha: 2025-12-08