template-saas/orchestration/_archivo/analisis-previo/FASE-4-VALIDACION-PLAN-VS-ANALISIS-2026-01-10.md

FASE 4: Validacion del Plan contra Analisis + Dependencias

Fecha: 2026-01-10 Estado: COMPLETADO Objetivo: Verificar cobertura completa del plan y analizar dependencias

---

1. Matriz de Cobertura: Discrepancias vs Plan

1.1 Discrepancias Criticas (7/7 cubiertas)

ID Discrepancia	Descripcion	Plan Asociado	Estado
CRIT-001	Conteo tablas 39 vs 24	PLAN-CRIT-001	✅ CUBIERTO
CRIT-002	Enums subscription_status duplicados	PLAN-CRIT-002	✅ CUBIERTO
CRIT-003	SAAS-012 CRUD-Base no implementado	PLAN-CRIT-003	✅ CUBIERTO
CRIT-004	OAuth no implementado	PLAN-CRIT-004	✅ CUBIERTO
CRIT-005	MFA no implementado	PLAN-CRIT-005	✅ CUBIERTO
CRIT-006	4 modulos sin documentar	PLAN-CRIT-006	✅ CUBIERTO
CRIT-007	Estados incorrectos SAAS-008/009	PLAN-CRIT-007	✅ CUBIERTO

Cobertura Criticas: 100%

1.2 Discrepancias Altas (14/14 cubiertas)

ID Discrepancia	Descripcion	Plan Asociado	Estado
ALTO-001	payment_methods no documentada	PLAN-ALTO-001	✅ CUBIERTO
ALTO-002	Session management no implementado	PLAN-ALTO-002	✅ CUBIERTO
ALTO-003	Tenant settings endpoints	PLAN-ALTO-003	✅ CUBIERTO
ALTO-004	Notifications v2.0 sin actualizar	PLAN-ALTO-004	✅ CUBIERTO
ALTO-005	Invoice estructura incompleta	PLAN-ALTO-005	✅ CUBIERTO
ALTO-006	Audit export no implementado	PLAN-ALTO-006	✅ CUBIERTO
ALTO-007	AI campos adicionales	PLAN-ALTO-007	✅ CUBIERTO
ALTO-008 a ALTO-014	Endpoints adicionales	PLAN-ALTO-004 (agrupado)	✅ CUBIERTO

Cobertura Altas: 100%

1.3 Discrepancias Medias (19/19 cubiertas)

Categoria	Cantidad	Plan Asociado	Estado
Entity-DDL mismatches	5	MEDIO-001, MEDIO-002	✅ CUBIERTO
Nomenclatura inconsistente	4	MEDIO-003	✅ CUBIERTO
Modelo roles flexible	2	MEDIO-004	✅ CUBIERTO
Enums adicionales	3	MEDIO-005	✅ CUBIERTO
Otros	5	Correcciones menores	✅ CUBIERTO

Cobertura Medias: 100%

1.4 Discrepancias Bajas (17/17)

Las discrepancias bajas se corrigen automaticamente durante las correcciones de mayor nivel.

Cobertura Total: 57/57 = 100%

---

2. Analisis de Dependencias

2.1 Dependencias entre Correcciones

┌─────────────────────────────────────────────────────────────────┐
│                    ORDEN DE DEPENDENCIAS                         │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  PLAN-CRIT-007 ──────────┐                                      │
│  (Estados)               │                                      │
│                          ▼                                      │
│  PLAN-CRIT-001 ──► PLAN-CRIT-006 ──► PLAN-ALTO-004             │
│  (Conteos)        (Modulos infra)    (Notifications v2)         │
│                          │                                      │
│                          ▼                                      │
│  PLAN-CRIT-002 ──► PLAN-ALTO-001 ──► PLAN-ALTO-005             │
│  (Enums)          (payment_methods)  (Invoice)                  │
│                                                                  │
│  PLAN-CRIT-004 ◄──────────────────────────────────────────────┐ │
│  PLAN-CRIT-005 ◄── Mismos archivo SAAS-001-auth.md            │ │
│  PLAN-ALTO-002 ◄──────────────────────────────────────────────┘ │
│                                                                  │
│  PLAN-CRIT-003 ──► Independiente (SAAS-012)                     │
│                                                                  │
│  PLAN-ALTO-003 ──► Independiente (SAAS-002)                     │
│                                                                  │
│  PLAN-ALTO-006 ──► Depende de PLAN-CRIT-007 (mismo archivo)     │
│                                                                  │
│  PLAN-ALTO-007 ──► Independiente (SAAS-006)                     │
│                                                                  │
│  MEDIO-* ──────────► Dependen de correcciones CRIT/ALTO         │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

2.2 Grupos de Ejecucion Paralela

Grupo 1 (Pueden ejecutarse en paralelo):

• PLAN-CRIT-007 (SAAS-008, SAAS-009)
• PLAN-CRIT-003 (SAAS-012)
• PLAN-ALTO-003 (SAAS-002)
• PLAN-ALTO-007 (SAAS-006)

Grupo 2 (Dependen del Grupo 1):

• PLAN-CRIT-001 (inventarios)
• PLAN-CRIT-006 (inventarios, CONTEXT-MAP)

Grupo 3 (SAAS-001-auth.md):

• PLAN-CRIT-004, PLAN-CRIT-005, PLAN-ALTO-002 (ejecutar juntos)

Grupo 4 (SAAS-004-billing.md):

• PLAN-CRIT-002, PLAN-ALTO-001, PLAN-ALTO-005 (ejecutar juntos)

Grupo 5 (Notificaciones):

• PLAN-ALTO-004 (SAAS-007)

Grupo 6 (Final):

• MEDIO-* (correcciones menores restantes)

---

3. Validacion de Archivos Dependientes

3.1 Archivos con Multiples Modificaciones

Archivo	Correcciones	Riesgo Conflicto
SAAS-001-auth.md	CRIT-004, CRIT-005, ALTO-002, MEDIO-001, MEDIO-002	ALTO
SAAS-004-billing.md	CRIT-002, ALTO-001, ALTO-005, MEDIO-003	ALTO
MASTER_INVENTORY.yml	CRIT-001, CRIT-006	MEDIO
_MAP.md	CRIT-001, CRIT-006	BAJO

Estrategia de Mitigacion:

• Para SAAS-001-auth.md: Leer archivo completo, aplicar todas las correcciones en una sola operacion
• Para SAAS-004-billing.md: Leer archivo completo, aplicar todas las correcciones en una sola operacion
• Para inventarios: Actualizar secuencialmente

3.2 Referencias Cruzadas a Validar

Archivo Modificado	Referencias en Otros Archivos
SAAS-001-auth.md	SAAS-003-users.md (User entity), INT-002-oauth.md
SAAS-004-billing.md	SAAS-005-plans.md, INT-001-stripe.md
SAAS-007-notifications.md	SAAS-014-whatsapp.md, INT-004-push.md
MASTER_INVENTORY.yml	CONTEXT-MAP.yml, PROJECT-STATUS.md

3.3 Validacion de Consistencia Post-Cambio

Despues de modificar cada archivo, verificar:

1. SAAS-001-auth.md:

   • OAuth mencionado en Roadmap, no en Endpoints
   • MFA mencionado en Roadmap, no en Endpoints
   • Session management en Roadmap
   • Referencias en SAAS-003 actualizadas

2. SAAS-004-billing.md:

   • Ambos enums subscription_status documentados
   • payment_methods con tabla y endpoints
   • Invoice campos completos
   • Referencias en INT-001-stripe.md consistentes

3. SAAS-007-notifications.md:

   • Version 2.0 documentada
   • WebSocket gateway mencionado
   • Queue service documentado
   • Referencia a SAAS-014 para WhatsApp

4. Inventarios:

   • Conteo 24 tablas en todos los archivos
   • modulos_infraestructura agregado
   • CONTEXT-MAP actualizado

---

4. Riesgos Identificados

4.1 Riesgos de Ejecucion

Riesgo	Probabilidad	Impacto	Mitigacion
Conflicto al editar SAAS-001	Media	Alto	Agrupar todas las ediciones
Conflicto al editar SAAS-004	Media	Alto	Agrupar todas las ediciones
Inconsistencia referencias	Baja	Medio	Validacion cruzada post-ejecucion
Perdida de contenido	Baja	Alto	Leer archivo completo antes de editar

4.2 Riesgos de Omision

Riesgo	Detalle	Mitigacion
Discrepancia no cubierta	Posible hallazgo nuevo	Ejecutar grep de validacion
Referencia rota	Link a seccion eliminada	Buscar [#section] despues de editar
Estado inconsistente	Modulo dice Pendiente en un lugar, Completado en otro	Grep por estado en todos los archivos

---

5. Checklist de Validacion Pre-Ejecucion

5.1 Validacion de Alcance

• Todas las discrepancias criticas tienen plan asociado
• Todas las discrepancias altas tienen plan asociado
• Todas las discrepancias medias tienen plan asociado
• Discrepancias bajas se resuelven automaticamente
• No hay discrepancias huerfanas

5.2 Validacion de Dependencias

• Orden de ejecucion respeta dependencias
• Archivos con multiples cambios identificados
• Estrategia de agrupacion definida
• Referencias cruzadas mapeadas

5.3 Validacion de Factibilidad

• Todos los archivos a modificar existen
• Contenido nuevo claramente especificado
• Tiempo estimado razonable (4h 20min total)
• Sin cambios destructivos de codigo

---

6. Resumen de Validacion

Aspecto	Estado	Detalle
Cobertura de discrepancias	✅ COMPLETA	57/57 (100%)
Dependencias mapeadas	✅ COMPLETO	6 grupos identificados
Archivos validados	✅ COMPLETO	14 archivos impactados
Riesgos mitigados	✅ COMPLETO	6 riesgos con mitigacion
Pre-requisitos	✅ LISTO	Todos verificados

---

7. Recomendaciones para Fase 5 (Refinamiento)

1. Consolidar ediciones de SAAS-001-auth.md en un solo bloque de cambios
2. Consolidar ediciones de SAAS-004-billing.md en un solo bloque de cambios
3. Agregar paso de validacion grep despues de cada grupo de correcciones
4. Considerar backup de archivos antes de modificar (git status limpio)

---

8. Conclusion

El plan cubre 100% de las discrepancias identificadas en el analisis.

Las dependencias han sido mapeadas y se propone un orden de ejecucion que:

• Minimiza conflictos de edicion
• Respeta dependencias entre correcciones
• Permite validacion incremental

Estado: APROBADO para proceder a Fase 5 (Refinamiento)

---

Creado por: Claude Code Fecha: 2026-01-10