Cards de estudo em Markdown: notas por seção e fechamento

O que são os cards de estudo

Esse fluxo combina três camadas de estudo ativo:

• cards de estudo gerados a partir das seções do documento;
• notas locais por seção, salvas a partir dos cards;
• estudo guiado com reflexões em previsão, questionamento e conclusão, além do fechamento da sessão.

Juntas, elas mostram que o Sanctuary foi pensado para compreensão, não só para visualização.

Para que serve

O objetivo é transformar a leitura em atividade interativa. O usuário pode registrar observações por seção, acompanhar o próprio engajamento no estudo guiado e encerrar a sessão com uma conclusão curta exportável.

Parte 1: Cards de estudo e notas por seção

Como funciona

1. O usuário abre o layout de cards na barra do Reader.
2. Cada seção do documento vira um card com resumo e contagem de palavras.
3. Ao expandir o card, o usuário pode reler a seção inteira.
4. O verso do card oferece uma área de anotação com tinta e linhas opcionais.
5. A nota é salva localmente e o card passa a indicar que aquela seção já foi anotada.

Benefícios

• reforça leitura ativa;
• ajuda revisão e estudo posterior;
• transforma cada seção em uma unidade concreta de revisão.

Evidências

• src/components/reader/ReaderCardsView.astro define a grade de cards, o estado de anotação e a interface expandida para leitura e escrita.
• src/scripts/reader/reader-cards.js gera um card por seção, persiste as notas em localStorage e controla filtros, progresso e preferências de tinta.

Parte 2: Estudo guiado e leitura por reflexão

Como funciona

1. O usuário ativa o estudo guiado em uma seção do documento.
2. O cluster inline oferece quatro fases possíveis: previsão, questionamento, recuperação e conclusão.
3. Previsão, questionamento e conclusão abrem um prompt contextual ao lado do texto. A recuperação abre um overlay em tela cheia que oculta a seção, pede o relato de memória e só então revela o original lado a lado.
4. Ao concluir, o leitor recebe de volta a previsão que escreveu antes de ler e julga se o texto a confirmou, confirmou em parte ou refutou.
5. O painel lateral mostra a seção ativa, o registro acumulado, o mapa geral da sessão e a fila de revisão espaçada.

Benefícios

• ajuda compreensão de textos densos;
• cria um ritual de leitura ativa por seção;
• troca releitura passiva por recuperação ativa, que é o que consolida memória;
• fecha o ciclo da previsão, transformando expectativa em calibração mensurável;
• devolve o leitor às próprias notas dias depois, em vez de deixá-las como arquivo morto;
• favorece estudo, revisão e preparação de discussões a partir do próprio documento.

Evidências

• src/components/reader/ReaderLensPanel.astro define o painel de estudo guiado, o registro de seções, o mapa de sessão e a ajuda contextual.
• src/scripts/reader/reader-lens.js organiza as fases, mantém o estado de engajamento, mede o tempo de permanência por seção e exporta o resultado em Markdown.
• src/scripts/reader/lens-cluster.js injeta os pontos de reflexão ao lado do conteúdo e coleta as respostas por seção.
• src/scripts/reader/lens-recall.js conduz a recuperação ativa em dois passos: escrever de memória e conferir contra o texto.
• src/scripts/reader/lens-review.js transforma as seções anotadas em cartas de recuperação e agenda o retorno delas.

O que esse recurso revela sobre o produto

Esta é a evidência mais forte de que o Sanctuary foi desenvolvido para aprendizado. O app não tenta apenas apresentar o texto: ele organiza um ritual de leitura, revisão e síntese em torno da estrutura do documento.

Limitações e comportamento implícito

• as notas dos cards e o progresso do estudo guiado ficam salvos localmente, não em servidor;
• o modelo é seccional: ele funciona melhor em documentos com H2 e H3 bem estruturados;
• não existe highlight livre por seleção de trecho no Reader atual;
• o estudo guiado organiza reflexão e conclusão, mas não substitui revisão crítica do leitor;
• a recuperação ativa e a calibração são autoavaliadas: o produto não julga se o leitor lembrou certo, apenas cria a ocasião para ele mesmo julgar;
• a revisão espaçada vive no navegador atual — trocar de dispositivo ou limpar os dados perde o agendamento, a menos que a sessão seja exportada e reimportada;
• exportações e fechamentos dependem do estado salvo no navegador do dispositivo atual.

Papel do recurso no produto

Esse recurso reposiciona o Sanctuary de forma decisiva. Ele sugere um leitor de estudo capaz de transformar um Markdown em sessão de trabalho: ler, registrar, sintetizar e fechar o ciclo dentro da mesma interface.