## 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>
247 lines
8.2 KiB
Markdown
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
|