Como Construí uma Plataforma Educacional Gamificada em Django 6.0 (Build in Public)

# Como Construí uma Plataforma Educacional Gamificada em Django 6.0

Se você acompanha a filosofia **Build in Public**, sabe que criar produtos reais enquanto se aprende é a melhor maneira de consolidar a engenharia de software. Neste artigo, compartilho os bastidores técnicos de como construí a plataforma educacional gamificada do meu portal em **Django 6.0**.

O objetivo primário foi atender a **Persona A** (desenvolvedores juniores e estudantes de TI): uma experiência sem hype, focada em aprendizado prático e verificável com feedback instantâneo.

---

## 🎯 1. Arquitetura da Engine de Feedback & Quizzes AJAX

Em vez de recarregar a página a cada pergunta, a plataforma utiliza um fluxo assíncrono leve via AJAX (`POST /cursos/etapa/<id>/responder/`).

```python
@ratelimit(key='ip', rate='20/m', method='POST', block=False)
def responder_etapa(request, etapa_id):
valido, msg_erro = validar_resposta_segura(request)
if not valido:
return JsonResponse({'sucesso': False, 'mensagem': msg_erro}, status=400)

etapa = get_object_or_404(Etapa, id=etapa_id, licao__modulo__curso__ativo=True)
resposta_usuario = request.POST.get('resposta', '').strip()
acertou = (resposta_usuario.lower() == etapa.resposta_correta.lower())

resposta_obj = RespostaEtapa.objects.create(
session_key=request.session.session_key,
usuario=request.user if request.user.is_authenticated else None,
etapa=etapa,
resposta_usuario=resposta_usuario,
acertou=acertou
)

return JsonResponse({
'sucesso': True,
'acertou': acertou,
'explicacao': etapa.explicacao or "Excelente raciocínio!"
})
```

No frontend, sintetizamos áudio via **Web Audio API** (sem depender de arquivos mp3 pesados) e abrimos uma gaveta de feedback do mascote estilo Mimo/Duolingo.

---

## 🔒 2. Trava de Desbloqueio Sequencial no Backend

Para incentivar a retenção e garantir que o aluno não pule conceitos essenciais, a liberação de lições é controlada no backend através do helper `obter_licoes_liberadas_ids`:

1. A **primeira lição** do curso é sempre liberada por padrão.
2. A **lição N** só é liberada se existir um registro de `ProgressoLicao` concluído para a **lição N-1**.
3. Tentativas de acesso direto por URL são interceptadas com um aviso amigável e redirecionadas para o mapa da trilha (`trilha.html`).

---

## 💬 3. Fórum de Dúvidas Integrado por Lição

Tirar dúvidas sem sair da aula é fundamental para o foco. Cada lição inclui uma aba colapsável de dúvidas vinculada ao app `comunidade`.

A submissão inclui proteção antispam dupla:
- **Rate-Limiting por IP** (`5 msg/min`).
- **Honeypot (`website`) + Timestamp Assinado (`ts_form`)** via `core.antispam`.

---

## 📊 4. Analytics Pedagógico no Painel de Monitoria

Para aperfeiçoar o conteúdo continuamente, o painel interno de monitoria inclui uma aba dedicada com:
- **Taxa Global de Acerto em Quizzes (%)**.
- **Relatório de Etapas Gargalo**: Mapeia em tempo real os Top 5 quizzes com maior índice de respostas incorretas.

---

## 🚀 Conclusão

Construir produtos completos — com testes automatizados, proteção contra spam, persistência resiliente e UI envolvente — é o melhor portfólio que um desenvolvedor pode produzir.