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