eTecTrilha API v1.0.0

Cadastra usuário com e-mail e senha

Envia o link de redefinição de senha

Responde 200 mesmo quando o e-mail não existe ou a conta só tem login Google, para não permitir enumeração de cadastrados.

Verifica se um token de redefinição ainda é válido

Troca a senha usando o token recebido por e-mail

Fluxo de login NextAuth (Google e credenciais)

Resumo do usuário: XP, nível, vidas, streak, precisão, revisões pendentes

Atualiza nome e preferência de som

Jornada completa: disciplinas → módulos → fases, com progresso e bloqueios

Conteúdo de uma fase, sem gabarito (kind QUESTION → até 5 questões reais sorteadas entre as atribuídas; kind LESSON → exercícios + bonusQuestions, até 5 questões reais da disciplina)

Registra conclusão de fase (bônus na primeira conclusão com ≥50%: +100 XP em fase de questões, +40 XP em lição)

Explica por IA por que uma resposta errada específica está errada (botão "Por que errei?")

Sob demanda, nunca automático. Cacheado por (conteúdo, resposta errada) — a primeira vez que alguém erra de um jeito específico chama a API; as seguintes leem do cache. Exige que o aluno já tenha respondido isso com essa resposta (não é possível sondar gabarito sem ter respondido). Limite diário de gerações reais por aluno (cache-hit não conta). O texto vem em tópicos, uma linha por tópico no formato "- Rótulo: conteúdo", em texto puro (sem markdown nem LaTeX). Explicação em cache gerada por uma versão anterior do prompt é regerada e sobrescrita.

Responde uma questão — retorna gabarito, explicação, XP, vidas e conquistas

Regras: +10 XP por acerto (dobro no desafio diário; assinante Pró ganha +50% em cima); +50 XP a cada 5 acertos seguidos (campo combo); errar em fase/desafio custa 1 vida (assinante Pró não perde vidas); erros entram na revisão espaçada (1, 3, 7, 15, 30 dias).

Reporta um problema em uma questão (vai para a fila de revisão do admin)

Um registro por aluno/questão: reenviar atualiza o reporte existente e reabre a análise. Máximo de 20 reportes pendentes por aluno.

Questões erradas vencidas para revisar (repetição espaçada)

Desafio diário (5 exercícios de lição + 5 questões reais de calibração, que valem XP em dobro) e status do dia; format LEGACY para um dia já sorteado antes desta divisão (10 questões)

Registra a conclusão do desafio diário

Lista os simulados do usuário

Cria um simulado com filtros (ano, disciplina, aleatório)

Detalhe do simulado (gabarito incluído apenas após finalizar)

Finaliza o simulado: nota, acertos, erros, tempo, percentil e análise por disciplina

Dashboard: acertos por disciplina, evolução semanal, mapa de calor, tempo estudado

Ranking semanal, mensal ou geral

Conquistas (todas + desbloqueadas)

Ativa o teste grátis do Pró (7 dias, uma vez por conta)

Lista questões com filtros e paginação

Cadastra uma questão

Edita uma questão

Exclui uma questão

Fila de reportes de questões, com contagem de pendentes por questão

Resolve um reporte (aceita/recusa) — resolve em cascata os da mesma questão

Configurações do app editáveis pelo admin

Atualiza o limiar de reportes pendentes que oculta a questão (0 = nunca)

Lista usuários com Pró ativo

Concede ou revoga o Pró de um usuário por e-mail

Importa questões em massa (JSON ou CSV, até 10.000 por chamada)

Cabeçalhos aceitos (flexíveis): ano, semestre, disciplina, tema, enunciado, a, b, c, d, e, correta/gabarito, explicacao, dificuldade, tempo_medio. Importar não cria fases na trilha: as questões ficam disponíveis para simulados/desafio/revisão; a trilha é montada por lições.