workspace-v1/orchestration/analisis/F5-REFINAMIENTO-PLAN-PROPAGACION-V38-2026-01-10.md
rckrdmrd 3a8a459d91 [SIMCO-V38] feat: Implementar sistema SIMCO v3.8.0 completo
## Directivas SIMCO v3.7.0 - Estandarizacion de Documentacion (7)
- SIMCO-DOCUMENTACION-PROYECTO.md
- SIMCO-NOMENCLATURA.md
- SIMCO-ESTRUCTURA-DOCS.md
- SIMCO-INVENTARIOS.md
- SIMCO-TESTING.md
- SIMCO-MIGRACIONES-BD.md
- SIMCO-INTEGRACIONES-EXTERNAS.md

## Directivas SIMCO v3.8.0 - Mantenimiento de Documentacion (2)
- SIMCO-MANTENIMIENTO-DOCUMENTACION.md
- SIMCO-SINCRONIZACION-BD.md

## Templates (4)
- TEMPLATE-INVENTARIO-PROYECTO.md
- TEMPLATE-INTEGRACION-EXTERNA.md
- TEMPLATE-MODULO-ESTANDAR.md
- TEMPLATE-DEPRECACION.md

## Checklists (6)
- CHECKLIST-DOCUMENTACION-PROYECTO.md
- CHECKLIST-INVENTARIOS.md
- CHECKLIST-NOMENCLATURA.md
- CHECKLIST-MANTENIMIENTO-DOCS.md
- CHECKLIST-SINCRONIZACION-BD.md
- _MAP.md

## Perfil de Agente (1)
- PERFIL-DOCUMENTATION-MAINTAINER.md

## Indices
- INDICE-DIRECTIVAS-WORKSPACE.yml actualizado a v3.8.0

## Submodulos actualizados (14)
- gamilit, erp-core, michangarrito, template-saas
- erp-suite, erp-construccion, erp-clinicas
- erp-mecanicas-diesel, erp-retail, erp-vidrio-templado
- trading-platform, betting-analytics
- inmobiliaria-analytics, platform_marketing_content

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:55:15 -06:00

247 lines
8.2 KiB
Markdown

# 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):
```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 |
---
## 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
```bash
# 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
- [x] Análisis inicial completado (F1)
- [x] Análisis detallado completado (F2)
- [x] Plan detallado creado (F3)
- [x] Plan validado contra requisitos (F4)
- [x] Plan refinado y optimizado (F5)
- [x] Contenido estándar definido
- [x] Notas específicas identificadas
- [x] 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