# FASE 6: PLAN REFINADO DE EJECUCION

**Proyecto:** template-saas
**Fecha:** 2026-01-10
**Estado:** COMPLETADO
**Perfil:** PERFIL-ORQUESTADOR
**Referencia:** FASE-5-ANALISIS-DEPENDENCIAS-2026-01-10.md

---

## 1. RESUMEN EJECUTIVO

Este documento consolida el plan final de ejecucion, incorporando:
- Validaciones de FASE 4 (100% P0, 88% total)
- Analisis de dependencias de FASE 5 (orden optimizado)
- Refinamientos basados en hallazgos

---

## 2. PLAN REFINADO DE EJECUCION

### 2.1 Estructura Final

```
EJECUCION
│
├── WAVE 1: Paralelo (25 archivos)
│   ├── Bloque 1: Integraciones INT (7 archivos)
│   ├── Bloque 2: ADRs (5 archivos)
│   └── Bloque 5: Modulos SAAS (13 archivos)
│
├── CHECKPOINT 1: Validacion links cruzados
│
├── WAVE 2: Secuencial (1 archivo)
│   └── Bloque 3: SAAS-013 Email
│
├── WAVE 3: Ordenado (4 archivos)
│   └── Bloque 4: Inventarios YAML
│       ├── 4.1 MASTER_INVENTORY.yml
│       ├── 4.2 DATABASE_INVENTORY.yml
│       ├── 4.3 BACKEND_INVENTORY.yml
│       └── 4.4 FRONTEND_INVENTORY.yml
│
├── WAVE 4: Archivos Nuevos (5 archivos)
│   ├── docs/README.md
│   ├── orchestration/README.md
│   ├── docs/02-integraciones/_MAP.md
│   ├── docs/02-especificaciones/_MAP.md
│   └── docs/02-devops/_MAP.md
│
└── CHECKPOINT FINAL: Validacion completa
```

---

## 3. DETALLE WAVE 1: PARALELO

### 3.1 Bloque 1: Integraciones INT

**Objetivo:** Elevar cumplimiento de 19% a 90%

| # | Archivo | Cambios Especificos |
|---|---------|---------------------|
| 1.1 | INT-001-stripe.md | +Metadata, +Endpoints Stripe, +Rate limits (100/s), +Errores 4xx/5xx, +Multi-tenant (por tenant), +Testing sandbox, +Monitoreo |
| 1.2 | INT-002-oauth.md | +Metadata, +Endpoints OAuth, +Rate limits Google/GitHub, +Errores, +Multi-tenant, +Testing |
| 1.3 | INT-003-email.md | +Metadata, +Rate limits SendGrid, +Errores, +Multi-tenant, +Testing sandbox |
| 1.4 | INT-004-push.md | +Metadata, +Rate limits VAPID, +Errores, +Multi-tenant, +Testing |
| 1.5 | INT-005-storage.md | +Metadata, +Endpoints S3, +Rate limits, +Errores, +Multi-tenant (cuotas), +Testing |
| 1.6 | INT-006-webhooks.md | +Metadata, +Rate limits BullMQ, +Testing |
| 1.7 | INT-007-redis.md | +Metadata, +Rate limits, +Errores, +Multi-tenant, +Testing |

**Template a usar:** Ver SIMCO-INTEGRACIONES-EXTERNAS.md

### 3.2 Bloque 2: ADRs

**Objetivo:** Elevar cumplimiento de 60% a 95%

| # | Archivo | Cambios Especificos |
|---|---------|---------------------|
| 2.1 | ADR-001-multi-tenancy-rls.md | +Tabla Metadata formal, Estado→Accepted, +Footer |
| 2.2 | ADR-002-authentication-jwt-oauth.md | +Tabla Metadata formal, Estado→Accepted, +Footer |
| 2.3 | ADR-003-billing-stripe.md | +Tabla Metadata formal, Estado→Accepted, +Footer |
| 2.4 | ADR-004-notifications-realtime.md | +Tabla Metadata formal, Estado→Accepted, +Footer |
| 2.5 | ADR-005-feature-flags.md | +Tabla Metadata formal, Estado→Accepted, +Footer |

**Cambio comun:**

```markdown
## Metadata
| Campo | Valor |
|-------|-------|
| ID | ADR-{NNNN} |
| Estado | Accepted |
| Fecha | 2026-01-10 |
| Supersede | N/A |

[... contenido existente ...]

---

**Fecha decision:** 2026-01-10
**Autores:** Claude Code (Arquitectura)
```

### 3.3 Bloque 5: Modulos SAAS

**Objetivo:** Elevar cumplimiento de 88% a 95%

#### 5.1 Agregar Frontmatter YAML (13 archivos)

| Archivo | Frontmatter a agregar |
|---------|----------------------|
| SAAS-001-auth.md | id, title, type, status, priority, module, version, dates |
| SAAS-002-tenants.md | id, title, type, status, priority, module, version, dates |
| SAAS-003-users.md | id, title, type, status, priority, module, version, dates |
| SAAS-004-billing.md | id, title, type, status, priority, module, version, dates |
| SAAS-005-plans.md | id, title, type, status, priority, module, version, dates |
| SAAS-006-ai-integration.md | Solo actualizar dates |
| SAAS-007-notifications.md | id, title, type, status, priority, module, version, dates |
| SAAS-008-audit-logs.md | id, title, type, status, priority, module, version, dates |
| SAAS-009-feature-flags.md | id, title, type, status, priority, module, version, dates |
| SAAS-010-webhooks.md | id, title, type, status, priority, module, version, dates |
| SAAS-011-storage.md | id, title, type, status, priority, module, version, dates |
| SAAS-012-crud-base.md | id, title, type, status, priority, module, version, dates |
| SAAS-014-whatsapp.md | Solo verificar - ya completo |

#### 5.2 Actualizar Fechas (5 archivos)

| Archivo | Fecha Actual → Nueva |
|---------|---------------------|
| SAAS-005-plans.md | 2026-01-07 → 2026-01-10 |
| SAAS-008-audit-logs.md | 2026-01-07 → 2026-01-10 |
| SAAS-009-feature-flags.md | 2026-01-07 → 2026-01-10 |
| SAAS-010-webhooks.md | 2026-01-07 → 2026-01-10 |
| SAAS-011-storage.md | 2026-01-07 → 2026-01-10 |

#### 5.3 Marcar Criterios de Aceptacion (2 archivos)

| Archivo | Accion |
|---------|--------|
| SAAS-008-audit-logs.md | Marcar [x] todos los criterios |
| SAAS-009-feature-flags.md | Marcar [x] todos los criterios |

---

## 4. CHECKPOINT 1: VALIDACION LINKS

### Comandos de Validacion

```bash
# Verificar que INT referencia SAAS correctamente
for f in INT-00*.md; do
  echo "=== $f ==="
  grep -E '\[SAAS-' "$f" | head -3
done

# Verificar links relativos
find docs -name "*.md" -exec grep -l "](../" {} \; | head -10
```

### Criterios de Paso

- [ ] Todos los INT referencian su SAAS correspondiente
- [ ] No hay links rotos entre archivos modificados
- [ ] Nomenclatura de links es consistente

---

## 5. DETALLE WAVE 2: SAAS-013

### 5.1 Reestructuracion Completa

**Archivo:** SAAS-013-email.md

**Estructura objetivo:**

```markdown
---
id: "SAAS-013"
title: "Email Module"
type: "Module"
status: "Published"
priority: "P1"
module: "email"
version: "1.0.0"
created_date: "2026-01-07"
updated_date: "2026-01-10"
---

# SAAS-013: Email Module

## Metadata
| Campo | Valor |
|-------|-------|
| Codigo | SAAS-013 |
| Modulo | Email |
| Prioridad | P1 |
| Estado | Completado |
| Fase | 5 - Integraciones |

---

## Descripcion
{Parrafo descriptivo del modulo email}

## Objetivos
1. {Objetivo 1}
2. {Objetivo 2}

## Alcance

### Incluido
- {Feature 1}
- {Feature 2}

### Excluido
- {Feature excluida}

[... contenido existente reorganizado ...]

## Referencias
- [INT-003-email](../02-integraciones/INT-003-email.md)
- [SAAS-007-notifications](./SAAS-007-notifications.md)

---

**Ultima actualizacion:** 2026-01-10
**Version:** 1.0.0
**Autor:** Claude Code
```

---

## 6. DETALLE WAVE 3: INVENTARIOS

### 6.1 MASTER_INVENTORY.yml

**Cambios:**

1. Crear seccion `metadata:` al inicio
2. Mover campos raiz bajo metadata
3. Renombrar `progreso:` a `resumen:`
4. Agregar seccion `epicas:`

**Estructura objetivo:**

```yaml
---
# MASTER INVENTORY - Template SaaS
# Version: 4.0.0

metadata:
  proyecto: "template-saas"
  tipo: "MASTER"
  version: "4.0.0"
  updated: "2026-01-10"
  descripcion: "Template base para plataformas SaaS multi-tenant"

resumen:
  progreso_mvp: "100%"
  story_points_completados: 179
  story_points_totales: 179
  fase_actual: "Release Candidate"
  sprints_completados: 5

epicas:
  - codigo: "SAAS-CORE"
    nombre: "Core SaaS"
    fases: [1, 2]
    modulos: ["SAAS-001", "SAAS-002", "SAAS-003"]
    estado: "completado"
  - codigo: "SAAS-BILLING"
    nombre: "Billing"
    fases: [2]
    modulos: ["SAAS-004", "SAAS-005"]
    estado: "completado"
  # ... resto de epicas

# ... resto del contenido existente
```

### 6.2 DATABASE_INVENTORY.yml

**Cambios:**

1. Crear seccion `metadata:`
2. Llenar migraciones reales (consultar apps/database/migrations/)
3. Agregar `total_indices` a metricas

### 6.3 BACKEND_INVENTORY.yml

**Cambios:**

1. Crear seccion `metadata:`

### 6.4 FRONTEND_INVENTORY.yml

**Cambios:**

1. Crear seccion `metadata:`
2. Renombrar `metricas:` a `resumen:`

---

## 7. DETALLE WAVE 4: ARCHIVOS NUEVOS

### 7.1 docs/README.md

Contenido definido en FASE 3, seccion 3.1

### 7.2 orchestration/README.md

Contenido definido en FASE 3, seccion 3.2

### 7.3 _MAP.md para subdirectorios

**docs/02-integraciones/_MAP.md:**

```markdown
# _MAP: Integraciones Externas

**Carpeta:** docs/02-integraciones/
**Proposito:** Documentacion de integraciones con servicios externos
**Estado:** Actualizado
**Ultima actualizacion:** 2026-01-10

---

## Resumen

| Metrica | Valor |
|---------|-------|
| Total integraciones | 7 |
| Implementadas | 6 |
| Planificadas | 1 |

---

## Contenido

| Archivo | Tipo | Estado | Descripcion |
|---------|------|--------|-------------|
| [INT-001-stripe.md](./INT-001-stripe.md) | Pagos | Implementado | Stripe Billing |
| [INT-002-oauth.md](./INT-002-oauth.md) | Auth | Planificado | OAuth 2.0 providers |
| [INT-003-email.md](./INT-003-email.md) | Notificaciones | Implementado | Email multi-provider |
| [INT-004-push.md](./INT-004-push.md) | Notificaciones | Implementado | Web Push API |
| [INT-005-storage.md](./INT-005-storage.md) | Storage | Implementado | S3/R2/MinIO |
| [INT-006-webhooks.md](./INT-006-webhooks.md) | Webhooks | Implementado | BullMQ outbound |
| [INT-007-redis.md](./INT-007-redis.md) | Cache | Implementado | Redis + BullMQ |

---

**Mantenido por:** Orchestration Team
```

---

## 8. CHECKPOINT FINAL

### 8.1 Checklist de Validacion

#### Integraciones INT
- [ ] 7/7 tienen tabla metadata
- [ ] 7/7 tienen rate limits
- [ ] 7/7 tienen manejo de errores
- [ ] 7/7 tienen seccion multi-tenant
- [ ] 7/7 tienen testing
- [ ] 7/7 tienen monitoreo
- [ ] Links a SAAS funcionan

#### ADRs
- [ ] 5/5 tienen tabla metadata formal
- [ ] 5/5 tienen estado en ingles (Accepted)
- [ ] 5/5 tienen footer

#### SAAS-013
- [ ] Tiene frontmatter YAML
- [ ] Tiene tabla metadata
- [ ] Tiene secciones Descripcion, Objetivos, Alcance
- [ ] Tiene footer

#### Inventarios
- [ ] 4/4 tienen seccion metadata:
- [ ] MASTER tiene seccion epicas:
- [ ] DATABASE tiene migraciones reales
- [ ] Conteos son consistentes

#### Modulos SAAS
- [ ] 13/13 tienen frontmatter YAML
- [ ] 5/5 fechas actualizadas
- [ ] 2/2 criterios marcados

#### Archivos Nuevos
- [ ] docs/README.md existe
- [ ] orchestration/README.md existe
- [ ] 3/3 _MAP.md existen

### 8.2 Metricas Finales Esperadas

| Grupo | Antes | Despues | Delta |
|-------|-------|---------|-------|
| Integraciones INT | 19% | 90% | +71pp |
| ADRs | 60% | 95% | +35pp |
| SAAS-013 | 75% | 95% | +20pp |
| Inventarios | 70% | 90% | +20pp |
| Modulos SAAS | 88% | 95% | +7pp |
| **PROMEDIO** | **59%** | **93%** | **+34pp** |

---

## 9. SUBAGENTES PARA EJECUCION

### 9.1 Asignacion de Subagentes

| Wave | Subagente | Perfil | Archivos |
|------|-----------|--------|----------|
| Wave 1a | Agent-INT | DOCUMENTATION-EDITOR | 7 INT-*.md |
| Wave 1b | Agent-ADR | DOCUMENTATION-EDITOR | 5 ADR-*.md |
| Wave 1c | Agent-SAAS | DOCUMENTATION-EDITOR | 13 SAAS-*.md |
| Wave 2 | Agent-EMAIL | DOCUMENTATION-EDITOR | 1 SAAS-013 |
| Wave 3 | Agent-INV | DOCUMENTATION-EDITOR | 4 *_INVENTORY.yml |
| Wave 4 | Agent-NEW | DOCUMENTATION-EDITOR | 5 nuevos |

### 9.2 Instrucciones por Subagente

**Agent-INT:** Usar template SIMCO-INTEGRACIONES-EXTERNAS.md, completar todas las secciones.

**Agent-ADR:** Agregar tabla metadata, cambiar estado a Accepted, agregar footer.

**Agent-SAAS:** Agregar frontmatter YAML, actualizar fechas, marcar criterios.

**Agent-EMAIL:** Reestructurar completo siguiendo patron SAAS-014.

**Agent-INV:** Crear seccion metadata:, completar datos faltantes.

**Agent-NEW:** Crear archivos usando templates definidos.

---

## 10. CONCLUSION

El plan refinado divide la ejecucion en 4 waves con 1 checkpoint intermedio y 1 final. Se modificaran 30 archivos y se crearan 5 nuevos, elevando el cumplimiento SIMCO de 59% a 93%+.

---

**Creado:** 2026-01-10
**Autor:** Agente Orquestador
**Sistema:** SIMCO v3.7
**Siguiente Fase:** FASE 7 - Ejecucion del Plan