rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
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

330 lines
13 KiB
Markdown
Raw Permalink Blame History

# 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 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:**
```yaml
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
```markdown
# 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
Reference in New Issue View Git Blame Copy Permalink