← Guias

Guia Sanctuary

Feature: Cards de Estudo, Estudo Guiado e Fechamento

Use cards de estudo, registre notas por seção e acompanhe o estudo guiado no Sanctuary Reader para estudar e revisar documentos Markdown com mais contexto.

Atualizado
anotacoeseinterpretacaodiscoverysanctuary
Neste guia
  1. O que é
  2. Objetivo no produto
  3. Parte 1: Cards de estudo e notas por seção
  4. Como funciona
  5. Valor entregue
  6. Evidências
  7. Parte 2: Estudo guiado e leitura por reflexão
  8. Como funciona
  9. Valor entregue
  10. Evidências
  11. O que essa feature revela sobre o produto
  12. Limitações e comportamento implícito
  13. Papel da feature no produto

O que é

Esta feature 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.

Objetivo no produto

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.

Valor entregue

  • 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 três fases possíveis: previsão, questionamento e conclusão.
  3. Cada fase abre um pequeno prompt contextual para registrar a reflexão.
  4. O painel lateral passa a mostrar a seção ativa, o registro acumulado e o mapa geral da sessão.

Valor entregue

  • ajuda compreensão de textos densos;
  • cria um ritual de leitura ativa por seção;
  • 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 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.

O que essa feature 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;
  • exportações e fechamentos dependem do estado salvo no navegador do dispositivo atual.

Papel da feature no produto

Esta feature reposiciona o Sanctuary de forma decisiva. Ela 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.