TutorIA
Tutoria para o ENEM dentro do WhatsApp: resolve questões por foto, corrige redação e tira dúvidas com RAG
Repositório privado
Sobre o projeto
TutorIA é uma plataforma de tutoria para quem estuda para o ENEM e vestibulares, acessível pelo WhatsApp. O aluno fotografa uma questão de matemática e recebe a resolução passo a passo; envia uma redação e recebe correção com feedback detalhado e sugestão de repertório sociocultural; pergunta sobre a prova e é atendido por um assistente que responde com base em material indexado. O sistema é dividido em quatro serviços independentes, orquestrados por Docker Compose: o gateway de WhatsApp, o núcleo de IA, o serviço de usuários e o processador de pagamentos. A monetização é por assinatura, com Stripe e webhook próprio para confirmar o pagamento. As resoluções de matemática são entregues formatadas: o serviço gera LaTeX e devolve um PDF, em vez de despejar fórmulas em texto corrido no chat.
Como funciona
A mensagem chega pelo gateway em TypeScript com whatsapp-web.js, que cuida do estado da conversa e roteia para o serviço de IA em Python conforme a intenção: matemática, redação, dúvidas sobre o ENEM ou estudo guiado. Na rota de matemática, o solver multimodal recebe a foto da questão, extrai o enunciado com OCR pelo Google Cloud Vision, resolve com o modelo e passa por um revisor conservador antes de responder, com a resolução convertida em LaTeX e PDF. Na rota de redação, um fluxo multiagente avalia o texto e devolve feedback por competência e repertório sugerido. O assistente do ENEM responde por RAG sobre uma base indexada, em vez de depender só do conhecimento do modelo. O serviço de usuários mantém autenticação e sessão em Postgres via Supabase, e o serviço de webhook do Stripe libera ou revoga o acesso conforme o estado da assinatura. Um módulo de custos acompanha o gasto de API por tipo de operação.
Arquitetura
- 01
Gateway WhatsApp em TypeScript com whatsapp-web.js: canal e estado da conversa
- 02
Serviço de IA em Python: rotas de matemática, redação, ENEM, estudo e jogo
- 03
Correção de redação multiagente com feedback por competência
- 04
Assistente do ENEM por RAG sobre base indexada
- 05
Serviço de usuários em TypeScript: autenticação e sessão em Postgres
- 06
Serviço de webhook do Stripe: assinaturas e liberação de acesso
- 07
Geração de resolução em LaTeX e PDF
- 08
Docker Compose unindo os quatro serviços
Funcionalidades
- Resolução de questões de matemática a partir da foto do enunciado
- Revisor conservador antes de entregar a resposta ao aluno
- Resolução formatada em LaTeX e entregue em PDF
- Correção de redação multiagente com feedback e repertório
- Assistente de dúvidas sobre o ENEM com RAG
- Modo de estudo guiado
- Assinatura via Stripe com webhook de confirmação
- Acompanhamento de custo de API por tipo de operação
Tecnologias
- Backend
- Python · FastAPI · TypeScript · whatsapp-web.js
- AI/ML
- OpenAI GPT · RAG · Google Cloud Vision
- Tools
- PyLaTeX · Stripe
- Database
- PostgreSQL · Supabase
- Infrastructure
- Docker