template-saas/orchestration/analisis/ESTRUCTURA-OBJETIVO-ORCHESTRATION.md
rckrdmrd 50a821a415
Some checks failed
CI / Backend CI (push) Has been cancelled
CI / Frontend CI (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / CI Summary (push) Has been cancelled
[SIMCO-V38] feat: Actualizar a SIMCO v3.8.0
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8
- Actualizaciones de configuracion

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:53:08 -06:00

230 lines
7.0 KiB
Markdown

# 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