Kharis Sistema Educacional

Sobre

Plataforma SaaS multi-tenant que idealizei e estou construindo: serve professores, alunos, pedagogos, diretores e responsáveis num único sistema, com 6 perfis distintos. Diferenciais técnicos: arenas ao vivo (alunos competem em tempo real via WebSockets), homework adaptativo gerado por IA (Claude analisa erros do aluno e cria questões focadas nos pontos fracos) e tutor socrático que explica conceitos sem dar gabarito. Status: alpha avançado, lançamento em escolas-piloto previsto pra 2026.

Stack

• NestJS·
• TypeORM·
• PostgreSQL·
• Next.js·
• React·
• TypeScript·
• WebSockets·
• Claude API·
• AWS S3·
• JWT·
• PWA

Decisões

• Multi-tenancy por instituição (escola) com papéis diferentes por usuário em escolas diferentes — um professor pode ser pai noutra escola.
• Arenas em tempo real via WebSocket nativo (sem Socket.io overhead) — latência baixa pra dezenas de alunos simultâneos.
• Homework gerado por IA com cache estruturado — questões similares pra mesmo perfil de erro reusam contexto, reduzindo custo da API.
• Tutor socrático com prompt engineering específico — Claude explica conceito SEM revelar gabarito, mesmo sob pressão.
• PWA com offline pra telas críticas (deveres, calendário) — aluno em rede ruim continua estudando.
• Gamificação como sistema de reforço positivo, não vício — XP por aprendizado correto, não por tempo de tela.

Desafios técnicos

• Sincronizar 30+ alunos numa arena ao vivo sem lag visível: tick fixo de 200ms + diff incremental pelo WebSocket.
• Fazer Claude gerar questões consistentes com BNCC: prompt template parametrizado por disciplina, série e habilidade.
• Modelar permissões com 6 perfis sem virar regra-em-regra-em-regra: RBAC declarativo com herança por contexto.
• Onboarding de escola com importação de turmas/alunos: planilha CSV validada com erros agrupados em vez de batch-and-pray.