NotariumDocumentação
Versão da documentação: latest
PT

Lixeira

A Lixeira é uma rede de segurança para seus dados: uma nota excluída não desaparece de vez — ela vai parar em uma lista de onde você pode restaurá-la ou apagá-la em definitivo. Nos bastidores, não se trata de um armazenamento separado, mas de uma visão sobre o registro de revisões: uma nota é considerada "na Lixeira" quando sua revisão mais recente é uma exclusão. Qualquer salvamento ou restauração feito por cima torna uma não-exclusão a revisão mais nova, e a nota sai da Lixeira automaticamente.

Desse enfoque decorre uma propriedade agradável: você pode até restaurar uma nota que foi excluída fora do Notarium — por exemplo, com o comando rm no sistema de arquivos. O registro captura essas exclusões também.

Uma Lixeira unificada

A Lixeira é um único lugar para tudo o que foi excluído: tanto notas individuais quanto espaços inteiros. Na interface, são abas de filtro — All / Notes / Spaces (todos / notas / espaços) — com uma busca compartilhada sempre visível. As mecânicas por trás delas diferem, mas para você é uma única Lixeira:

  • As notas são restauradas de volta para o seu espaço.
  • Um espaço é restaurado por inteiro — junto com toda a sua própria lixeira e histórico.

A lista de notas é do lado do servidor: a paginação e a busca por título escalam para milhares de registros. Cada linha mostra quem excluiu a nota e quando; exclusões externas são sinalizadas à parte.

Restauração

A restauração preserva a identidade da nota. Isso significa que ela mantém o mesmo identificador estável (notarium-id) e, junto com ele, os links de entrada e o histórico:

  • a nota volta para a sua pasta original, no último caminho conhecido;
  • o slug definido pelo usuário e os aliases de nomes anteriores são restaurados, de modo que os links de entrada [[Nome antigo]] voltam a ser resolvidos em vez de virarem links quebrados;
  • uma revisão de "restauração" é gravada no registro.
A restauração nunca sobrescreve uma nota ativa

Se outra nota já tiver aparecido no caminho de destino, a restauração falha com um erro e deixa o arquivo existente intacto. Resolva o conflito manualmente.

Você pode restaurar uma única nota (com o botão na sua linha) ou um lote inteiro de uma vez — pela seleção múltipla na barra inferior ou por Select all N (selecionar todos os N).

Exclusão permanente

A limpeza permanente (Delete N forever, excluir N para sempre) apaga de forma irreversível todo o histórico de uma nota e os dados a ela associados. Ela só é disparada por uma ação explícita: selecionar linhas ou Select all N — sem nada selecionado, a barra inferior não oferece a limpeza.

A limpeza é irreversível

Depois da exclusão permanente, uma nota não pode ser restaurada: todas as revisões e todo o conteúdo são apagados. A exclusão reversível pode ser desfeita; a limpeza permanente, não.

A Lixeira não tem limpeza automática agendada (após N dias) — apenas uma ação explícita do usuário.

Limites

  • A capacidade de restauração se apoia no registro de revisões. Sem o banco de metadados, o histórico sobrevive apenas enquanto o processo estiver em execução: a lixeira fica disponível somente até o próximo reinício e então desaparece — sem erro.
  • Se o corpo de uma nota excluída nunca passou pelo Notarium e não pôde ser lido no momento da exclusão, a nota ainda assim aparecerá na Lixeira, mas será marcada como não restaurável — assim você enxerga o limite de imediato, em vez de perder a nota silenciosamente.

Você pode abrir uma nota excluída pelo link dela como de costume — ela abre em modo somente leitura, sob um banner In the trash (na lixeira), com botões para restaurar ou excluir permanentemente.