workspace-v1/orchestration/analisis/F3-PLAN-DETALLADO-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

11 KiB

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.0SIMCO v3.8.0 + ... + Mantenimiento Docs
O2 Header fecha EDITAR 2025-12-082026-01-10
O3 Tabla SIMCO Version EDITAR 2.2.03.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.0SIMCO 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:

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

Tabla:

| **SIMCO Version** | 3.8.0 |

Sección v3.7: Contenido estándar

Sección v3.8: Contenido estándar + nota:

**IMPORTANTE para Suite:** Estos estándares aplican a todos los productos y verticales.

Footer:

**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:

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

Tabla:

| **SIMCO Version** | 3.8.0 |

Sección v3.7: Contenido estándar

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

Footer:

**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:

**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:

**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:

**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:

**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:

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

Reemplazar con:

**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:

| **SIMCO Version** | 2.2.0 |

Reemplazar con:

| **SIMCO Version** | 3.8.0 |

Buscar (variantes):

**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol
**Nivel:** {NIVEL}
**Última actualización:** {FECHA_ANTIGUA}

Reemplazar con:

**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:

## Patrones Heredados (OBLIGATORIOS)

O la variante:

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


---

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


---

## 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
V6 Fecha actualizada grep "2026-01-10"
V7 Sin errores de sintaxis Markdown markdownlint (si disponible)

7.2 Validación global

# 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