StudyTrack — Extrato de Estudos

Experimentar o StudyTrack

StudyTrack é uma aplicação web para planejar estudos, registrar sessões, organizar revisões e transformar o histórico em recomendações explicáveis. Funciona integralmente no navegador e pode ser instalada como PWA.

Funcionalidades

• Disciplinas e tópicos com dificuldade, importância para a prova, esforço e pré-requisitos.
• Planejamento semanal e diário baseado na disponibilidade, necessidade e saldo de capacidade.
• Cronômetro, histórico de sessões, questões e simulados.
• Revisões espaçadas, agenda, calendário e replanejamento.
• Índice de prontidão, retenção, domínio, tendências e projeção por faixa.
• Diagnóstico de erros e alertas com motivo e ação recomendada.
• Resultado mensurável das recomendações, comparando métricas antes e depois.
• Relatório estratégico em PDF e backup completo em JSON.
• Modo demonstração isolado com 130 dias de dados fictícios.
• Tema claro/escuro, layout responsivo e navegação por teclado.

Uso

Acesse a demo online e selecione Explorar demonstração para conhecer o fluxo sem alterar seus dados. Para uso pessoal, saia da demonstração e cadastre a data da prova, a disponibilidade semanal, as disciplinas e os tópicos.

Os dados ficam no navegador. Exporte um backup JSON regularmente pela área de dados. A importação valida o formato e a versão antes de substituir o estado local.

Na área Disciplinas, a opção Importar JSON ou CSV adiciona conteúdo sem substituir o histórico. O CSV aceita as colunas disciplina, topico, dificuldade, importancia, esforco e tags; somente as duas primeiras são obrigatórias. No JSON, use subjects: [{ name, topics: [{ name }] }]. A importância é informada de 0 a 100, o esforço em minutos e múltiplas tags são separadas por |.

Instalação como PWA

No Chrome ou Edge, abra a versão publicada e use a opção Instalar StudyTrack do navegador. O manifest inclui ícones de 192 px, 512 px, maskable e Apple Touch. Depois do primeiro carregamento completo, a aplicação abre offline com o shell armazenado pelo Service Worker.

Quando uma nova versão é publicada, o Service Worker ativa o cache atual e remove caches anteriores.

Executar localmente

Requer Node.js 22 ou superior.

npm install
npm run build
npm run serve

Abra o endereço informado pelo servidor. O Service Worker exige HTTP; abrir index.html diretamente não habilita instalação ou funcionamento offline.

Desenvolvimento e validação

npm test
npm run test:e2e
npm run check:all

npm run check:all executa testes unitários, verifica se o bundle é reproduzível e roda os cenários Playwright. Os testes E2E incluem axe para estrutura ARIA, contraste, modal, telas críticas e modo móvel.

O deploy para GitHub Pages ocorre somente após esse gate passar na branch main.

Arquitetura

O projeto usa JavaScript vanilla e separa estado, domínio, aplicação, repositórios, armazenamento e interface. As regras analíticas são puras e versionadas quando seus resultados precisam permanecer auditáveis. Consulte ARCHITECTURE.md e SECURITY-AUDIT.md.

src/app.bundle.js é gerado pelo esbuild a partir de src/app.js e dos módulos importados; não deve ser editado manualmente.

Privacidade

A aplicação não possui servidor de dados. Sessões, questões, simulados, planos e preferências permanecem no IndexedDB ou no armazenamento local do navegador. A versão publicada no GitHub Pages serve somente arquivos estáticos.

Escopo de concurso e precisão dos dados

Os concursos ativos podem ser Banco do Brasil — Escriturário, Caixa — TBN, Caixa — TBN TI ou uma combinação. Tópicos explicitamente compartilhados entram em todos os editais indicados; conteúdo pessoal sem tags permanece elegível. Sem concurso selecionado, todo o conteúdo não arquivado é considerado.

Métricas de conteúdo, como cobertura, domínio, retenção, lacuna e prioridade, usam somente tópicos elegíveis. Tempo, questões, erros e sessões só são atribuídos a um edital específico quando o registro possui um tópico elegível identificado. Registros somente da disciplina continuam preservados como histórico geral e aparecem separadamente no relatório. Peso oficial é identificado como tal; incidência, dificuldade pedagógica e esforço por tópico podem ser estimativas.

Relatório e PDF

O relatório estratégico permite escolher o período e reúne planejamento versus execução, desempenho, simulados, revisões, riscos, oportunidades, recomendações e perfil de erros. Use a impressão do navegador para salvar o relatório em PDF no formato A4.

Modo demonstração

A demonstração usa sessionStorage e um cenário fictício separado. Reiniciar ou encerrar a demo não altera a base real do navegador.

Atalhos

• Ctrl+K ou Cmd+K: abrir a busca global.
• Ctrl+Shift+1 a Ctrl+Shift+8 ou Cmd+Shift+1 a Cmd+Shift+8: alternar entre as oito áreas.
• Esc: fechar busca, menu ou modal ativo.

Roadmap

O StudyTrack 3.1 conecta o edital às metas de domínio, à matriz de lacunas e às estratégias automáticas. Recomendações podem iniciar sessões guiadas por etapas no cronômetro existente, com estado recuperável. Questões, Agenda/Revisões, Calendário e os painéis analíticos possuem view-models e renderers modulares; src/app.js conserva a orquestração e a compatibilidade temporária.

As próximas entregas estão organizadas em pacotes de implementação, com dependências e critérios de aceite versionados junto ao código.

Licença

Distribuído sob a licença MIT. Consulte LICENSE. Veja também a jornada do produto, com cenários e medidas de referência para o primeiro uso e semanas irregulares.

Fluxos entregues

• Primeiro uso guiado com importação de edital e encaminhamento para Hoje.
• Execução por Agenda ou Sequência flexível, usando as mesmas atividades.
• Recuperação de atrasos com confirmação, desfazer e declaração de excedente.
• Recomendações com ação direta, vínculo à sessão, resultado posterior e motivo opcional ao trocar.
• Fechamento semanal com diagnóstico e até três prioridades estimadas.
• Registro de sessão enxuto, com detalhes adicionais recolhidos.