Nota de programação

Armazenamento explícito nas edições de navegador e local

Atualizado 1 de setembro de 2026 Traduzido Au Jour Le Jour Alteração verificada 5b5dbb5

Nota técnica de .

O Au Jour Le Jour indica agora onde cada registo é guardado, quais as funcionalidades disponíveis e como os dados passam entre as edições de navegador e local.

Nesta página

O que mudou

Um contrato comum de capacidades distingue o armazenamento no navegador do SQLite local, bem como o suporte para assistente, partilha, uso offline, instalação, cópias de segurança e diagnósticos.

Os indicadores de execução mostram a conectividade, o último estado guardado, o estado da cópia de segurança e a distinção entre transferência portátil e sincronização automática.

A edição de navegador acompanha as alterações de armazenamento provenientes de outros separadores, enquanto as verificações Janitor testam o contrato de capacidades e a transferência de cópias de segurança entre plataformas.

Dois modelos de armazenamento, um contrato explícito

A edição de navegador mantém o registo no armazenamento do navegador no dispositivo atual. A edição local usa SQLite e continua disponível sem um serviço alojado. A interface explicita essa diferença em vez de apresentar as duas edições como se tivessem a mesma durabilidade.

As capacidades são declaradas, não deduzidas: localização dos dados, funcionamento offline, disponibilidade do assistente, partilha, cópias de segurança e diagnósticos têm, cada um, um estado de execução explícito. Este contrato impede a interface de prometer uma função que a edição atual não pode fornecer.

Portabilidade não é sincronização

A exportação e a importação JSON oferecem um meio de transferência legível. A partilha só de leitura tem um contrato de retransmissão separado, com controlos próprios de privacidade, expiração e estado de publicação. Nenhum dos mecanismos é descrito como sincronização automática entre dispositivos.

Esta distinção importa na recuperação. Uma cópia portátil pode reconstruir um registo e uma vista partilhada pode expor um instantâneo selecionado; nenhum deles deve tornar-se silenciosamente a fonte de referência.

A falha faz parte da interface

Os indicadores de execução mostram se a aplicação está ligada, quando guardou pela última vez e se existe uma cópia recuperável. A edição local também fornece diagnósticos e verificações de integridade, sem tratar uma apresentação bem-sucedida como prova de que o registo está saudável.

Os testes Janitor exercitam as declarações de capacidades, as alterações de armazenamento entre separadores, a transferência de cópias, o comportamento do serviço de retransmissão e os serviços indisponíveis. O modo degradado é testado como um estado normal de funcionamento, não deixado como exceção sem documentação.

Nota de engenharia

A localização dos dados faz parte do contrato do produto. Uma aplicação local-first nunca deve deixar dúvidas sobre se os dados estão num navegador, em SQLite, numa vista partilhada ou sincronizados noutro local.

Proveniência

Esta nota baseia-se no código verificado do projeto no commit 5b5dbb5. Documenta uma alteração de software, não uma atualização pessoal.