Para quem e
Studeia atende quatro perfis de instituicao:
| Vertical | Caso tipico | Recursos prioritarios |
|---|---|---|
| Escolas K-12 | Fundamental e medio, BNCC alignment, portal de pais | Portal pais com narrativa IA, gamificacao, monitoramento de menores, LGPD |
| Cursinhos ENEM/vestibular | Simulados ao vivo, tutor IA personalizado, analytics | Quiz analytics psicometricas, IA tutor com RAG do material, simulados |
| Universidades | Cursos hibridos, LTI com Canvas/Moodle existente, gradebook | LTI 1.3 (tool provider), rubricas multi-criterio, AGS grade passback |
| Treinamento corporativo | T&D, compliance, SSO com Okta/Azure AD | SAML/OIDC, SCIM 2.0, certificados verificaveis (OB 3.0), API publica |
Arquitetura em uma frase
Next.js 15 (App Router) + PostgreSQL (Supabase) + Redis + Prisma 7 + LLM Router multi-provider (Claude → GPT → Grok → Gemini fallback) + Voyage AI embeddings (RAG) + Stripe/Asaas billing, deployado em Docker atras de Caddy com TLS on-demand (Let's Encrypt automatico).
Recursos principais
1. Multi-tenancy real com white-label completo
Cada instituicao (Tenant) tem isolamento de dados em nivel de banco (filtro tenantId em todas as queries + RLS no Supabase). White-label cobre:
- Cores, logo, favicon, fonte
- Dominio custom (com TLS automatico via Let's Encrypt)
- 9 temas visuais (6 dark glass + 3 light solid/material)
- Email institucional com templates branded
- Pode ate desabilitar a marca Studeia totalmente
Detalhes em Multi-tenancy e White-label.
2. Tutor IA multi-agente com RAG per-tenant
O tutor IA do Studeia nao e um wrapper de ChatGPT. E um pipeline multi-agente:
Mensagem do aluno
↓
StudentModelService → carrega ConceptMastery + misconceptions + quiz performance
↓
RetrievalAgent → busca RAG tenant-scoped, boost por areas fracas em quizzes
↓
PedagogicalAgent → seleciona estrategia (direct_instruction, scaffolding, socratic,
guided_practice, challenge) baseado em mastery
↓
Orquestrador → monta prompt enriquecido
↓
LLM (Claude → GPT → Grok → Gemini fallback) → streaming
↓ apos resposta
EvaluationAgent → classifica misconceptions (Haiku, ~$0.001)
ContentAgent → pre-gera exercicio follow-up
SupervisorAgent → modera (background, ~$0.001)
Conteudo do curso e ingerido via RAG per-tenant — o tutor cita o material correto da instituicao, nao conteudo generico. Detalhes em Tutor IA Overview.
Alem do pipeline multi-componente do tutor, ha agentes administrativos separados, on-demand, com ferramentas proprias: CourseReviewAgent, AI Course Editor e Gamification Agent. Apenas os componentes que chamam LLM usam a config de modelo por tarefa (TenantTaskModelConfig) — Orchestrator/Retrieval/Pedagogical sao TypeScript puro (deterministicos).
3. CMS educacional com 8 tipos de aula + 6 subtypes interativos
Tipos de aula: slides, video, PDF, rich_text, quiz, assignment, live_class, external_link.
Subtypes interativos: interactive_video (com checkpoints), drag_drop, fill_blanks, flashcard_set (com SRS algoritmo SM-2), timeline, branching_scenario (arvore de decisao).
Auto-geracao de curso: faca upload de PDF/DOCX/PPTX, pipeline LLM extrai topicos e gera modulos com aulas estruturadas. Detalhes em CMS.
4. Quiz engine com analytics psicometricas
Cronbach's alpha (consistencia interna), point-biserial discrimination, item difficulty, distractor analysis MC/TF, score distribution. Integridade academica: detecta tab switch, time anomalies, exibe flags no gradebook. Suporte a question bank reusavel com 8+ tipos de questao.
5. Aulas ao vivo multi-provider
BigBlueButton (padrao, iframe embed), Zoom (Server-to-Server OAuth), Microsoft Teams (Graph API), Google Meet (OAuth + Calendar). Adapter pattern unificado. Webhooks lifecycle + cron de recording sync (fallback). Credenciais armazenadas com AES-256-GCM.
6. Gamificacao nativa completa
XP, niveis (config hierarquica tenant→curso), 11 criterios de badge com logica AND/OR booleana, badges OB 3.0 (Open Badges 3.0 — W3C Verifiable Credential), leaderboards Redis ZSET (escopo curso/turma, janelas weekly/monthly/alltime), contests com 7 metricas, rewards shop com moedas virtuais, e agente IA dedicado para admin criar estrategia de gamificacao via chat.
7. Comunicacao integrada
Forums (por turma ou course-wide), anuncios (com escopo de turma e notificacoes auto), mensagens privadas (DMs), notificacoes in-app real-time, anexos em qualquer canal (forum/anuncio/mensagem), email institucional com templates Handlebars em 4 idiomas, 3 providers (SMTP/Resend/SendGrid).
8. SSO Enterprise + SCIM 2.0
SAML 2.0 (via node-saml), OIDC com PKCE, SCIM 2.0 (14 endpoints RFC 7644), JIT provisioning, group→course mapping (matricula automatica), audit log SCIM. Plano enterprise.
9. LTI 1.3 (tool provider)
Studeia pode ser registrado como external tool em Canvas, Blackboard, Moodle ou qualquer LMS LTI 1.3-compliant. OIDC launch, JWT/JWKS, AGS grade passback (notas sincronizam de volta automaticamente). Detalhes em integracoes LTI.
10. Automacoes (mini-n8n built-in)
Engine Gatilho → Condicao → Acao. 3 tipos de trigger: evento da plataforma, cron agendado e webhook publico. 21 eventos suportados, incluindo assignment_submitted, live_class_scheduled, badge_earned, level_up e contest_ended. 9 actions, incluindo send_email. SSRF prevention, rate limiting, chain depth limit 5. Webhook publico autenticado por token. Detalhes em Automacoes.
11. Mobile B2B (React Native/Expo)
App Android publicado. Cerca de 47 endpoints /api/mobile/* com shape simplificado e Bearer auth. White-label dinamico pos-login. Push notifications via Expo. SSO via deep linking (studeia://auth/callback). OTA updates via expo-updates.
12. LGPD compliance nativo
GET /api/user/data-export (Art. 18 IV, rate limit 1/24h). DELETE /api/user/account (Art. 18 VI, anonimiza PII, mantem learning data por 5 anos retencao fiscal). Privacy/Terms publicas em 4 idiomas. DPA disponivel para enterprise.
13. API publica com 166 metodos documentados
Dual auth (session + Bearer API key). Scopes granulares (courses:read, users:write, etc — 35 tipos). Rate limiting Redis (3 tiers). Docs em /api/overview.
14. Avatar falante do tutor IA em tempo real
Opt-in por curso (HeyGen LiveAvatar / D-ID, BYO key). Ver Avatar & TTS.
15. Aprendizado adaptativo
ConceptMastery bayesiano, lifecycle de misconception em 3 estados, repeticao espacada. Ver Aprendizado adaptativo.
16. IA multi-provider
Trocar Claude/GPT/Grok/Gemini por tarefa, sem vendor lock-in. Ver IA multi-provider.
Modelo de cobranca
5 planos B2B:
| Plano | Preco/mes | Alunos | Para quem |
|---|---|---|---|
| Demo | Gratis | 1 | Avaliar a plataforma (Haiku only, 10 msgs/dia) |
| Mini | R$250 | 10 | Tutor particular, escola pequena |
| Crescimento | R$1.000 | 50 | Cursinho pequeno, treinamento corporativo |
| Escala | R$1.500 | 100 | Cursinho medio, escola |
| Enterprise | Sob consulta | Custom (maxStudentsOverride) | Universidade, T&D corporativo grande |
Custo adicional de IA: tipicamente R$2-8/aluno/mes dependendo do uso (tracking via AiUsageLog por tenant). Admin pode trocar de provider (Claude → GPT → Grok → Gemini) sem quebrar nenhuma feature.
Stack tecnica resumida
- Runtime: Next.js 15 App Router, React Server Components, TypeScript strict mode
- Banco: PostgreSQL (Supabase) + pgvector (RAG, 1024 dims)
- ORM: Prisma 7 com adapter-pg
- Cache/Queue: Redis 7 + BullMQ
- LLM: Claude (primary) → OpenAI → xAI Grok → Google Gemini (fallback chain por tier)
- Embeddings: Voyage AI (primary, 1024 dims) → OpenAI (fallback)
- Auth: Supabase Auth com SSR
- Storage: Supabase Storage (publico para midia, privado para submissions)
- Email: SMTP/Resend/SendGrid (factory pattern)
- Video live: 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 em VPS proprio
- Observabilidade: Sentry (10% session replay, 100% on error)
Conformidade e seguranca
- LGPD nativo (data export, account deletion, DPA enterprise)
- WCAG 2.1 AA (skip-to-content, focus-visible, high-contrast, A11y toolbar, keyboard nav)
- Open Badges 3.0 (W3C Verifiable Credentials)
- LTI 1.3 (1EdTech certified-compatible)
- SCIM 2.0 (RFC 7644)
- AES-256-GCM em credenciais OAuth + API keys
- HMAC-SHA256 em OAuth state + cookies de impersonacao
- Rate limiting Redis em todas as superficies LLM
- 100 testes unit/integration passando (45 core + 55 web)
Mapa completo de features
| Area | Paginas |
|---|---|
| Plataforma | Multi-tenancy · White-label · IA multi-provider · App mobile · Seguranca & LGPD · Acessibilidade · i18n · SSO Enterprise |
| Tutor IA | Pipeline · RAG ingestion · Aprendizado adaptativo · Avatar & TTS · Supervisor de safety |
| CMS | Cursos & aulas · Tipos de aula · Conteudo interativo · AI course builder · Biblioteca de midia |
| Avaliacao | Quiz engine · Banco de questoes · Gradebook |
| Engajamento | Gamificacao · Aulas ao vivo · Comunicacao · Email |
| Operacao | Automacoes · Relatorios & risco · API · LTI 1.3 |
Limitacoes conhecidas
Para ser honesto sobre trade-offs:
- iOS app: ainda em roadmap (requer conta Apple Developer Program $99/ano)
- Voz de entrada (STT): falar com o tutor (fala → texto) nao esta implementado; o avatar falante e somente saida
- Video-aulas pre-geradas via IA (Synthesia): nao implementado
- Assinatura criptografica de badge & botao nativo LinkedIn: roadmap (badges verificam via URL/API publica hoje)
- Plugins de terceiros: Studeia nao tem ecossistema de plugins como Moodle. Personalizacao via API publica.
- On-premise: Studeia e SaaS-only. Para regulacoes que exigem hospedagem on-premise, ainda nao atendemos.