rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
develop
workspace-v1/orchestration/analisis/F2-ANALISIS-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

17 KiB
Raw Permalink Blame History

FASE 2: Análisis Detallado - Propagación SIMCO v3.8.0

Fecha: 2026-01-10 Objetivo: Analizar estructura específica de cada archivo para determinar cambios exactos Estado: EN PROGRESO

1. Resumen del Análisis

1.1 Archivos Analizados

# Proyecto Líneas Tiene v3.7 Secciones Únicas Complejidad
1 erp-suite 312 NO Schemas BD, Verticales/Herencia, Propagación ALTA
2 erp-construccion 280 NO Schemas BD, Módulos MAI-*, Docs crítica ALTA
3 trading-platform 287 NO ML Engine, Módulos, Propagación ALTA
4 erp-basico 116 NO Diferencias vs ERP Core MEDIA
5 pos-micro 130 NO Módulos POS, Características MEDIA
6 erp-clinicas 138 NO Módulos CLI-*, Seguridad HIPAA MEDIA
7 betting-analytics 125 NO Propagación BAJA
8 erp-mecanicas-diesel 122 NO Módulos MEC-* BAJA
9 erp-retail 122 NO Módulos RET-* BAJA
10 erp-vidrio-templado 121 NO Módulos VID-* BAJA
11 inmobiliaria-analytics 105 NO Mapeo directivas BAJA
12 platform_marketing_content 105 NO Mapeo directivas BAJA

2. Análisis Individual por Archivo

2.1 erp-suite (312 líneas) - SUITE Principal

Ruta: projects/erp-suite/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (líneas 1-5)
2. Configuración del Proyecto (8-17)
3. Jerarquía de Herencia (19-41)
4. Directivas Heredadas de CORE (44-94)
5. Directivas por Dominio Técnico (97-106)
6. Directivas de Niveles y Propagación (109-117)
7. Patrones Heredados (120-136)
8. Impactos y Dependencias (139-149)
9. Perfiles de Agentes (152-173)
10. Directivas Específicas (176-185)
11. Variables de Contexto CCA (188-208)
12. Mapeo Directivas Antiguas (212-223)
13. Flujo de Trabajo para Subagentes (226-256)
14. Schemas de BD (259-270)
15. Verticales y Herencia (273-285)
16. Propagación de Mejoras (288-307)
17. Footer (310-312)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 106 (Directivas por Dominio Técnico)

Notas especiales:

  • Es el proyecto PADRE de verticales y productos
  • Actualizar nota sobre propagación a hijos

2.2 erp-construccion (280 líneas) - Vertical ERP

Ruta: projects/erp-construccion/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-18)
3. Jerarquía de Herencia (20-35)
4. Directivas Heredadas de CORE (38-79)
5. Directivas por Dominio Técnico (82-91)
6. Patrones Heredados (94-107)
7. Directivas Heredadas de ERP Core (110-119)
8. Directivas Específicas de Construcción (122-132)
9. Variables de Contexto CCA (135-170)
10. Schemas de BD (173-185)
11. Módulos MAI-* (188-207)
12. Flujo de Trabajo (210-251)
13. Documentación Crítica (254-264)
14. Mapeo Directivas Antiguas (267-275)
15. Footer (278-280)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 91 (Directivas por Dominio Técnico)

Notas especiales:

  • Tiene 403+ archivos de documentación (crítico para @MANTENIMIENTO_DOCS)
  • Agregar nota sobre sincronización de 7 schemas

2.3 trading-platform (287 líneas) - Standalone Fintech

Ruta: projects/trading-platform/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-18)
3. Jerarquía de Herencia (20-27)
4. Directivas Heredadas de CORE (30-78)
5. Directivas por Dominio Técnico (81-91)
6. Patrones Heredados (94-108)
7. Variables de Contexto CCA (111-145)
8. Módulos del Sistema (148-159)
9. ML Engine (162-172)
10. Consideraciones Especiales (175-194)
11. Flujo de Trabajo (197-235)
12. Mapeo Directivas Antiguas (238-246)
13. Propagación de Mejoras (249-281)
14. Footer (284-287)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 108 (Patrones Heredados)

Notas especiales:

  • Tiene ML Engine (considerar inventarios especiales)
  • Datos financieros críticos para @SYNC_BD

2.4 erp-basico (116 líneas) - Producto Suite

Ruta: projects/erp-suite/apps/products/erp-basico/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-18)
3. Jerarquía de Herencia (20-31)
4. Directivas Heredadas de CORE (34-62)
5. Directivas por Dominio Técnico (65-74)
6. Patrones Heredados (77-81)
7. Variables de Contexto CCA (84-98)
8. Diferencias con ERP Core (101-111)
9. Footer (114-116)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 81 (Patrones Heredados)

Notas especiales:

  • Archivo más corto, estructura simplificada
  • NO hereda de erp-core (producto independiente)

2.5 pos-micro (130 líneas) - Producto Suite

Ruta: projects/erp-suite/apps/products/pos-micro/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-18)
3. Jerarquía de Herencia (20-32)
4. Directivas Heredadas de CORE (35-62)
5. Directivas por Dominio Técnico (65-74)
6. Patrones Heredados (77-85)
7. Variables de Contexto CCA (88-104)
8. Módulos de POS Micro (107-116)
9. Características Especiales (119-125)
10. Footer (128-130)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 85 (Patrones Heredados)

Notas especiales:

  • Offline-first (considerar sincronización especial)
  • Transacciones atómicas críticas

2.6 erp-clinicas (138 líneas) - Vertical ERP

Ruta: projects/erp-clinicas/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-19)
3. Jerarquía de Herencia (21-28)
4. Directivas Heredadas de CORE (31-59)
5. Directivas por Dominio Técnico (62-71)
6. Patrones Heredados (74-79)
7. Directivas Heredadas de ERP Core (82-88)
8. Variables de Contexto CCA (91-110)
9. Módulos Específicos de Clínicas (113-124)
10. Consideraciones de Seguridad (127-133)
11. Footer (136-138)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 79 (Patrones Heredados)

Notas especiales:

  • HIPAA-ready (crítico para datos sensibles)
  • Encriptación AES-256

2.7 betting-analytics (125 líneas) - Standalone

Ruta: projects/betting-analytics/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-17)
3. Jerarquía de Herencia (19-25)
4. Directivas Heredadas de CORE (28-56)
5. Directivas por Dominio Técnico (59-68)
6. Patrones Heredados (71-74)
7. Variables de Contexto CCA (77-89)
8. Mapeo Directivas Antiguas (92-100)
9. Propagación de Mejoras (103-120)
10. Footer (123-125)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 74 (Patrones Heredados)

2.8 erp-mecanicas-diesel (122 líneas) - Vertical ERP

Ruta: projects/erp-mecanicas-diesel/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-19)
3. Jerarquía de Herencia (21-28)
4. Directivas Heredadas de CORE (31-59)
5. Directivas por Dominio Técnico (62-71)
6. Patrones Heredados (74-77)
7. Directivas Heredadas de ERP Core (80-86)
8. Variables de Contexto CCA (89-104)
9. Módulos Específicos (107-117)
10. Footer (120-122)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 77 (Patrones Heredados)

2.9 erp-retail (122 líneas) - Vertical ERP

Ruta: projects/erp-retail/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-19)
3. Jerarquía de Herencia (21-28)
4. Directivas Heredadas de CORE (31-59)
5. Directivas por Dominio Técnico (62-71)
6. Patrones Heredados (74-77)
7. Directivas Heredadas de ERP Core (80-86)
8. Variables de Contexto CCA (89-104)
9. Módulos Específicos (107-117)
10. Footer (120-122)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 77 (Patrones Heredados)

2.10 erp-vidrio-templado (121 líneas) - Vertical ERP

Ruta: projects/erp-vidrio-templado/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-19)
3. Jerarquía de Herencia (21-28)
4. Directivas Heredadas de CORE (31-59)
5. Directivas por Dominio Técnico (62-71)
6. Patrones Heredados (74-77)
7. Directivas Heredadas de ERP Core (80-86)
8. Variables de Contexto CCA (89-104)
9. Módulos Específicos (107-116)
10. Footer (119-121)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 77 (Patrones Heredados)

2.11 inmobiliaria-analytics (105 líneas) - Standalone

Ruta: projects/inmobiliaria-analytics/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-17)
3. Jerarquía de Herencia (19-25)
4. Directivas Heredadas de CORE (28-56)
5. Directivas por Dominio Técnico (59-68)
6. Patrones Heredados (71-74)
7. Variables de Contexto CCA (77-89)
8. Mapeo Directivas Antiguas (92-100)
9. Footer (103-105)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 74 (Patrones Heredados)

2.12 platform_marketing_content (105 líneas) - Standalone

Ruta: projects/platform_marketing_content/orchestration/00-guidelines/HERENCIA-SIMCO.md

Estructura actual:

1. Header (1-5)
2. Configuración del Proyecto (8-17)
3. Jerarquía de Herencia (19-25)
4. Directivas Heredadas de CORE (28-56)
5. Directivas por Dominio Técnico (59-68)
6. Patrones Heredados (71-74)
7. Variables de Contexto CCA (77-89)
8. Mapeo Directivas Antiguas (92-100)
9. Footer (103-105)

Secciones FALTANTES:

  • ❌ Directivas de Documentación (SIMCO v3.7)
  • ❌ Directivas de Mantenimiento (SIMCO v3.8)

Ubicación de inserción: Después de línea 74 (Patrones Heredados)

3. Cambios Requeridos por Archivo

3.1 Cambios COMUNES (todos los archivos)

# Cambio Línea Afectada Tipo
C1 Header version 2.2.0 → 3.8.0 Línea 3 EDITAR
C2 Header agregar "+ Estándares Documentación + Mantenimiento Docs" Línea 3 EDITAR
C3 Fecha de archivo Línea 4 EDITAR
C4 Tabla config: SIMCO Version 2.2.0 → 3.8.0 Tabla config EDITAR
C5 Agregar sección v3.7 Después de Patrones INSERTAR
C6 Agregar sección v3.8 Después de v3.7 INSERTAR
C7 Footer version 2.2.0 → 3.8.0 Última línea EDITAR
C8 Footer fecha actualización Penúltima línea EDITAR

3.2 Cambios ESPECÍFICOS por proyecto

Proyecto Cambio Específico
erp-suite Agregar nota de propagación a verticales
erp-construccion Nota sobre 403+ docs y 7 schemas
trading-platform Nota sobre datos financieros críticos
pos-micro Nota sobre transacciones offline
erp-clinicas Nota sobre datos HIPAA

4. Secciones a Insertar (Contenido Estándar)

4.1 Sección v3.7 (Estandarización de Documentació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 |

---

4.2 Sección v3.8 (Mantenimiento de Documentación)

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

---

5. Análisis de Dependencias

5.1 Dependencias Internas (entre proyectos)

Proyecto Depende de Dependencias hacia
erp-suite - erp-core, erp-basico, pos-micro, verticales
erp-core erp-suite 5 verticales
erp-basico erp-suite -
pos-micro erp-suite -
erp-construccion erp-core, erp-suite -
erp-clinicas erp-core, erp-suite -
erp-mecanicas-diesel erp-core, erp-suite -
erp-retail erp-core, erp-suite -
erp-vidrio-templado erp-core, erp-suite -
trading-platform - -
betting-analytics - -
inmobiliaria-analytics - -
platform_marketing_content - -

5.2 Archivos que Podrían Referenciar HERENCIA-SIMCO.md

# Archivos a verificar por proyecto:
- orchestration/00-guidelines/CONTEXTO-PROYECTO.md
- orchestration/directivas/_INDEX.md
- docs/*/README.md

6. Métricas del Análisis

Métrica Valor
Total líneas analizadas 1,963
Proyectos sin sección v3.7 12 (100%)
Proyectos sin sección v3.8 12 (100%)
Cambios comunes por archivo 8
Cambios específicos totales 5
Total de operaciones de edición ~108

7. Conclusiones del Análisis Detallado

  1. Todos los archivos tienen la misma estructura base - Cambios predecibles
  2. Ninguno tiene secciones v3.7 ni v3.8 - Se deben agregar ambas
  3. La ubicación de inserción es consistente - Después de "Patrones Heredados"
  4. Los headers y footers son homogéneos - Ediciones simples
  5. Proyectos con dependencias - Actualizar erp-suite primero

8. Siguiente Paso

Fase 3: Crear plan detallado de ejecución con:

  1. Orden exacto de actualización
  2. Contenido específico por archivo
  3. Validaciones requeridas

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