workspace-v1/orchestration/analisis/F5-REFINAMIENTO-PLAN-PROPAGACION-V38-2026-01-10.md

FASE 5: Refinamiento del Plan - Propagación SIMCO v3.8.0

Fecha: 2026-01-10 Objetivo: Optimizar el plan para ejecución eficiente Estado: EN PROGRESO

---

1. Optimizaciones Identificadas

1.1 Agrupación por Similitud

Los 12 archivos se pueden agrupar por estructura similar:

Grupo	Proyectos	Características	Operaciones Optimizadas
A	erp-suite, erp-construccion, trading-platform	Archivos grandes (280-312 líneas), con secciones específicas	3 archivos
B	erp-basico, pos-micro	Productos de suite, estructura compacta	2 archivos
C	erp-clinicas, erp-mecanicas-diesel, erp-retail, erp-vidrio-templado	Verticales ERP, estructura idéntica	4 archivos
D	betting-analytics, inmobiliaria-analytics, platform_marketing_content	Standalone simples, estructura idéntica	3 archivos

1.2 Patrones de Edición Estandarizados

Patrón 1: Header (3 ediciones por archivo)

1. Sistema: v2.2.0 → v3.8.0 + extensiones
2. Fecha: 2025-12-08 → 2026-01-10
3. Tabla SIMCO Version

Patrón 2: Inserción de secciones (1 operación por archivo)

Insertar contenido estándar v3.7 + v3.8 después de "Patrones Heredados"

Patrón 3: Footer (2 ediciones por archivo)

1. Sistema en footer
2. Fecha en footer

---

2. Plan Refinado de Ejecución

2.1 Secuencia Optimizada

Paso	Proyecto	Tipo	Notas Especiales
1	erp-suite	Suite	+ nota propagación
2	erp-basico	Producto	Sin notas
3	pos-micro	Producto	+ nota transacciones
4	erp-construccion	Vertical	+ nota 7 schemas
5	erp-clinicas	Vertical	+ nota HIPAA
6	erp-mecanicas-diesel	Vertical	Sin notas
7	erp-retail	Vertical	Sin notas
8	erp-vidrio-templado	Vertical	Sin notas
9	trading-platform	Standalone	+ nota datos financieros
10	betting-analytics	Standalone	Sin notas
11	inmobiliaria-analytics	Standalone	Sin notas
12	platform_marketing_content	Standalone	Sin notas

2.2 Operaciones por Archivo

Para cada archivo, ejecutar en orden:

1. EDITAR Header línea 3 (sistema + fecha)
2. EDITAR Tabla configuración (SIMCO Version)
3. IDENTIFICAR punto de inserción (después de Patrones Heredados)
4. INSERTAR sección v3.7
5. INSERTAR sección v3.8 (con nota específica si aplica)
6. EDITAR Footer (sistema + fecha)

---

3. Contenido Refinado a Insertar

3.1 Bloque Completo de Secciones (v3.7 + v3.8)

El siguiente contenido se insertará tal cual en todos los archivos (ajustando notas específicas):

---

## 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 |

---

## 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` |

3.2 Notas Específicas por Proyecto

Proyecto	Nota a agregar al final de sección v3.8
erp-suite	**IMPORTANTE para Suite:** Estos estándares aplican a todos los productos y verticales.
pos-micro	**Nota para POS:** Las transacciones de venta requieren @SYNC_BD inmediato.
erp-construccion	**IMPORTANTE para Construcción:** Con 7 schemas y 403+ archivos de documentación, ejecutar @CHK_MANTENIMIENTO después de cada sprint.
erp-clinicas	**CRÍTICO para Clínicas:** Los datos de salud requieren auditoría completa. Usar @CHK_MANTENIMIENTO para validar documentación sensible.
trading-platform	**CRÍTICO para Trading:** Los datos financieros requieren sincronización estricta. Usar @SYNC_BD+@CHK_SYNC_BD en cada cambio de schema.
Otros 7	Sin nota especial

---

4. Checklist de Validación Post-Ejecución

4.1 Validaciones por Archivo

Para cada archivo actualizado, verificar:

[ ] Header contiene "SIMCO v3.8.0"
[ ] Header contiene "+ Estándares Documentación + Mantenimiento Docs"
[ ] Header fecha es "2026-01-10"
[ ] Tabla tiene "SIMCO Version" = "3.8.0"
[ ] Sección "Directivas de Documentación (SIMCO v3.7)" existe
[ ] Sección "Directivas de Mantenimiento de Documentación (SIMCO v3.8)" existe
[ ] Footer contiene "SIMCO v3.8.0"
[ ] Footer fecha es "2026-01-10"
[ ] Nota específica presente (si aplica)

4.2 Validación Global

# Comando para verificar todos los archivos
find /home/isem/workspace-v1/projects -name "HERENCIA-SIMCO.md" \
  -path "*/orchestration/00-guidelines/*" \
  -exec grep -l "SIMCO v3.8.0" {} \; | wc -l

# Resultado esperado: 16 (4 ya actualizados + 12 nuevos)

---

5. Resumen del Plan Refinado

Métrica Original	Valor Refinado
Operaciones por archivo	6 (reducido de 8)
Total operaciones	72 (reducido de 96)
Grupos de ejecución	4 grupos por similitud
Líneas a insertar	~65 por archivo
Archivos con notas especiales	5 de 12

---

6. Autorización para Ejecución

6.1 Verificación Pre-Ejecución

• Análisis inicial completado (F1)
• Análisis detallado completado (F2)
• Plan detallado creado (F3)
• Plan validado contra requisitos (F4)
• Plan refinado y optimizado (F5)
• Contenido estándar definido
• Notas específicas identificadas
• Validaciones post-ejecución definidas

6.2 Riesgos Finales

Riesgo	Mitigación
Error de edición	Validación inmediata post-edición
Contenido duplicado	Verificar punto de inserción antes de insertar

---

7. Siguiente Paso

Fase 6: Ejecutar el plan refinado en orden:

1. erp-suite
2. erp-basico, pos-micro
3. 5 verticales
4. 4 standalone

---

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