workspace-v1/orchestration/analisis/D0-PLAN-MAESTRO-RESOLUCION-DISCREPANCIAS-2026-01-10.md

D0: Plan Maestro - Resolución de 34 Discrepancias NEXUS

Fecha: 2026-01-10 Estado: EN EJECUCIÓN Metodología: Fases CAPVED Extendidas Objetivo: Resolver todas las discrepancias de coherencia código/tipos

---

Metodología por Discrepancia

Cada discrepancia seguirá las siguientes fases:

┌─────────────────────────────────────────────────────────────────┐
│ FASE 1: ANÁLISIS Y PLANEACIÓN INICIAL                          │
│   → Identificar alcance                                          │
│   → Mapear archivos involucrados                                │
│   → Detectar dependencias                                        │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│ FASE 2: ANÁLISIS DETALLADO                                      │
│   → Leer contenido completo de archivos                         │
│   → Documentar estado actual línea por línea                    │
│   → Identificar discrepancias específicas                       │
│   → Mapear impacto en código dependiente                        │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│ FASE 3: PLANEACIÓN DETALLADA                                    │
│   → Definir cambios específicos por archivo                     │
│   → Especificar old_string → new_string exactos                 │
│   → Ordenar cambios por dependencia                             │
│   → Estimar impacto y riesgos                                   │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│ FASE 4: VALIDACIÓN DE PLANEACIÓN                                │
│   → Verificar plan cubre todos los requisitos                   │
│   → Validar dependencias identificadas completamente            │
│   → Confirmar no hay conflictos con otros cambios              │
│   → Revisar contra análisis original                            │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│ FASE 5: REFINAMIENTO DEL PLAN                                   │
│   → Incorporar hallazgos de validación                          │
│   → Ajustar orden de ejecución si necesario                     │
│   → Finalizar lista de cambios                                  │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│ FASE 6: EJECUCIÓN DEL PLAN                                      │
│   → Aplicar cambios en orden definido                           │
│   → Documentar cada modificación                                │
│   → Capturar estado post-cambio                                 │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│ FASE 7: VALIDACIÓN DE EJECUCIÓN                                 │
│   → Comparar estado final vs esperado                           │
│   → Verificar integridad de archivos                            │
│   → Validar coherencia con dependencias                         │
│   → Confirmar resolución de discrepancia                        │
└─────────────────────────────────────────────────────────────────┘

---

Inventario de Discrepancias

Grupo P0 - BLOQUEADORES (4 issues)

ID	Descripción	Archivos Est.	Esfuerzo
P0-001	Enum difficulty_level desincronizado	3-5	1h
P0-002	Enum exercise_type desincronizado	3-5	1h
P0-003	Conflictos orden de rutas	2	30min
P0-004	Guards autenticación deshabilitados	2	15min

Grupo P1 - ALTOS (12 issues)

ID	Descripción	Archivos Est.	Esfuerzo
P1-001	UserStats interface ausente frontend	1-2	2h
P1-002	Module interface incompleta	1	1.5h
P1-003	Admin module tipos ausentes	2	3h
P1-004	ExerciseType mismatch frontend	2-3	1-2h
P1-005	Token refresh no implementado	1-2	2-3h
P1-006	Achievement interface incompleta	1	1h
P1-007	Classroom interface incompleta	1	1h
P1-008	ExerciseSubmission incompleta	1	45min
P1-009	Audit Logging module no implementado	32+	35-45h
P1-010	Missions module tipos faltantes	1	2h
P1-011	Notifications module tipos faltantes	1	2h
P1-012	Powerups module tipos faltantes	1	2h

Grupo P2 - MEDIOS (15 issues)

ID	Descripción	Archivos Est.	Esfuerzo
P2-001	System Configuration module	25+	22-28h
P2-002	Friendships sin rutas API	3-4	2h
P2-003	ML Coins transactions sin rutas	3-4	2h
P2-004	Audit logs sin rutas	2-3	1h
P2-005	Assessment rubrics sin rutas	2-3	1h
P2-006	Comodines inventory sin rutas	2-3	1h
P2-007	Learning sessions sin rutas	2-3	1h
P2-008	Endpoints con objetos inline	8	2h
P2-009	UUIDs sin ParseUUIDPipe	130 params	4h
P2-010	JSONB sin tipar	5-6 campos	4h
P2-011	Webhooks sin protección	2-3	2h
P2-012	Type mismatch comodines_used	2	30min
P2-013	Content module tipos	1	2h
P2-014	Social API client faltante	1	1h
P2-015	Date handling sin tipo explícito	Múltiples	2h

Grupo P3 - BAJOS (3 issues)

ID	Descripción	Archivos Est.	Esfuerzo
P3-001	Estandarizar naming conventions	Múltiples	4-6h
P3-002	Implementar validación Zod	Múltiples	3-5 días
P3-003	Shared types package	Nuevo pkg	1-2 sem

---

Orden de Ejecución

Sprint 1: P0 Bloqueadores (Prioridad Máxima)

Día 1:
  09:00 - P0-001: Enum difficulty_level (7 fases)
  11:00 - P0-002: Enum exercise_type (7 fases)
  14:00 - P0-003: Conflictos orden rutas (7 fases)
  15:00 - P0-004: Guards autenticación (7 fases)
  16:00 - Validación integral P0

Sprint 2: P1 Altos (Interfaces Críticas)

P1-001 → P1-002 → P1-003 → P1-004
   ↓
P1-005 → P1-006 → P1-007 → P1-008
   ↓
P1-010 → P1-011 → P1-012
   ↓
P1-009 (Sprint dedicado - Audit Logging)

Sprint 3-4: P2 Medios

Módulos: P2-001, P2-002, P2-003
Rutas: P2-004 → P2-007
Validación: P2-008, P2-009
Tipos: P2-010 → P2-015

Backlog: P3 Bajos

P3-001 → P3-002 → P3-003

---

Estructura de Documentos por Discrepancia

Para cada discrepancia Pn-XXX se generarán:

orchestration/analisis/discrepancias/
├── Pn-XXX/
│   ├── FASE-1-ANALISIS-INICIAL.md
│   ├── FASE-2-ANALISIS-DETALLADO.md
│   ├── FASE-3-PLAN-DETALLADO.md
│   ├── FASE-4-VALIDACION-PLAN.md
│   ├── FASE-5-PLAN-REFINADO.md
│   ├── FASE-6-EJECUCION.md
│   └── FASE-7-VALIDACION-FINAL.md

---

Métricas de Seguimiento

Por Discrepancia

• Fase 1 completada
• Fase 2 completada
• Fase 3 completada
• Fase 4 completada
• Fase 5 completada
• Fase 6 completada
• Fase 7 completada
• Validación final aprobada

Global

• Total discrepancias: 34
• P0 resueltas: 0/4
• P1 resueltas: 0/12
• P2 resueltas: 0/15
• P3 resueltas: 0/3

---

Inicio de Ejecución

Primera discrepancia: P0-001 (Enum difficulty_level) Fecha inicio: 2026-01-10 Estado: INICIANDO FASE 1

---

Creado por: Documentation-Architect Fecha: 2026-01-10