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

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

---
```

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

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

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