## 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>
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.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:
**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 |
4.3 Patrón: Footer
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:
- Requisitos originales
- Dependencias identificadas
- Estructura de cada archivo
Estado: COMPLETADO Fecha de finalización: 2026-01-10