# Estructura Objetivo de /orchestration/

**Fecha:** 2026-01-10
**Fase:** 4.2 - Diseno de Estructura Objetivo
**Estado:** COMPLETADO

---

## Estructura Actual vs Objetivo

### Estructura Actual
```
orchestration/
├── PROJECT-STATUS.md
├── PROXIMA-ACCION.md
├── CONTEXT-MAP.yml (desactualizado)
├── GUIA-ORQUESTACION-SUBAGENTES.md
├── 00-guidelines/
│   ├── CONTEXTO-PROYECTO.md (ref obsoleta a 97-adr)
│   └── HERENCIA-SIMCO.md
├── inventarios/
│   ├── MASTER_INVENTORY.yml (conteo erroneo)
│   ├── BACKEND_INVENTORY.yml
│   ├── DATABASE_INVENTORY.yml
│   └── FRONTEND_INVENTORY.yml
├── planes/
│   └── (vacio - archivos movidos)
├── trazas/ (5 archivos)
├── analisis/ (30+ archivos)
└── _archivo/ (11 archivos)
```

### Estructura Objetivo
```
orchestration/
├── _INDEX.md (NUEVO - indice maestro)
├── PROJECT-STATUS.md (ACTUALIZADO)
├── PROXIMA-ACCION.md (ACTUALIZADO)
├── CONTEXT-MAP.yml (ACTUALIZADO - numeracion correcta)
├── GUIA-ORQUESTACION-SUBAGENTES.md (ACTUALIZADO - ref adr)
├── 00-guidelines/
│   ├── CONTEXTO-PROYECTO.md (ACTUALIZADO - ref adr)
│   └── HERENCIA-SIMCO.md
├── inventarios/
│   ├── _INDEX.md (NUEVO)
│   ├── MASTER_INVENTORY.yml (ACTUALIZADO - 24 tablas)
│   ├── BACKEND_INVENTORY.yml
│   ├── DATABASE_INVENTORY.yml
│   └── FRONTEND_INVENTORY.yml
├── planes/
│   └── HISTORICO-SPRINTS.md (NUEVO - consolidado)
├── trazas/
│   ├── _INDEX.md (NUEVO)
│   └── [5 archivos existentes]
├── analisis/
│   ├── _INDEX.md (ACTUALIZADO)
│   └── [archivos activos de purga]
└── _archivo/
    ├── _INDEX.md (NUEVO)
    ├── planes/ (NUEVO - planes de sprint archivados)
    │   ├── PLAN-SPRINT-1-TESTS.md
    │   ├── PLAN-SPRINT-2-ONBOARDING.md
    │   ├── PLAN-SPRINT-3-E2E.md
    │   ├── PLAN-SPRINT-4-DOCS.md
    │   └── PLAN-SPRINT-5-WHATSAPP.md
    └── analisis/ (NUEVO - analisis previo archivado)
        ├── FASE-1-PLAN-ANALISIS-INTEGRACION-2026-01-10.md
        ├── FASE-2-ANALISIS-DETALLADO-INTEGRACION-2026-01-10.md
        ├── FASE-3-PLAN-CORRECCION-INTEGRACION-2026-01-10.md
        ├── FASE-4-VALIDACION-PLAN-VS-ANALISIS-2026-01-10.md
        ├── FASE-5-PLAN-REFINADO-EJECUCION-2026-01-10.md
        └── [otros archivos historicos]
```

---

## Cambios Requeridos

### Archivos a ACTUALIZAR

| Archivo | Cambios |
|---------|---------|
| CONTEXT-MAP.yml | Corregir numeracion SAAS-006 a SAAS-014 |
| PROJECT-STATUS.md | Verificar metricas actuales |
| PROXIMA-ACCION.md | Actualizar siguiente accion |
| GUIA-ORQUESTACION-SUBAGENTES.md | Corregir ref 97-adr -> architecture/adr |
| 00-guidelines/CONTEXTO-PROYECTO.md | Corregir ref 97-adr -> architecture/adr |
| inventarios/MASTER_INVENTORY.yml | Verificar 24 tablas, 32 enums |
| analisis/_INDEX.md | Corregir enlaces a planes/ -> _archivo/planes/ |

### Archivos a CREAR

| Archivo | Contenido |
|---------|-----------|
| _INDEX.md | Indice maestro de orchestration |
| inventarios/_INDEX.md | Descripcion de cada inventario |
| trazas/_INDEX.md | Lista de trazas con proposito |
| _archivo/_INDEX.md | Indice de archivos historicos |
| planes/HISTORICO-SPRINTS.md | Resumen consolidado de 5 sprints |

### Archivos a MOVER

| Origen | Destino |
|--------|---------|
| analisis/FASE-1-* | _archivo/analisis/ |
| analisis/FASE-2-* | _archivo/analisis/ |
| analisis/FASE-3-* | _archivo/analisis/ |
| analisis/FASE-4-* | _archivo/analisis/ |
| analisis/FASE-5-* | _archivo/analisis/ |
| analisis/CP-2-VALIDACION-FASE-1-2.md | _archivo/analisis/ |
| analisis/INVENTARIO-PURGA-2026-01-10.md | _archivo/analisis/ |

### Archivos a MANTENER en analisis/

| Archivo | Razon |
|---------|-------|
| ANALISIS-BF-*.md | Analisis de modulos vigente |
| MAPA-*.md | Mapas de FASE 3 |
| INVENTARIO-*.md | Inventarios de FASE 3 |
| MATRIZ-DEPENDENCIAS-MODULOS.md | Referencia activa |
| CP-3-VALIDACION-FASE-3.md | Ultimo checkpoint |
| FASE-7-VALIDACION-EJECUCION-2026-01-10.md | Validacion final referenciable |

---

## Contenido de Indices

### _INDEX.md (orchestration)

```markdown
# Orchestration - Template SaaS

## Estado del Proyecto
- [PROJECT-STATUS.md](./PROJECT-STATUS.md) - Estado actual
- [PROXIMA-ACCION.md](./PROXIMA-ACCION.md) - Siguiente paso

## Contexto
- [CONTEXT-MAP.yml](./CONTEXT-MAP.yml) - Mapa de contexto
- [GUIA-ORQUESTACION-SUBAGENTES.md](./GUIA-ORQUESTACION-SUBAGENTES.md)

## Directorios
- [00-guidelines/](./00-guidelines/) - Directrices del proyecto
- [inventarios/](./inventarios/) - Inventarios del sistema
- [planes/](./planes/) - Historico de sprints
- [trazas/](./trazas/) - Trazas de ejecucion
- [analisis/](./analisis/) - Analisis activo
- [_archivo/](./archivo/) - Documentos historicos
```

### planes/HISTORICO-SPRINTS.md

```markdown
# Historico de Sprints - Template SaaS

## Linea de Tiempo
| Sprint | Fecha | Objetivo | Story Points |
|--------|-------|----------|--------------|
| 1 | 2025-12 | Test Coverage | 21 |
| 2 | 2025-12 | Onboarding Wizard | 18 |
| 3 | 2026-01 | E2E Tests | 15 |
| 4 | 2026-01 | ADRs Documentation | 10 |
| 5 | 2026-01 | WhatsApp Integration | 23 |

## Sprint 1: Test Coverage
**Objetivo:** Incrementar cobertura de tests a 75%+
**Resultado:** 710 tests, 76.37% cobertura
**Tareas:** TST-001 a TST-004
[Detalle completo](./_archivo/planes/PLAN-SPRINT-1-TESTS.md)

## Sprint 2: Onboarding Wizard
**Objetivo:** Implementar flujo de onboarding
**Resultado:** 11 endpoints, 6 pasos
**Tareas:** ONB-001 a ONB-004
[Detalle completo](./_archivo/planes/PLAN-SPRINT-2-ONBOARDING.md)

## Sprint 3: E2E Tests
**Objetivo:** Tests end-to-end de flujos criticos
**Resultado:** 47 tests E2E, 5 flujos
**Tareas:** E2E-001 a E2E-004
[Detalle completo](./_archivo/planes/PLAN-SPRINT-3-E2E.md)

## Sprint 4: ADRs Documentation
**Objetivo:** Documentar decisiones arquitectonicas
**Resultado:** 5 ADRs, template estandarizado
[Detalle completo](./_archivo/planes/PLAN-SPRINT-4-DOCS.md)

## Sprint 5: WhatsApp Integration
**Objetivo:** Integrar WhatsApp Business API
**Resultado:** 8 endpoints, 2 tablas, 22 tests
**GAPs resueltos:** 9
**Tareas:** WA-001 a WA-005
[Detalle completo](./_archivo/planes/PLAN-SPRINT-5-WHATSAPP.md)
```

---

## Metricas Objetivo

| Metrica | Actual | Objetivo |
|---------|--------|----------|
| Archivos en analisis/ | 30+ | ~15 activos |
| Archivos en _archivo/ | 11 | ~25 (consolidado) |
| Enlaces rotos | 7 | 0 |
| Archivos huerfanos | 2 | 0 |
| Indices | 1 | 6 |

---

## Reduccion de Contenido

### Antes
```
orchestration/analisis/: 30+ archivos (~6,000 lineas)
orchestration/_archivo/: 11 archivos (~1,500 lineas)
orchestration/planes/: Vacio (enlaces rotos)
```

### Despues
```
orchestration/analisis/: ~15 archivos activos
orchestration/_archivo/: ~25 archivos historicos (organizados)
orchestration/planes/: 1 archivo consolidado (~400 lineas)
```

**Reduccion total:** ~5,000 lineas de redundancia eliminadas

---

**Entregable de:** FASE 4.2