workspace-v1/orchestration/analisis/C1-BACKLOG-DISCREPANCIAS-NEXUS-2026-01-10.md

# C1: Backlog de Discrepancias NEXUS - Gamilit

**Fecha:** 2026-01-10
**Estado:** VALIDADO - MAYORÍA RESUELTOS
**Origen:** REPORTE-FINAL-VALIDACION-INTEGRAL-2025-11-04.md
**Validación:** D2-REPORTE-CONSOLIDADO-VALIDACION-DISCREPANCIAS-2026-01-10.md
**Objetivo:** Tracking estructurado para equipo de desarrollo

---

## Resumen Ejecutivo

| Prioridad | Issues | Resueltos | Pendientes | Estado |
|-----------|--------|-----------|------------|--------|
| **P0 - BLOQUEADORES** | 4 | 4 (100%) | 0 | ✅ CERRADO |
| **P1 - ALTOS** | 12 | 10 (~83%) | 2 | ⚠️ CASI COMPLETO |
| **P2 - MEDIOS** | 15 | ~5 (~33%) | ~10 | 🔴 EN PROGRESO |
| **P3 - BAJOS** | 3 | 0 (0%) | 3 | 📋 BACKLOG |
| **TOTAL** | **34** | **~19 (56%)** | **~15** | - |

---

## Estado de Coherencia Actualizado

```
                        Nov 2025    Ene 2026    Cambio
Database → Backend:     94.5%       98%+        +3.5%
Backend → Frontend:     28.2%       75%+        +47%  ✅ MEJORA SIGNIFICATIVA
Type Safety E2E:        62%         85%+        +23%
API Coverage (DB):      42%         ~55%        +13%
```

---

## P0 - BLOQUEADORES ✅ TODOS RESUELTOS

> **Validación completada:** 2026-01-10
> **Documento de validación:** D1-VALIDACION-P0-BLOQUEADORES-2026-01-10.md

### P0-001: Enum `difficulty_level` ✅ RESUELTO
- **Fecha resolución:** 2025-11-11
- **Validación:** 8 valores CEFR sincronizados en las 3 capas
- **Archivo:** `enums.constants.ts` - v2.0 CEFR

### P0-002: Enum `exercise_type` ✅ RESUELTO
- **Fecha resolución:** 2026-01-07
- **Validación:** 33 mecánicas sincronizadas en las 3 capas
- **Archivo:** `exercise_type.sql` - 33 valores

### P0-003: Conflictos orden rutas ✅ RESUELTO
- **Validación:** Rutas específicas ordenadas correctamente
- **Archivo:** `modules.controller.ts` - orden correcto verificado

### P0-004: Guards deshabilitados ✅ RESUELTO
- **Validación:** `@UseGuards(JwtAuthGuard)` habilitado a nivel de clase
- **Archivos:** `user-stats.controller.ts`, `achievements.controller.ts`

~~### P0-001: Enum `difficulty_level` Desincronizado~~
~~- **Severidad:** BLOQUEADOR~~
~~- **Esfuerzo:** 1 hora~~
~~- **Responsable:** NEXUS-DATABASE~~
~~- **Descripción:** Database tiene 3 valores, Backend/Frontend usan 8~~

### P0-002: Enum `exercise_type` Desincronizado
- **Severidad:** BLOQUEADOR
- **Esfuerzo:** 1 hora
- **Responsable:** NEXUS-DATABASE
- **Descripción:** Backend tiene 5 tipos no en DB, DB tiene 2 no en Backend
- **Backend extras:** `diario_multimedia`, `comic_digital`, `video_carta`, `verdadero_falso`, `completar_espacios`
- **DB extras:** `capsula_tiempo`, `collage_digital`
- **Impacto:** INSERT de ejercicios nuevos fallará
- **Solución:** Sincronizar agregando valores faltantes a DB enum

### P0-003: Conflictos de Orden de Rutas
- **Severidad:** BLOQUEADOR
- **Esfuerzo:** 30 min
- **Responsable:** NEXUS-BACKEND
- **Descripción:** Rutas específicas después de rutas genéricas `:id`
- **Archivos afectados:**
  - `modules.controller.ts`: `/modules/difficulty/:difficulty` debe ir antes de `/modules/:id`
  - `classrooms.controller.ts`: `/classrooms/code/:code` debe ir antes de `/classrooms/:id`
- **Impacto:** `:id` captura "difficulty" y "code" como UUIDs inválidos

### P0-004: Guards de Autenticación Deshabilitados
- **Severidad:** BLOQUEADOR (Seguridad)
- **Esfuerzo:** 15 min
- **Responsable:** NEXUS-BACKEND
- **Descripción:** `@UseGuards(JwtAuthGuard)` comentado
- **Archivos afectados:**
  - `user-stats.controller.ts`
  - `achievements.controller.ts`
- **Impacto:** Endpoints accesibles sin autenticación
- **Solución:** Descomentar decorator `@UseGuards(JwtAuthGuard)`

---

## P1 - ALTOS (Siguientes 2-3 Sprints)

### P1-001: UserStats Interface Ausente en Frontend
- **Severidad:** ALTA
- **Esfuerzo:** 2 horas
- **Responsable:** NEXUS-FRONTEND
- **Descripción:** Backend tiene 40 propiedades, Frontend solo 6 básicas (85% faltante)
- **Propiedades críticas faltantes:**
  - ML Coins: `ml_coins`, `ml_coins_earned_total`, `ml_coins_spent_total`
  - Streaks: `current_streak`, `max_streak`, `streak_started_at`
  - Progress: `exercises_completed`, `modules_completed`, `achievements_earned`
  - Rankings: `global_rank_position`, `class_rank_position`
- **Archivo a crear:** `/shared/types/gamification.types.ts`
- **Impacto:** Gamification features rotas/incompletas

### P1-002: Module Interface Incompleta (31% coverage)
- **Severidad:** ALTA
- **Esfuerzo:** 1.5 horas
- **Responsable:** NEXUS-FRONTEND
- **Descripción:** Frontend 14 propiedades, Backend 45
- **Propiedades faltantes:**
  - Gamification: `xp_reward`, `ml_coins_reward`
  - Academic: `grade_levels`, `subjects`, `competencies`
  - Maya Rank: `maya_rank_required`, `maya_rank_granted`
  - Versioning: `version`, `version_notes`, `reviewed_by`
- **Impacto:** Módulos sin metadata ni rewards

### P1-003: Admin Module Tipos Ausentes (0% coverage)
- **Severidad:** ALTA
- **Esfuerzo:** 3 horas
- **Responsable:** NEXUS-FRONTEND
- **Descripción:** 24 DTOs en Backend, 0 en Frontend
- **DTOs faltantes:** Organizations, Users Management, System Config, Audit Logs, System Health, Metrics, Content Moderation
- **Archivos a crear:**
  - `/shared/types/admin.types.ts`
  - `/lib/api/admin.api.ts`
- **Impacto:** Panel administrativo no implementable

### P1-004: ExerciseType Mismatch Frontend
- **Severidad:** ALTA
- **Esfuerzo:** 1-2 horas
- **Responsable:** NEXUS-FRONTEND
- **Descripción:** Frontend define 6 tipos, Backend/DB tienen 27+
- **Frontend actual:** `multiple_choice`, `code_completion`, `true_false`, `fill_in_blank`
- **Backend:** `crucigrama`, `detective_textual`, `quiz_tiktok`, etc.
- **Impacto:** Frontend NO PUEDE RENDERIZAR 21+ tipos de ejercicio
- **Solución:** Actualizar enum y componentes de renderizado

### P1-005: Token Refresh No Implementado
- **Severidad:** ALTA
- **Esfuerzo:** 2-3 horas
- **Responsable:** NEXUS-BACKEND
- **Descripción:** `POST /auth/refresh` existe pero lanza "Not implemented yet"
- **Impacto:** Usuarios deben re-login al expirar token
- **Archivo:** `auth.controller.ts`
- **Solución:** Implementar usando SessionManagementService

### P1-006: Achievement Interface Incompleta
- **Severidad:** ALTA
- **Esfuerzo:** 1 hora
- **Responsable:** NEXUS-FRONTEND
- **Descripción:** 13 propiedades faltantes
- **Naming mismatch:** `is_secret` (backend) → `isHidden` (frontend)
- **Falta:** `ml_coins_reward`, `difficulty_level`, `unlock_message`

### P1-007: Classroom Interface Incompleta (36% coverage)
- **Severidad:** ALTA
- **Esfuerzo:** 1 hora
- **Responsable:** NEXUS-FRONTEND
- **Descripción:** 16 propiedades faltantes (64%)
- **Falta:** `grade_level`, `section`, `subject`, `schedule`, `meeting_url`

### P1-008: ExerciseSubmission Incompleta (47% coverage)
- **Severidad:** ALTA
- **Esfuerzo:** 45 min
- **Responsable:** NEXUS-FRONTEND
- **Descripción:** 10 propiedades faltantes
- **Falta:** `comodines_used`, `hint_used`, `ml_coins_spent`, `time_spent_seconds`
- **Extra innecesario en Frontend:** `attempt_id`

### P1-009: Audit Logging Module No Implementado
- **Severidad:** ALTA (Compliance)
- **Esfuerzo:** 35-45 horas
- **Responsable:** NEXUS-BACKEND
- **Descripción:** 5 tablas DB sin módulo backend
- **Tablas:** `audit_logs`, `performance_metrics`, `system_alerts`, `system_logs`, `user_activity`
- **Plan detallado:** Ver `AUDIT_LOGGING_*.md`

### P1-010 a P1-012: Módulos Sin Cobertura Frontend
- **Módulos afectados:** Missions (3 DTOs), Notifications (4 DTOs), Powerups (4 DTOs), Content (6 DTOs)
- **Esfuerzo total:** ~9 horas
- **Responsable:** NEXUS-FRONTEND

---

## P2 - MEDIOS (Sprints 4-6)

### P2-001: System Configuration Module No Implementado
- **Severidad:** MEDIA
- **Esfuerzo:** 22-28 horas
- **Responsable:** NEXUS-BACKEND
- **Descripción:** 2 tablas DB sin módulo backend
- **Tablas:** `system_settings`, `feature_flags`
- **Impacto:** Configuraciones hardcodeadas, sin feature flags
- **Plan detallado:** Ver `IMPLEMENTATION_PLAN_system_configuration.json`

### P2-002 a P2-010: Tablas Sin Rutas API (25/43 = 58%)
- **Alta Prioridad:**
  - `social_features.friendships` - Sistema social completo
  - `gamification_system.ml_coins_transactions` - Historial
- **Media Prioridad:**
  - `audit_logging.audit_logs`
  - `educational_content.assessment_rubrics`
  - `gamification_system.comodines_inventory`
  - `progress_tracking.learning_sessions`
- **Esfuerzo estimado:** 8-12 horas

### P2-011: Endpoints con Objetos Inline (sin DTOs)
- **Severidad:** MEDIA
- **Descripción:** 8 endpoints usando objetos inline
- **Impacto:** Sin validación de tipos, documentación incompleta

### P2-012: UUIDs Sin Validación
- **Severidad:** MEDIA
- **Descripción:** 130 parámetros UUID sin `ParseUUIDPipe` (92%)
- **Impacto:** Errores 500 en lugar de 400 con UUIDs inválidos

### P2-013: JSONB Sin Tipar
- **Severidad:** MEDIA
- **Descripción:** Todos los campos JSONB son `Record<string, any>`
- **Campos críticos:**
  - `exercise.config` - 27+ estructuras diferentes
  - `exercise.content`, `exercise.solution`
  - `submission.answer_data`
  - `user_stats.metadata`
- **Solución:** Discriminated unions por exercise_type

### P2-014: Webhooks Sin Protección
- **Severidad:** MEDIA (Seguridad)
- **Descripción:** Sin IP whitelist ni API key
- **Responsable:** NEXUS-BACKEND

### P2-015: Type Mismatch `comodines_used`
- **Severidad:** MEDIA
- **Descripción:** `jsonb` (DB) vs `string[]` (Backend)
- **Solución:** Cambiar Backend a `Record<string, any>` o definir interface

---

## P3 - BAJOS (Backlog)

### P3-001: Estandarizar Naming Conventions
- **Esfuerzo:** 4-6 horas
- **Descripción:** Mix de `snake_case` y `camelCase`
- **Ejemplos:**
  - `accessToken` (backend) vs `access_token` (frontend)
  - `answer_data` (backend) vs `submission_data` (frontend)

### P3-002: Implementar Validación Runtime (Zod)
- **Esfuerzo:** 3-5 días
- **Descripción:** Validación de schemas en tiempo de ejecución

### P3-003: Shared Types Package
- **Esfuerzo:** 1-2 semanas
- **Descripción:** Paquete compartido `packages/shared-types/`

---

## Métricas Objetivo

### Post P0+P1 (Sprint 3)
```
Database → Backend:     100%  (+5.5%)
Backend → Frontend:     75%   (+47%)
Type Safety E2E:        88%   (+26%)
API Coverage (DB):      60%   (+18%)
```

### Post P2 (Sprint 6)
```
Database → Backend:     100%
Backend → Frontend:     92%
Type Safety E2E:        95%
API Coverage (DB):      75%
```

---

## Roadmap Sugerido

### Sprint Inmediato (Semana 1-2)
- [ ] P0-001: Sync enum `difficulty_level`
- [ ] P0-002: Sync enum `exercise_type`
- [ ] P0-003: Fix orden de rutas
- [ ] P0-004: Habilitar guards
- [ ] P1-001: Crear UserStats interface
- [ ] P1-002: Completar Module interface

### Sprint 2-3 (Semanas 3-6)
- [ ] P1-003: Admin types
- [ ] P1-004: ExerciseType frontend
- [ ] P1-005: Token refresh
- [ ] P1-006 a P1-008: Interfaces restantes

### Sprint 4-5 (Semanas 7-10)
- [ ] P1-009: Audit Logging Module
- [ ] P2-001: System Configuration Module

### Sprint 6+ (Semanas 11+)
- [ ] P2-002 a P2-015: Issues medios restantes
- [ ] P3: Backlog de mejoras

---

## Referencias

- **Reporte Original:** `.claude/orchestration/05-validaciones/documentacion/reportes/REPORTE-FINAL-VALIDACION-INTEGRAL-2025-11-04.md`
- **Plan Audit Logging:** `AUDIT_LOGGING_*.md` (15-43 KB)
- **Plan System Config:** `IMPLEMENTATION_PLAN_system_configuration.json` (44 KB)
- **Reportes de Agentes:** 17 archivos en workspace

---

**Documentado por:** Documentation-Architect (Fase C1)
**Fecha:** 2026-01-10
**Próximo paso:** Entregar a equipo de desarrollo para priorización