Skip to content

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)”
2026-04-17 backend por Docs Agent

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
  • AuditLogInterceptor global — escribe el log tras cada request exitosa, sin tocar la lógica de negocio
  • AuditLogsModule es @Global() — un único import en AppModule
  • @AuditLog() añadido a AdminModule, AuthModule e InstructorApplicationsModule
  • Enum AuditAction con 97 valores en schema.prisma Ver ADR-013.
2026-04-17 frontend por Docs Agent

Página /admin/audit-logs — panel SUPER_ADMIN

Nueva página en /admin/audit-logs (solo SUPER_ADMIN):

  • RTK Query slice en adminApi.ts con endpoint getAuditLogs
  • Filtros por action, category, severity y usuario
  • Tabla paginada con detalle de cada entrada
  • Export a CSV con token de autenticación
  • Fix: export de usuarios en /admin/users también corregido para incluir auth token
2026-04-15 backend por Docs Agent

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
2026-04-15 frontend por Docs Agent

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/* del AppLayout
  • 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)”
2026-04-11 frontend por Docs Agent

Creator Studio — portal de instructores

Nuevo portal /creator/* con guard CreatorGuard y layout CreatorLayout:

  • CreatorPortalPage — hub principal con accesos rápidos
  • CreatorPathsPage, CreatorStudentsPage, CreatorReviewsPage
  • CreatorBadgesPage, CreatorGuidelinesPage
  • ProfileCard y UserMenu en el sidebar
  • Editores de contenido migrados de /admin/editor/* a /creator/editor/*
2026-04-11 backend por Docs Agent

Guide Quality Module — guías con versionado snapshot

Nuevo GuideModule en apps/api/src/modules/guide/:

  • Modelos: Guide → GuideSection[] → GuideBlock[] con GuideVersion (snapshot inmutable)
  • GuideService con publishVersion() que congela el estado completo del guide
  • Los estudiantes siempre leen GuideVersion.snapshotJson, nunca los bloques vivos
  • Tipos: GuideBlockType.MARKDOWN | CODE | QUIZ_EMBED | VIDEO Ver ADR-012.

Sprint 5 — Portal navigation y AI monitoring (2026-04-10)

Section titled “Sprint 5 — Portal navigation y AI monitoring (2026-04-10)”
2026-04-10 frontend por Docs Agent

Cross-portal switcher y navegación multi-portal

  • Switcher de portal en el header: estudiante ↔ creator ↔ admin ↔ corporativo
  • UserMenu con opciones contextuales por rol
  • Rutas del portal corporativo (/corporate/*) estabilizadas
  • CorporateLayout con sidebar configurable
2026-04-10 frontend por Docs Agent

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 AIMetricsGateway vía Redis pub/sub.
2026-04-10 backend por Docs Agent

Quiz grading híbrido — exact match + IA

El QuizGradingService evalúa respuestas en dos fases:

  1. Exact-match para respuesta exacta o umbral de similitud Levenshtein ≥ 0.85
  2. Fallback a open_answer_evaluation en 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)”
2026-04-09 ai-backend por Docs Agent

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 contexto
  • adaptive_engine — recomendación de siguiente lección por perfil
  • content_gen_quiz — generación de preguntas de quiz desde contenido
  • content_gen_summary — resumen de lección en 3 puntos clave
  • open_answer_evaluation — evaluación de respuesta libre con rúbrica
  • fluency_test_scoring — scoring del test de diagnóstico
  • semantic_search — búsqueda semántica en Qdrant

Infraestructura:

  • 3 adapters LLM: Anthropic, OpenAI, Gemini con circuit breaker + fallback
  • CredentialsService con cifrado AES-256-GCM — claves gestionadas desde /admin/ai/credentials
  • RouterService — asigna caso de uso a proveedor+modelo según AIRouteConfig en BD
  • MetricsService — registra latencia, tokens y coste por llamada
  • QdrantService — búsqueda semántica y embeddings
  • InternalAuthGuard — valida x-internal-key en todos los endpoints

Las API keys de Anthropic/OpenAI/Gemini no van en .env — siempre cifradas en BD.

2026-04-09 backend por Docs Agent

Creator Program — solicitudes y perfiles de instructor

InstructorApplicationsModule + CreatorsModule:

  • Flujo completo: apply → review → approve/reject (SUPER_ADMIN)
  • Al aprobar: UserRoleCONTENT_ADMIN + CreatorProfile creado automáticamente
  • creatorProfileId incluido en el JWT payload para acceso rápido desde frontend
  • PathReview, CreatorReview, CreatorBadgeDefinition — sistema de reputación Implementa Rule 14 de seguridad: la escalación de rol solo ocurre en InstructorApplicationsService.approve().
2026-04-09 frontend por Docs Agent

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)

2026-04-09 ai-backend por Docs Agent (estado inicial)

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)
2026-04-09 database por Docs Agent (estado inicial)

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
2026-04-09 backend por Docs Agent (estado inicial)

Sistema de gestión de usuarios admin

Nuevos controllers en AdminModule:

  • admin-users.controller.ts — gestión de usuarios para SUPER_ADMIN
  • admin-analytics.controller.ts — analytics del panel
  • admin-certificates.controller.ts — gestión de certificados
  • DTOs de admin documentados
2026-04-08 database por Docs Agent (estado inicial)

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
2026-04-08 database por Docs Agent (estado inicial)

Rutas corporativas privadas e invitaciones

  • OrgPath para paths privados por organización
  • Invitation model para invitar usuarios a corporaciones
2026-04-09 docs por Docs Agent

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
  • 📋 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)