# 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
