xiaobaijizhang/docs/BACKUP_RESTORE.md

本地备份与恢复模块

目的

在数据库加密、版本升级和更复杂功能接入前，先保证账本具备可验证、可回退的恢复能力。

备份流程

1. 使用 SQLite Online Backup API 获取一致性快照，不直接复制正在使用的数据库文件。
2. 对新备份执行 PRAGMA integrity_check。
3. 检查迁移表、流水表和导入表等必要结构。
4. 计算 SHA-256，并在同目录写入独立校验文件。
5. 将数据库文件同步到磁盘后才向界面报告成功。

备份位于应用数据目录下的 backups 子目录。当前版本暂不提供云端上传或外部介质复制。

恢复保护

• 只允许恢复备份目录内、文件名合法的 .sqlite3 文件。
• 恢复前重新核对 SHA-256 和数据库结构；不一致立即拒绝。
• 覆盖当前账本前，自动创建 pre-restore 安全快照。
• 使用 SQLite Online Backup API 写回当前账本。
• 恢复后自动执行数据库迁移；若恢复或迁移失败，尝试用安全快照回退。

当前边界

• 本地备份与主数据库在同一块磁盘，能防误操作，不能替代异地备份。
• 备份目前仍是未加密 SQLite 文件，不应复制到不可信位置。
• 下一阶段的数据加密迁移将依赖本模块提供回退保障。