Visión general de la plataforma Studeia

Para quién es

Studeia atiende cuatro perfiles de institución:

Arquitectura en una frase

Next.js 15 (App Router) + PostgreSQL (Supabase) + Redis + Prisma 7 + LLM Router multi-proveedor (Claude → GPT → Grok → Gemini fallback) + Voyage AI embeddings (RAG) + Stripe/Asaas billing, desplegado en Docker detrás de Caddy con TLS on-demand (Let's Encrypt automático).

Recursos principales

1. Multi-tenancy real con white-label completo

Cada institución (Tenant) tiene aislamiento de datos a nivel de base de datos (filtro tenantId en todas las queries + RLS en Supabase). El white-label cubre:

• Colores, logo, favicon, fuente
• Dominio personalizado (con TLS automático vía Let's Encrypt)
• 9 temas visuales (6 dark glass + 3 light solid/material)
• Email institucional con plantillas branded
• Posibilidad de deshabilitar completamente la marca Studeia

Detalles en Multi-tenancy y White-label.

2. Tutor IA multi-agente con RAG per-tenant

El tutor IA de Studeia no es un wrapper de ChatGPT. Es un pipeline multi-agente:

Mensaje del alumno
  ↓
StudentModelService    → carga ConceptMastery + misconceptions + rendimiento en quizzes
  ↓
RetrievalAgent         → búsqueda RAG tenant-scoped, boost por áreas débiles en quizzes
  ↓
PedagogicalAgent       → selecciona estrategia (direct_instruction, scaffolding, socratic,
                          guided_practice, challenge) según mastery
  ↓
Orquestador            → construye prompt enriquecido
  ↓
LLM (Claude → GPT → Grok → Gemini fallback)  → streaming
  ↓ tras respuesta
EvaluationAgent        → clasifica misconceptions (Haiku, ~$0.001)
ContentAgent           → pre-genera ejercicio de seguimiento
SupervisorAgent        → modera (background, ~$0.001)

El contenido del curso se ingiere mediante RAG per-tenant — el tutor cita el material correcto de la institución, no contenido genérico. Detalles en Tutor IA Overview.

Además del pipeline multi-componente del tutor, existen agentes administrativos separados, on-demand, con herramientas propias: CourseReviewAgent, AI Course Editor y Gamification Agent. Solo los componentes que llaman a LLM usan la configuración de modelo por tarea (TenantTaskModelConfig) — Orchestrator/Retrieval/Pedagogical son TypeScript puro (determinísticos).

3. CMS educacional con 8 tipos de clase + 6 subtipos interactivos

Tipos de clase: slides, video, PDF, rich_text, quiz, assignment, live_class, external_link.

Subtipos interactivos: interactive_video (con checkpoints), drag_drop, fill_blanks, flashcard_set (con algoritmo SRS SM-2), timeline, branching_scenario (árbol de decisión).

Auto-generación de curso: sube un PDF/DOCX/PPTX, el pipeline LLM extrae tópicos y genera módulos con clases estructuradas. Detalles en CMS.

4. Motor de quiz con analytics psicométricas

Alpha de Cronbach (consistencia interna), discriminación point-biserial, dificultad de ítem, análisis de distractores MC/TF, distribución de puntuaciones. Integridad académica: detecta cambio de pestaña, anomalías de tiempo, muestra flags en el gradebook. Soporte a banco de preguntas reutilizable con 8+ tipos de pregunta.

5. Clases en vivo multi-proveedor

BigBlueButton (por defecto, iframe embed), Zoom (Server-to-Server OAuth), Microsoft Teams (Graph API), Google Meet (OAuth + Calendar). Patrón adapter unificado. Webhooks de ciclo de vida + cron de sincronización de grabaciones (fallback). Credenciales almacenadas con AES-256-GCM.

6. Gamificación nativa completa

XP, niveles (configuración jerárquica tenant→curso), 11 criterios de badge con lógica AND/OR booleana, badges OB 3.0 (Open Badges 3.0 — W3C Verifiable Credential), leaderboards Redis ZSET (ámbito curso/grupo, ventanas weekly/monthly/alltime), contests con 7 métricas, tienda de recompensas con monedas virtuales, y agente IA dedicado para que el admin cree estrategia de gamificación mediante chat.

7. Comunicación integrada

Foros (por grupo o curso completo), anuncios (con ámbito de grupo y notificaciones automáticas), mensajes privados (DMs), notificaciones in-app en tiempo real, adjuntos en cualquier canal (foro/anuncio/mensaje), email institucional con plantillas Handlebars en 4 idiomas, 3 proveedores (SMTP/Resend/SendGrid).

8. SSO Enterprise + SCIM 2.0

SAML 2.0 (vía node-saml), OIDC con PKCE, SCIM 2.0 (14 endpoints RFC 7644), JIT provisioning, mapeo grupo→curso (matriculación automática), audit log SCIM. Plan enterprise.

9. LTI 1.3 (tool provider)

Studeia puede registrarse como herramienta externa en Canvas, Blackboard, Moodle o cualquier LMS compatible con LTI 1.3. OIDC launch, JWT/JWKS, AGS grade passback (las notas se sincronizan de vuelta automáticamente). Detalles en integraciones LTI.

10. Automatizaciones (mini-n8n built-in)

Motor Disparador → Condición → Acción. 3 tipos de trigger: evento de la plataforma, cron programado y webhook público. 21 eventos soportados, incluidos assignment_submitted, live_class_scheduled, badge_earned, level_up y contest_ended. 9 acciones, incluida send_email. Prevención SSRF, rate limiting, límite de profundidad de cadena 5. Webhook público autenticado por token. Detalles en Automatizaciones.

11. Mobile B2B (React Native/Expo)

App Android publicada. Cerca de 47 endpoints /api/mobile/* con shape simplificado y Bearer auth. White-label dinámico post-login. Push notifications vía Expo. SSO mediante deep linking (studeia://auth/callback). OTA updates vía expo-updates.

12. Cumplimiento LGPD nativo

GET /api/user/data-export (Art. 18 IV, rate limit 1/24h). DELETE /api/user/account (Art. 18 VI, anonimiza PII, mantiene datos de aprendizaje por 5 años de retención fiscal). Páginas de Privacidad/Términos públicas en 4 idiomas. DPA disponible para enterprise.

13. API pública con 166 métodos documentados

Doble autenticación (session + Bearer API key). Scopes granulares (courses:read, users:write, etc — 35 tipos). Rate limiting Redis (3 tiers). Docs en /api/overview.

14. Avatar parlante del tutor IA en tiempo real

Opt-in por curso (HeyGen LiveAvatar / D-ID, BYO key). Ver Avatar & TTS.

15. Aprendizaje adaptativo

ConceptMastery bayesiano, ciclo de vida de misconception en 3 estados, repetición espaciada. Ver Aprendizaje adaptativo.

16. IA multi-proveedor

Cambia Claude/GPT/Grok/Gemini por tarea, sin vendor lock-in. Ver IA multi-proveedor.

Modelo de cobro

5 planes B2B:

Costo adicional de IA: típicamente R$2-8/alumno/mes dependiendo del uso (seguimiento vía AiUsageLog por tenant). El admin puede cambiar de proveedor (Claude → GPT → Grok → Gemini) sin romper ninguna funcionalidad.

Stack técnico resumido

• Runtime: Next.js 15 App Router, React Server Components, TypeScript strict mode
• Base de datos: PostgreSQL (Supabase) + pgvector (RAG, 1024 dims)
• ORM: Prisma 7 con adapter-pg
• Cache/Queue: Redis 7 + BullMQ
• LLM: Claude (primary) → OpenAI → xAI Grok → Google Gemini (cadena de fallback por tier)
• Embeddings: Voyage AI (primary, 1024 dims) → OpenAI (fallback)
• Auth: Supabase Auth con SSR
• Storage: Supabase Storage (público para media, privado para submissions)
• Email: SMTP/Resend/SendGrid (factory pattern)
• Video en vivo: BBB/Zoom/Teams/Google Meet (adapter pattern)
• Billing: Stripe + Asaas (PIX)
• Mobile: Expo SDK 52 + NativeWind + Supabase + TanStack Query
• Deploy: Docker + Caddy (TLS on-demand) + Let's Encrypt en VPS propio
• Observabilidad: Sentry (10% session replay, 100% en error)

Conformidad y seguridad

• LGPD nativo (exportación de datos, eliminación de cuenta, DPA enterprise)
• WCAG 2.1 AA (skip-to-content, focus-visible, alto contraste, barra de accesibilidad, navegación por teclado)
• Open Badges 3.0 (W3C Verifiable Credentials)
• LTI 1.3 (compatible con certificación 1EdTech)
• SCIM 2.0 (RFC 7644)
• AES-256-GCM en credenciales OAuth + API keys
• HMAC-SHA256 en OAuth state + cookies de impersonación
• Rate limiting Redis en todas las superficies LLM
• 100 tests unit/integration pasando (45 core + 55 web)

Mapa completo de funcionalidades

Limitaciones conocidas

Para ser honestos sobre los trade-offs:

• App iOS: todavía en el roadmap (requiere cuenta Apple Developer Program $99/año)
• Entrada por voz (STT): hablar con el tutor (voz → texto) no está implementado; el avatar parlante es solo de salida
• Videoclases pre-generadas con IA (Synthesia): no implementado
• Firma criptográfica de badge y botón nativo LinkedIn: roadmap (los badges se verifican hoy vía URL/API pública)
• Plugins de terceros: Studeia no tiene ecosistema de plugins como Moodle. Personalización vía API pública.
• On-premise: Studeia es SaaS-only. Para regulaciones que exigen hospedaje on-premise, aún no lo cubrimos.

Ver también

• Multi-tenancy
• IA multi-proveedor
• Avatar & TTS
• Comparativa: Studeia vs Moodle
• Glosario EAD