educacao/decoda
10
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feature/plausible #3

Merged
rui.moraes merged 2 commits from feature/plausible into main 2026-06-13 22:09:53 -03:00
Conversation 0 Commits 2 Files Changed 15 +342 -46
rui.moraes commented 2026-06-13 22:09:41 -03:00
Owner
Copy Link

Integração do Plausible Community Edition para Analytics Educacional

Este PR implementa rastreamento de eventos educacionais através do Plausible CE, permitindo análise de padrões de aprendizagem nas atividades de programação sem comprometer a privacidade dos usuários.

Mudanças principais

Core Analytics

  • Adicionado rastreamento de eventos em GameStateContext.jsx:
    • Activity Success: com métricas de tentativas, falhas, tempo gasto e blocos utilizados
    • Activity Failure: com mensagem de erro
  • Implementado serviço de eventos (plausible.js) com timeout de 5s e tratamento robusto de falhas
  • App continua funcionando normalmente mesmo se Plausible estiver indisponível

Métricas por Atividade

  • attempts: número total de tentativas até ter sucesso
  • failures: número de falhas antes do sucesso
  • durationSeconds: tempo total gasto na fase
  • blocks: quantidade de blocos/linhas de código
  • activity e phase: identificadores para análise por atividade e fase

Configuração Ambiental

  • Variáveis de ambiente por ambiente:
    • Desenvolvimento: API local (http://localhost/api/event), domínio myapp-dev
    • Produção: API Plausible remota, domínio https://decoda.mtst.tec.br
  • Arquivos .env e .env.production em app/ (não afeta raiz com docker-compose)

Documentação

  • Release notes v1.2.0: Explicação de eventos, motivação Plausible CE, análise pedagógica
  • Documento de arquitetura: Detalhamento técnico com diagrama Mermaid, componentes, tratamento de erros e privacidade

Por que Plausible CE?

  • Sem cookies de rastreamento
  • Sem coleta invasiva de dados pessoais
  • Conformidade com LGPD
  • Software livre, auditável, hospedável localmente

Testes sugeridos

  • Verificar se eventos são enviados para Plausible local em desenvolvimento
  • Desligar o Plausible e confirmar que a app continua funcionando
  • Acompanhar uma atividade de programação completa e validar dados no dashboard Plausible
### Integração do Plausible Community Edition para Analytics Educacional Este PR implementa rastreamento de eventos educacionais através do Plausible CE, permitindo análise de padrões de aprendizagem nas atividades de programação sem comprometer a privacidade dos usuários. ## Mudanças principais ### Core Analytics - Adicionado rastreamento de eventos em `GameStateContext.jsx`: - `Activity Success`: com métricas de tentativas, falhas, tempo gasto e blocos utilizados - `Activity Failure`: com mensagem de erro - Implementado serviço de eventos (`plausible.js`) com timeout de 5s e tratamento robusto de falhas - App continua funcionando normalmente mesmo se Plausible estiver indisponível ### Métricas por Atividade - `attempts`: número total de tentativas até ter sucesso - `failures`: número de falhas antes do sucesso - `durationSeconds`: tempo total gasto na fase - `blocks`: quantidade de blocos/linhas de código - `activity` e `phase`: identificadores para análise por atividade e fase ### Configuração Ambiental - Variáveis de ambiente por ambiente: - Desenvolvimento: API local (`http://localhost/api/event`), domínio `myapp-dev` - Produção: API Plausible remota, domínio `https://decoda.mtst.tec.br` - Arquivos `.env` e `.env.production` em `app/` (não afeta raiz com docker-compose) ### Documentação - Release notes v1.2.0: Explicação de eventos, motivação Plausible CE, análise pedagógica - Documento de arquitetura: Detalhamento técnico com diagrama Mermaid, componentes, tratamento de erros e privacidade ## Por que Plausible CE? - Sem cookies de rastreamento - Sem coleta invasiva de dados pessoais - Conformidade com LGPD - Software livre, auditável, hospedável localmente ## Testes sugeridos - Verificar se eventos são enviados para Plausible local em desenvolvimento - Desligar o Plausible e confirmar que a app continua funcionando - Acompanhar uma atividade de programação completa e validar dados no dashboard Plausible
rui.moraes added 2 commits 2026-06-13 22:09:42 -03:00
feat: add plausible 1c496e8d8d
feat: v1.2.0 08fd4db37f
rui.moraes merged commit 89eed44b49 into main 2026-06-13 22:09:53 -03:00
rui.moraes deleted branch feature/plausible 2026-06-13 22:09:53 -03:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
bruno.willow fred.amaral.jr indra.araujo leonardorpires lrafaelz lucas.abreu matheusgraciano rui.moraes solangedossantos teste
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: educacao/decoda#3
Delete Branch "feature/plausible"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?