Abril 2026 — Sprints 0-6
Sprint 7 — Audit Logs y Tutor IA (2026-04-15/17)
Section titled “Sprint 7 — Audit Logs y Tutor IA (2026-04-15/17)”Módulo AuditLogs — trazabilidad de acciones admin (ADR-013)
Nuevo AuditLogsModule en apps/api/src/modules/audit-logs/:
- Decorador
@AuditLog({ action, category, severity, entityType, entityIdParam, captureBody })en controllers AuditLogInterceptorglobal — escribe el log tras cada request exitosa, sin tocar la lógica de negocioAuditLogsModulees@Global()— un único import enAppModule@AuditLog()añadido aAdminModule,AuthModuleeInstructorApplicationsModule- Enum
AuditActioncon 97 valores enschema.prismaVer ADR-013.
Página /admin/audit-logs — panel SUPER_ADMIN
Nueva página en /admin/audit-logs (solo SUPER_ADMIN):
- RTK Query slice en
adminApi.tscon endpointgetAuditLogs - Filtros por
action,category,severityy usuario - Tabla paginada con detalle de cada entrada
- Export a CSV con token de autenticación
- Fix: export de usuarios en
/admin/userstambién corregido para incluir auth token
Tutor IA — SSE streaming, historial y rating
Módulo de Tutor IA en apps/api/src/modules/:
- Streaming de respuestas via SSE (Server-Sent Events)
- Historial de conversaciones persistido por usuario en BD
- Rating de respuestas — el usuario puede valorar cada mensaje del tutor
- Límites de uso por plan (FREE tiene cuota diaria reducida)
- Contexto consciente del path, módulo y lección activos
Panel lateral Tutor IA (380px) en /learn/*
Componente TutorIAPanel en apps/web/src/components/tutor/:
- Panel lateral de 380px, colapsable
- Disponible en todas las rutas
/learn/*delAppLayout - Streaming en tiempo real con SSE
- Historial de conversaciones por sesión
- UI de rating inline por mensaje
Sprint 6 — Creator Studio y Guide Quality Module (2026-04-11)
Section titled “Sprint 6 — Creator Studio y Guide Quality Module (2026-04-11)”Creator Studio — portal de instructores
Nuevo portal /creator/* con guard CreatorGuard y layout CreatorLayout:
CreatorPortalPage— hub principal con accesos rápidosCreatorPathsPage,CreatorStudentsPage,CreatorReviewsPageCreatorBadgesPage,CreatorGuidelinesPageProfileCardyUserMenuen el sidebar- Editores de contenido migrados de
/admin/editor/*a/creator/editor/*
Guide Quality Module — guías con versionado snapshot
Nuevo GuideModule en apps/api/src/modules/guide/:
- Modelos:
Guide → GuideSection[] → GuideBlock[]conGuideVersion(snapshot inmutable) GuideServiceconpublishVersion()que congela el estado completo del guide- Los estudiantes siempre leen
GuideVersion.snapshotJson, nunca los bloques vivos - Tipos:
GuideBlockType.MARKDOWN | CODE | QUIZ_EMBED | VIDEOVer ADR-012.
Sprint 5 — Portal navigation y AI monitoring (2026-04-10)
Section titled “Sprint 5 — Portal navigation y AI monitoring (2026-04-10)”Cross-portal switcher y navegación multi-portal
- Switcher de portal en el header: estudiante ↔ creator ↔ admin ↔ corporativo
UserMenucon opciones contextuales por rol- Rutas del portal corporativo (
/corporate/*) estabilizadas CorporateLayoutcon sidebar configurable
Panel de monitoreo IA en tiempo real
/admin/ai/monitoring — dashboard de métricas del AI Backend:
- Tabla de uso por caso de uso, proveedor y modelo
- Gráficas de latencia y coste por período
- Estado del circuit breaker por proveedor (verde/amarillo/rojo)
- Feed de últimas llamadas con status y token count
Los datos llegan por WebSocket desde
AIMetricsGatewayvía Redis pub/sub.
Quiz grading híbrido — exact match + IA
El QuizGradingService evalúa respuestas en dos fases:
- Exact-match para respuesta exacta o umbral de similitud Levenshtein ≥ 0.85
- Fallback a
open_answer_evaluationen ai-backend si no hay match Esto reduce llamadas al LLM y mejora latencia en quizzes con respuestas conocidas.
Sprint 4 — AI Backend y Creator Program (2026-04-09)
Section titled “Sprint 4 — AI Backend y Creator Program (2026-04-09)”AI Backend como microservicio propio (ADR-010)
Creación de apps/ai-backend con 7 casos de uso implementados:
tutor_chat— AI Tutor conversacional con historial de contextoadaptive_engine— recomendación de siguiente lección por perfilcontent_gen_quiz— generación de preguntas de quiz desde contenidocontent_gen_summary— resumen de lección en 3 puntos claveopen_answer_evaluation— evaluación de respuesta libre con rúbricafluency_test_scoring— scoring del test de diagnósticosemantic_search— búsqueda semántica en Qdrant
Infraestructura:
- 3 adapters LLM: Anthropic, OpenAI, Gemini con circuit breaker + fallback
CredentialsServicecon cifrado AES-256-GCM — claves gestionadas desde/admin/ai/credentialsRouterService— asigna caso de uso a proveedor+modelo segúnAIRouteConfigen BDMetricsService— registra latencia, tokens y coste por llamadaQdrantService— búsqueda semántica y embeddingsInternalAuthGuard— validax-internal-keyen todos los endpoints
Las API keys de Anthropic/OpenAI/Gemini no van en .env — siempre cifradas en BD.
Creator Program — solicitudes y perfiles de instructor
InstructorApplicationsModule + CreatorsModule:
- Flujo completo: apply → review → approve/reject (SUPER_ADMIN)
- Al aprobar:
UserRole→CONTENT_ADMIN+CreatorProfilecreado automáticamente creatorProfileIdincluido en el JWT payload para acceso rápido desde frontendPathReview,CreatorReview,CreatorBadgeDefinition— sistema de reputación Implementa Rule 14 de seguridad: la escalación de rol solo ocurre enInstructorApplicationsService.approve().
Panel /admin/ai/* — gestión del motor IA
Nuevo panel de IA en /admin/ai/:
/admin/ai/credentials— gestión de API keys cifradas (add/rotate/revoke)/admin/ai/routing— configuración de caso de uso → proveedor+modelo/admin/ai/monitoring— métricas en tiempo real (ver Sprint 5)
Estado del proyecto en Abril 2026
Section titled “Estado del proyecto en Abril 2026”Infraestructura de IA propia (ADR-010)
Creación de apps/ai-backend como microservicio NestJS con:
- 3 adapters LLM: Anthropic, OpenAI, Gemini
- RouterService con circuit breaker y fallback automático
- CredentialsService con cifrado AES-256-GCM
- QdrantService para búsqueda semántica
- 9 casos de uso: tutor_chat, adaptive_engine, content_gen_*, open_answer_evaluation, fluency_test_scoring, churn_prediction, semantic_search
- Panel admin en
/admin/ai/*(integración en progreso)
Creator Program y Recursos Educativos
Migración add_creator_program_and_resources:
- Modelos: CreatorProfile, InstructorApplication, PathReview, CreatorReview, CreatorBadgeDefinition
- Modelos: Resource, ResourceAttachment
- Soporte para materiales PDF, DOCX, PPTX, XLSX, YOUTUBE, H5P, LINK
Sistema de gestión de usuarios admin
Nuevos controllers en AdminModule:
admin-users.controller.ts— gestión de usuarios para SUPER_ADMINadmin-analytics.controller.ts— analytics del paneladmin-certificates.controller.ts— gestión de certificados- DTOs de admin documentados
Quiz con puntuación y lecciones muchos-a-muchos
- Migración de QuizQuestion con sistema de puntos
- Junction table ModuleLesson para reutilización de lecciones entre módulos
- Audit trail para cambios en lecciones y quizzes
Rutas corporativas privadas e invitaciones
- OrgPath para paths privados por organización
- Invitation model para invitar usuarios a corporaciones
Portal de documentación (este portal)
Creación inicial de apps/docs con Astro Starlight:
- 10 secciones de documentación técnica
- Componentes custom NappAI (StatusBadge, TierBadge, ApiEndpoint, etc.)
- Design system NappAI (tokens CSS violeta)
- Agente de documentación con 6 slash commands
Features completamente implementadas (Sprints 0-7)
Section titled “Features completamente implementadas (Sprints 0-7)”- ✅ Auth JWT + OAuth (Google, LinkedIn)
- ✅ Catálogo de paths/módulos/lecciones
- ✅ Player de video (Bunny.net)
- ✅ Sistema de progreso por lección/módulo/path
- ✅ Quiz con evaluación exacta + fallback a IA
- ✅ Certificados SHA-256 verificables públicamente
- ✅ Multi-tenancy corporativo (Organizations, OrgPath, Invitation)
- ✅ Panel admin — CONTENT_ADMIN + SUPER_ADMIN
- ✅ Pagos Stripe (suscripciones + webhooks)
- ✅ Dashboard personal del estudiante
- ✅ AI Fluency Test diagnóstico
- ✅ Access-control E2E suite (blocking en CI)
- ✅ AI Backend — microservicio propio con 7 casos de uso (ADR-010)
- ✅ Panel
/admin/ai/*— credenciales, routing y monitoreo IA - ✅ Creator Program — aplicaciones de instructor + aprobación SUPER_ADMIN
- ✅ AI Tutor — chat conversacional con historial de contexto
- ✅ Motor adaptativo — recomendación de siguiente lección
- ✅ Generación automática de quizzes y resúmenes con IA
- ✅ Creator Studio portal (
/creator/*) con 5 páginas + editores - ✅ Guide Quality Module — guías con secciones, bloques y versiones snapshot
- ✅ Audit Logs — decorador
@AuditLog(), interceptor global, panel/admin/audit-logs(ADR-013) - ✅ Tutor IA Sprint 7 — panel lateral SSE 380px en
/learn/*, historial, rating, límites por plan - ✅ Scheduled Jobs — cron tracking con enable/disable desde
/admin/platform/jobs - ✅ Notifications — 101 tipos, deduplicación 24h, severidad crítica, preferencias por usuario
Planificado (Sprint 8+)
Section titled “Planificado (Sprint 8+)”- 📋 Búsqueda semántica con Qdrant en catálogo y guías
- 📋 Predicción de abandono (churn prediction) con IA
- 📋 Casos prácticos generados con IA (content_gen_case_study)
- 📋 Mobile app (React Native)