Repository navigation
feat(settings): backup criptografado e sincronização via Nextcloud - #18
Merged
Merged
Conversation
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
…heme Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
…loading feedback Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
vitormattos
marked this pull request as ready for review
November 19, 2026 20:11
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problema
As preferências e conexões do Automatic Kimai permanecem no armazenamento local de cada instalação. Configurar um segundo computador exige repetir a definição de fontes, perfil de trabalho e integrações, sem um mecanismo de recuperação seguro.
Solução
Adiciona Preferências → Backup e sincronização como recurso desativado por padrão. Depois de autorizar sua própria conta Nextcloud, a pessoa configura uma senha de recuperação independente e decide se deseja incluir tokens de integrações no backup.
O aplicativo mantém um arquivo cifrado no Nextcloud Files, via WebDAV, e oferece restauração em outra instalação autenticada na mesma conta. A chave é derivada por Argon2id, e o conteúdo é protegido com XChaCha20-Poly1305 antes do upload; a senha de recuperação não é armazenada. A chave em cache de cada instalação é protegida pela chave local da aplicação.
Comportamento entre dispositivos
If-MatcheIf-None-Match.Limites de segurança
Não sincroniza a sessão MTProto do Telegram, autorizações do Nextcloud, chaves locais, bancos SQLite, histórico de atividade, registros de horas ou filas de revisão. A sessão Telegram requer autenticação independente em cada computador. Os grupos autorizados para leitura continuam sujeitos à decisão local. Credenciais Kimai e GitHub só são incluídas mediante consentimento; permissões de publicação automática no Kimai não são restauradas.
Nenhuma credencial ou dado pessoal integra o código, os testes ou os materiais de revisão. O PR não habilita sincronismo em contas reais e não publica arquivos de configuração privados.
Pontos de revisão
SettingsSnapshote preservação de sessões locais.Validação e limite atual
Testes automatizados com transporte WebDAV simulado cobrem dois dispositivos, restauração, autenticação incompatível, senha incorreta, alteração concorrente, token rotacionado e preservação da sessão Telegram. A suíte completa e a renderização da tela em navegador local foram verificadas. A interoperabilidade com um servidor Nextcloud real e o pacote desktop ainda precisam de homologação antes do merge.
Documentação do usuário e do desenho técnico:
docs/SETTINGS_SYNC.md.