Lições de conteúdo e revisões¶

Uma lição de conteúdo é uma pequena unidade de aprendizagem feita à mão (normalmente 5–10 minutos), descarregada de um conjunto de lições público. Corre num visualizador próprio, não na sessão de chat com IA. Após a lição, a aplicação lembra-se exatamente de que palavras, pares ou frases respondeste mal e agenda-os para uma sessão de revisão dirigida mais tarde.

As lições são um caminho de aprendizagem alternativo que não precisa de chave de API de IA — ideal para experimentar a aplicação ou para conteúdos em que material curado funciona melhor do que o chat livre.

De onde vêm as lições¶

As lições vivem em conjuntos de conteúdo — pequenos pacotes publicados em repos GitHub públicos. O Navegador de conjuntos em /content lista cada conjunto disponível; clica num para o descarregar. O conjunto é armazenado localmente em cache (no sistema de ficheiros em funcionamento com backend, no IndexedDB no modo apenas browser), para que possas aprender offline após o primeiro download.

O conjunto piloto da v1.27.0 é Francês A1 (2 lições, 14 cartões, 9 exercícios que cobrem todos os quatro tipos de exercício). Cada lançamento desde então adiciona novos — vê o repo de conjuntos para o catálogo atual.

O fluxo da lição¶

Abre um conjunto, escolhe uma lição, e o visualizador de lições conduz-te passo a passo por cada cartão e exercício:

Cartões apresentam material para ler. Clica em "Continuar" quando estiveres pronto.
Exercícios testam o que memorizaste. Estão disponíveis quatro tipos:
Correspondência — arrasta pares (palavra ↔ tradução). Ambas as peças de um par encontrado partilham uma cor própria e um badge numérico, para que a correspondência seja reconhecível de forma segura para daltónicos (não apenas pela cor).
Escolha de imagem — escolhe a imagem que corresponde à pista.
Texto livre — escreve a resposta.
Peças de palavras — monta uma frase a partir de peças.
Texto com lacunas — preenche uma lacuna na frase (surge deliberadamente dos teus erros, ver abaixo).

Um indicador de progresso no topo acompanha até onde estás na lição. Podes parar a qualquer momento — o teu progresso é guardado por passo e continua de onde paraste.

Atalho Enter¶

Podes operar toda a lição pelo teclado: Enter verifica um exercício respondido e depois passa ao passo seguinte; os campos de texto livre e de texto com lacunas submetem com Enter (sem quebra de linha). Os elementos de controlo que precisam do próprio Enter têm precedência. O atalho é comutável em Definições → Aprendizagem (ativado por predefinição) e aplica-se também no Replay de Erros ("Repetir erros").

Links de exemplo e de teoria¶

Ver exemplo: Um passo de teoria pode trazer um link opcional para um exemplo detalhado, que aparece como botão "Ver exemplo".
Reler a teoria: Um exercício mostra um link discreto para a teoria precedente mais próxima; daí "Voltar ao exercício" leva-te de novo à tarefa. Assim consultas uma regra sem perder o fio.

O resumo¶

Quando o último exercício está concluído, aparece o resumo da lição:

Uma classificação por estrelas de 0–3 baseada no teu resultado:
3 estrelas ≥ 90 % correto
2 estrelas ≥ 75 %
1 estrela ≥ 50 %
0 estrelas abaixo de 50 %
Um detalhamento exercício a exercício que mostra quais exercícios passaste e quais continham erros (com a resposta correta para os errados).
Próxima lição, Repetir e Voltar ao conjunto como botões, para que a próxima ação esteja a um clique de distância.

Se consegues 3 estrelas à primeira tentativa, toca uma pequena animação de celebração. (Se ativaste a definição do SO "reduzir movimento", a animação respeita-o.)

Exportar resultado¶

O resumo oferece "Copiar resultado" e "Guardar como ficheiro". Ambos geram um relatório Markdown com a tua pontuação, um detalhamento erro a erro (a tua resposta + a resposta correta) e as áreas ainda fracas. O relatório serve para colar num assistente de IA que te ajude de forma dirigida. A exportação é um gerador puro sem backend e funciona em ambos os modos de armazenamento.

Rastreio de erros ao nível do elemento¶

Cada resposta errada em cada tipo de exercício escreve uma linha que aponta para o elemento concreto que falhaste — a palavra, o par ou a frase individual. A aplicação NÃO se lembra apenas de "atingiste 6/10 na lição 3"; lembra-se de "tiveste especial dificuldade com bonjour e merci".

Se respondes ao mesmo elemento corretamente 3 vezes seguidas, ele é marcado como dominado — e removido da fila de revisão. Se respondes mais tarde de forma errada a um elemento dominado, ele volta a descer para a fila. Um domínio falhado é um domínio esquecido.

A fila de revisão¶

Quando tens um ou mais elementos que precisam de revisão, aparece o cartão de revisão no Dashboard. Mostra:

Quantos elementos estão pendentes
Quantos estão em atraso (após a data de revisão agendada)
Um botão Rever agora, que abre uma mini-sessão focada em /review/:setId

O agendamento usa três níveis, com base na frequência com que respondeste ao elemento corretamente em sequência:

Sequência correta	Próxima revisão
0	1 dia depois
1	3 dias depois
2	7 dias depois
3 (dominado)	removido da fila

Dentro da fila, as entradas ordenam-se: as em atraso primeiro, depois por número de erros decrescente, depois por erro mais recente primeiro. Assim, os elementos com que mais lutas sobem ao topo.

Sessões de revisão¶

Uma sessão de revisão em /review/:setId sintetiza uma mini-lição em voo a partir das entradas no topo da tua fila. Estratégia mista desde a v1.35.0:

Se falhaste uma palavra originalmente num exercício de correspondência ou de escolha de imagem, fazes exatamente esse exercício de novo (com baralhamento fresco — não apenas memória muscular).
Se falhaste algo em texto livre ou peças de palavras, a revisão tenta gerar um exercício de texto com lacunas que visa exatamente a palavra falhada. O mesmo conhecimento noutra forma — treina-se a flexibilidade, não apenas a repetição de um formato de exercício específico.
Se não for possível construir um texto com lacunas limpo para um elemento (p. ex. quando a pista original não continha a resposta na frase), a revisão reproduz silenciosamente o exercício original. Nunca recebes um passo partido ou vazio.

Quando concluis uma sessão de revisão, corre a mesma maquinaria de avaliação + estrelas + rastreio de elementos. Domina 50 elementos através de revisões e ganhas o badge Mestre da revisão.

Ronda de correção no fim da lição¶

Novidade na v1.35.0: Quando concluis uma lição com erros, a página de resumo mostra uma pequena ronda de correção entre a tua pontuação e o botão "Próxima lição". Ela pega em até cinco erros concretos dessa lição e oferece cada um como um texto com lacunas fresco que visa exatamente a palavra / o artigo falhado.

Pode saltar-se a qualquer momento. O botão "Próxima lição" permanece visível — a ronda de correção é exercício voluntário, não um gate.
Só aparece se houver algo a corrigir. As lições com pontuação perfeita saltam-na por completo. As lições cujos erros não se podem transformar num texto com lacunas limpo (raro), também.
Cada texto com lacunas concluído conta para o domínio. A ronda de correção escreve os mesmos registos de rastreio de elementos que a lição principal; a tua sequência nesses elementos avança em direção ao limiar de domínio de 3-corretos.

No final aparece uma breve linha "{n} elementos melhorados", para que vejas o efeito do teu exercício adicional.

Feedback visual de diff¶

Também novidade na v1.35.0: As respostas erradas de texto livre e de peças de palavras mostram agora um diff ao nível do token entre a tua entrada e a resposta canónica. Três cores, nunca apenas a cor sozinha:

Vermelho riscado — o que escreveste e que não pertencia (com um marcador × para leitores de ecrã e utilizadores daltónicos).
Verde — o que a resposta canónica contém e que omitiste (com um marcador +).
Amarelo com seta → — uma palavra ligeiramente errada, representada como tua-palavra → esperada.

O mesmo diff aparece no resumo da lição no detalhamento de cada exercício — para cada resposta de texto livre ou de peças de palavras cuja entrada do utilizador o armazenamento v1.35.0+ conheça.

XP e badges¶

Cada lição concluída ganha XP segundo uma fórmula de estrelas:

30 XP de base
+10 XP por estrela alcançada (0 → 0, 1 → +10, 2 → +20, 3 → +30)
+20 XP de bónus se alcançares 3 estrelas à primeira tentativa (cada passo com tentativas = 1, sem repetições)
O mesmo multiplicador de sequência diária que nas sessões de chat (+25 % por dia consecutivo, com limite aos 7 dias)

Quatro novos badges desbloqueiam-se em torno das lições:

Primeira lição — conclui a tua primeira lição de conteúdo.
10 lições concluídas — conclui 10 lições de conteúdo.
Sequência de 3 estrelas — alcança três lições seguidas com 3 estrelas.
Mestre da revisão — domina 50 elementos por repetição espaçada.

As conclusões de lições também contam para a tua sequência diária, de forma que aprender com lições de conteúdo preenche o heatmap da mesma maneira que as sessões de chat.

Modos de armazenamento¶

As lições funcionam em ambos os modos de armazenamento — API (backend) e Dexie (apenas browser / GitHub Pages). O rastreio de erros ao nível do elemento e o agendamento SRS correm de forma idêntica contra o IndexedDB no modo apenas browser, de forma que os utilizadores que visitam a página pública do GitHub Pages obtêm o ciclo completo de revisão sem backend.

Desde a v1.33.0 também a gamificação está alinhada: no modo apenas browser ganhas pelas lições concluídas os mesmos XP e badges de lição que no modo servidor — a lógica de estrelas, Streak e badges está portada para TypeScript e protegida contra valores-ouro idênticos. Já não existe nenhuma diferença de funcionalidade entre os modos na conclusão de lições.

Privacidade¶

Todo o progresso das lições, as linhas de erros de elementos, os estados da fila de revisão e os dados de agendamento permanecem no teu próprio dispositivo — no sistema de ficheiros (modo API) ou no browser (IndexedDB). Nada sobre as palavras com que lutas é enviado para qualquer lado.