# FASE 3: Plan Detallado - Propagación SIMCO v3.8.0

**Fecha:** 2026-01-10
**Objetivo:** Definir plan de ejecución detallado para actualizar los 12 proyectos
**Estado:** EN PROGRESO

---

## 1. Orden de Ejecución

Basado en jerarquía de herencia y dependencias:

| Orden | Proyecto | Categoría | Justificación |
|-------|----------|-----------|---------------|
| 1 | erp-suite | Suite | Padre de productos y referencia de verticales |
| 2 | erp-basico | Producto | Hijo directo de erp-suite |
| 3 | pos-micro | Producto | Hijo directo de erp-suite |
| 4 | erp-construccion | Vertical | Mayor complejidad (280 líneas) |
| 5 | erp-clinicas | Vertical | Requiere notas HIPAA |
| 6 | erp-mecanicas-diesel | Vertical | Estructura estándar |
| 7 | erp-retail | Vertical | Estructura estándar |
| 8 | erp-vidrio-templado | Vertical | Estructura estándar |
| 9 | trading-platform | Standalone | Mayor complejidad (287 líneas) |
| 10 | betting-analytics | Standalone | Estructura simple |
| 11 | inmobiliaria-analytics | Standalone | Estructura simple |
| 12 | platform_marketing_content | Standalone | Estructura simple |

---

## 2. Operaciones por Archivo

### 2.1 Operaciones Comunes (8 por archivo)

| # | Operación | Tipo | Descripción |
|---|-----------|------|-------------|
| O1 | Header sistema | EDITAR | `SIMCO v2.2.0` → `SIMCO v3.8.0 + ... + Mantenimiento Docs` |
| O2 | Header fecha | EDITAR | `2025-12-08` → `2026-01-10` |
| O3 | Tabla SIMCO Version | EDITAR | `2.2.0` → `3.8.0` |
| O4 | Insertar sección v3.7 | INSERTAR | Después de "Patrones Heredados" |
| O5 | Insertar sección v3.8 | INSERTAR | Después de sección v3.7 |
| O6 | Footer sistema | EDITAR | `SIMCO v2.2.0` → `SIMCO v3.8.0 + ...` |
| O7 | Footer fecha | EDITAR | Fecha actual |
| O8 | Notas específicas | INSERTAR | Según proyecto |

---

## 3. Contenido Específico por Proyecto

### 3.1 erp-suite

**Ruta:** `projects/erp-suite/orchestration/00-guidelines/HERENCIA-SIMCO.md`

**Header:**
```markdown
**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs
**Fecha:** 2026-01-10
```

**Tabla:**
```markdown
| **SIMCO Version** | 3.8.0 |
```

**Sección v3.7:** Contenido estándar

**Sección v3.8:** Contenido estándar + nota:
```markdown
**IMPORTANTE para Suite:** Estos estándares aplican a todos los productos y verticales.
```

**Footer:**
```markdown
**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs
**Nivel:** SUITE (1)
**Última actualización:** 2026-01-10
```

---

### 3.2 erp-basico

**Ruta:** `projects/erp-suite/apps/products/erp-basico/orchestration/00-guidelines/HERENCIA-SIMCO.md`

**Header:**
```markdown
**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs
**Fecha:** 2026-01-10
```

**Tabla:**
```markdown
| **SIMCO Version** | 3.8.0 |
```

**Sección v3.7:** Contenido estándar

**Sección v3.8:** Contenido estándar (sin notas especiales)

**Footer:**
```markdown
**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs
**Nivel:** PRODUCT (2)
**Última actualización:** 2026-01-10
```

---

### 3.3 pos-micro

**Ruta:** `projects/erp-suite/apps/products/pos-micro/orchestration/00-guidelines/HERENCIA-SIMCO.md`

**Header:** Estándar v3.8.0

**Sección v3.8:** Contenido estándar + nota:
```markdown
**Nota para POS:** Las transacciones de venta requieren `@SYNC_BD` inmediato.
```

**Footer:** Estándar PRODUCT (2)

---

### 3.4 erp-construccion

**Ruta:** `projects/erp-construccion/orchestration/00-guidelines/HERENCIA-SIMCO.md`

**Header:** Estándar v3.8.0

**Sección v3.8:** Contenido estándar + nota:
```markdown
**IMPORTANTE para Construcción:** Con 7 schemas y 403+ archivos de documentación, ejecutar `@CHK_MANTENIMIENTO` después de cada sprint.
```

**Footer:** Estándar VERTICAL (3)

---

### 3.5 erp-clinicas

**Ruta:** `projects/erp-clinicas/orchestration/00-guidelines/HERENCIA-SIMCO.md`

**Header:** Estándar v3.8.0

**Sección v3.8:** Contenido estándar + nota:
```markdown
**CRÍTICO para Clínicas:** Los datos de salud requieren auditoría completa. Usar `@CHK_MANTENIMIENTO` para validar encriptación de documentación sensible.
```

**Footer:** Estándar VERTICAL (3)

---

### 3.6 erp-mecanicas-diesel, erp-retail, erp-vidrio-templado

**Ruta:** Respectivas rutas de cada vertical

**Header:** Estándar v3.8.0

**Sección v3.7:** Contenido estándar

**Sección v3.8:** Contenido estándar (sin notas especiales)

**Footer:** Estándar VERTICAL (3)

---

### 3.7 trading-platform

**Ruta:** `projects/trading-platform/orchestration/00-guidelines/HERENCIA-SIMCO.md`

**Header:** Estándar v3.8.0

**Sección v3.8:** Contenido estándar + nota:
```markdown
**CRÍTICO para Trading:** Los datos financieros requieren sincronización estricta. Usar `@SYNC_BD` + `@CHK_SYNC_BD` en cada cambio de schema.
```

**Footer:** Estándar STANDALONE

---

### 3.8 betting-analytics, inmobiliaria-analytics, platform_marketing_content

**Ruta:** Respectivas rutas

**Header:** Estándar v3.8.0

**Sección v3.7:** Contenido estándar

**Sección v3.8:** Contenido estándar (sin notas especiales)

**Footer:** Estándar STANDALONE

---

## 4. Patrones de Edición

### 4.1 Patrón: Header

**Buscar:**
```markdown
**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol
**Fecha:** 2025-12-08
```

**Reemplazar con:**
```markdown
**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs
**Fecha:** 2026-01-10
```

### 4.2 Patrón: Tabla Configuración

**Buscar:**
```markdown
| **SIMCO Version** | 2.2.0 |
```

**Reemplazar con:**
```markdown
| **SIMCO Version** | 3.8.0 |
```

### 4.3 Patrón: Footer

**Buscar (variantes):**
```markdown
**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol
**Nivel:** {NIVEL}
**Última actualización:** {FECHA_ANTIGUA}
```

**Reemplazar con:**
```markdown
**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs
**Nivel:** {NIVEL}
**Última actualización:** 2026-01-10
```

---

## 5. Punto de Inserción

### 5.1 Identificación del Punto

Buscar en cada archivo la línea:
```markdown
## Patrones Heredados (OBLIGATORIOS)
```

O la variante:
```markdown
## Patrones Heredados
```

Insertar las secciones v3.7 y v3.8 **DESPUÉS** de esta sección y su contenido.

### 5.2 Ubicación Específica por Archivo

| Proyecto | Insertar después de línea |
|----------|--------------------------|
| erp-suite | 136 (después de tabla de patrones) |
| erp-construccion | 107 (después de tabla de patrones) |
| trading-platform | 108 (después de tabla de patrones) |
| erp-basico | 81 |
| pos-micro | 85 |
| erp-clinicas | 79 |
| betting-analytics | 74 |
| erp-mecanicas-diesel | 77 |
| erp-retail | 77 |
| erp-vidrio-templado | 77 |
| inmobiliaria-analytics | 74 |
| platform_marketing_content | 74 |

---

## 6. Contenido de Secciones a Insertar

### 6.1 Sección v3.7 (Estandarización)

```markdown

---

## Directivas de Documentación (SIMCO v3.7)

Ubicación: `workspace/orchestration/directivas/simco/`

**Directivas de estandarización de documentación:**

| Alias | Directiva | Propósito | Aplica |
|-------|-----------|-----------|--------|
| `@DOC_PROYECTO` | `SIMCO-DOCUMENTACION-PROYECTO.md` | Estructura base de documentación | **SÍ** |
| `@NOMENCLATURA` | `SIMCO-NOMENCLATURA.md` | Convenciones de nomenclatura | **SÍ** |
| `@ESTRUCTURA_DOCS` | `SIMCO-ESTRUCTURA-DOCS.md` | Estructura interna de documentos | **SÍ** |
| `@INVENTARIOS` | `SIMCO-INVENTARIOS.md` | Estándares de inventarios YAML | **SÍ** |
| `@TESTING` | `SIMCO-TESTING.md` | Cobertura y estándares de testing | **SÍ** |
| `@MIGRACIONES` | `SIMCO-MIGRACIONES-BD.md` | Migraciones y DDL | **SÍ** |
| `@INTEGRACIONES` | `SIMCO-INTEGRACIONES-EXTERNAS.md` | Documentación de integraciones | **SÍ** |

### Checklists Asociados

| Alias | Checklist | Items |
|-------|-----------|-------|
| `@CHK_DOCUMENTACION` | `CHECKLIST-DOCUMENTACION-PROYECTO.md` | 44 |
| `@CHK_INVENTARIOS` | `CHECKLIST-INVENTARIOS.md` | 63 |
| `@CHK_NOMENCLATURA` | `CHECKLIST-NOMENCLATURA.md` | 40 |

### Templates Disponibles

| Alias | Template | Uso |
|-------|----------|-----|
| `@TPL_INVENTARIO` | `TEMPLATE-INVENTARIO-PROYECTO.md` | Crear inventarios YAML |
| `@TPL_INTEGRACION` | `TEMPLATE-INTEGRACION-EXTERNA.md` | Documentar integraciones |
| `@TPL_MODULO_ESTANDAR` | `TEMPLATE-MODULO-ESTANDAR.md` | Documentar módulos |
```

### 6.2 Sección v3.8 (Mantenimiento)

```markdown

---

## Directivas de Mantenimiento de Documentación (SIMCO v3.8)

Ubicación: `workspace/orchestration/directivas/simco/`

**Directivas de mantenimiento, purga y sincronización:**

| Alias | Directiva | Propósito | Aplica |
|-------|-----------|-----------|--------|
| `@MANTENIMIENTO_DOCS` | `SIMCO-MANTENIMIENTO-DOCUMENTACION.md` | Ciclo de mantenimiento, purga y deprecación | **SÍ** |
| `@SYNC_BD` | `SIMCO-SINCRONIZACION-BD.md` | Sincronización BD ↔ Código ↔ Docs | **SÍ** |

### Checklists de Mantenimiento

| Alias | Checklist | Items |
|-------|-----------|-------|
| `@CHK_MANTENIMIENTO` | `CHECKLIST-MANTENIMIENTO-DOCS.md` | 80 |
| `@CHK_SYNC_BD` | `CHECKLIST-SINCRONIZACION-BD.md` | 70 |

### Templates y Perfiles

| Alias | Archivo | Uso |
|-------|---------|-----|
| `@TPL_DEPRECACION` | `TEMPLATE-DEPRECACION.md` | Marcar documentos como deprecados |
| `@PERFIL_DOC_MAINT` | `PERFIL-DOCUMENTATION-MAINTAINER.md` | Perfil especializado en mantenimiento |

### Cuándo Usar

| Evento | Acción |
|--------|--------|
| Tarea completada (código) | `@MANTENIMIENTO_DOCS` nivel básico |
| Cambio en DDL | `@SYNC_BD` + `@CHK_SYNC_BD` |
| Fin de sprint/fase | `@CHK_MANTENIMIENTO` completo |
| Deprecar documentos | `@TPL_DEPRECACION` |
```

---

## 7. Validaciones Post-Ejecución

### 7.1 Por cada archivo

| # | Validación | Método |
|---|------------|--------|
| V1 | Header contiene v3.8.0 | grep "SIMCO v3.8.0" |
| V2 | Tabla contiene v3.8.0 | grep "SIMCO Version.*3.8.0" |
| V3 | Sección v3.7 existe | grep "Directivas de Documentación (SIMCO v3.7)" |
| V4 | Sección v3.8 existe | grep "Directivas de Mantenimiento.*v3.8" |
| V5 | Footer contiene v3.8.0 | tail -5 | grep "v3.8.0" |
| V6 | Fecha actualizada | grep "2026-01-10" |
| V7 | Sin errores de sintaxis Markdown | markdownlint (si disponible) |

### 7.2 Validación global

```bash
# Verificar todos los archivos tienen v3.8.0
find /home/isem/workspace-v1/projects -name "HERENCIA-SIMCO.md" -path "*/orchestration/00-guidelines/*" -exec grep -l "SIMCO v3.8.0" {} \; | wc -l
# Debe retornar: 16 (4 ya actualizados + 12 nuevos)
```

---

## 8. Resumen del Plan

| Métrica | Valor |
|---------|-------|
| Archivos a modificar | 12 |
| Operaciones por archivo | ~8 |
| Total de operaciones | ~96 |
| Líneas a insertar por archivo | ~70 (v3.7 + v3.8) |
| Total líneas nuevas | ~840 |
| Grupos de ejecución | 4 |
| Validaciones por archivo | 7 |

---

## 9. Estimación de Ejecución

| Grupo | Proyectos | Operaciones |
|-------|-----------|-------------|
| G1 | erp-suite | 8 ops |
| G2 | erp-basico, pos-micro | 16 ops |
| G3 | 5 verticales | 40 ops |
| G4 | 4 standalone | 32 ops |
| **Total** | 12 | 96 ops |

---

## 10. Siguiente Paso

**Fase 4:** Validar este plan contra:
1. Requisitos originales
2. Dependencias identificadas
3. Estructura de cada archivo

---

**Estado:** COMPLETADO
**Fecha de finalización:** 2026-01-10