数据恢复
数据恢复功能用于将备份数据还原到指定设备，支持恢复到原设备或新设备。
恢复场景
| 场景 | 说明 |
|---|---|
| 设备更换 | 将旧设备数据迁移到新设备 |
| 设备故障 | 设备损坏后恢复数据到替代设备 |
| 数据回滚 | 恢复到某个时间点的数据状态 |
| 设备重置 | 重置设备后恢复用户数据 |
恢复流程
1. 选择备份
登录厂家管理系统
→ 数据管理
→ 数据恢复
→ 选择要恢复的备份记录选择时需确认以下信息：
- 备份创建时间
- 备份类型（完整/增量）
- 备份数据量
- 备份是否在有效期内
2. 选择目标设备
1. 选择目标设备（可以是原设备或新设备）
2. 确认目标设备状态为"已激活"
3. 确认目标设备有足够存储空间3. 验证密码
1. 输入备份加密密码
2. 系统验证密码正确性
3. 密码错误将拒绝恢复操作4. 确认恢复
| 选项 | 说明 | 默认值 |
|---|---|---|
| 覆盖模式 | 是否覆盖目标设备现有数据 | 否（合并） |
| 恢复范围 | 选择要恢复的数据类型 | 全部 |
1. 选择恢复选项
2. 查看恢复预览（将恢复的数据摘要）
3. 点击"确认恢复"
4. 等待恢复完成5. 验证结果
恢复完成后，系统显示恢复结果：
✅ 笔记数据: 42条 已恢复
✅ 会话记录: 15条 已恢复
✅ 用户设置: 已恢复
✅ 密钥数据: 已恢复
✅ 联系人: 8条 已恢复恢复模式
合并模式（默认）
将备份数据与目标设备现有数据合并：
- 已存在的数据保持不变
- 仅添加缺失的数据
- 冲突数据以目标设备为准
覆盖模式
完全覆盖目标设备数据：
- 清除目标设备现有数据
- 完整恢复备份内容
- 适用于设备重置后的恢复
警告
覆盖模式会清除目标设备上的所有现有数据。建议在执行前先对目标设备创建备份。
增量恢复
增量备份的恢复需要基础完整备份：
1. 系统自动检测增量备份的依赖关系
2. 先恢复完整备份
3. 再依次应用增量备份
4. 确保数据一致性常见问题
| 问题 | 原因 | 解决方法 |
|---|---|---|
| 密码错误 | 输入了错误的备份密码 | 确认密码正确，注意大小写 |
| 备份已过期 | 超过备份有效期 | 联系管理员延长有效期 |
| 目标设备不可用 | 设备未激活或已注销 | 确认设备状态为已激活 |
| 恢复中断 | 网络问题或设备断开 | 重新执行恢复操作 |
| 数据不完整 | 增量备份缺少基础备份 | 确保完整备份未被删除 |
注意事项
- 恢复操作前建议对目标设备创建备份
- 确保备份密码正确，多次失败将锁定操作
- 恢复过程中请勿关闭浏览器或断开网络
- 大量数据恢复可能需要较长时间，请耐心等待
- 恢复完成后建议验证关键数据的完整性
附录：规范章节补全（v5.0.3.108）
为对齐项目用户文档标准结构，下列章节补齐若干未在正文中单独列出的视角。已在正文覆盖的章节在此段仅作简述并标注
见上文指引。
1. 概述
见正文「恢复场景」「恢复流程」。数据恢复模块把 数据备份 还原到原设备或新设备，支持合并 / 覆盖两种模式与增量恢复。
2. 核心特性
- 恢复到原设备 / 新设备（设备更换 / 故障 / 重置）
- 合并模式（默认，不动现有数据）/ 覆盖模式
- 增量恢复（自动按依赖先完整后增量）
- 恢复前密码验证 + 恢复后结果校验
3. 系统架构
前端（数据恢复页）→ /api/backups/{id}/restore
▼
后端（Spring Boot + JWT）→ 验证密码 → AES-256-GCM 解密
▼
写入目标设备数据（合并 / 覆盖）→ 返回逐类恢复计数4. 系统定位
厂家管理系统的设备数据还原层，与 数据备份 构成完整的容灾 / 迁移闭环。
5. 核心功能
| 步骤 | 说明 |
|---|---|
| 选择备份 | 确认时间 / 类型 / 有效期 |
| 选择目标设备 | 须已激活 + 空间足够 |
| 验证密码 | 错误拒绝；多次失败锁定 |
| 确认恢复 | 选模式 + 范围 + 预览 |
| 验证结果 | 逐类恢复计数 |
6. 技术架构
后端 Spring Boot 3.2.1 + MyBatis Plus；解密 AES-256-GCM；增量恢复按 key_backups 依赖链先完整后增量；备份管理 API（含 restore）6 接口。
7. 系统特点
- 合并模式安全（冲突以目标设备为准）
- 覆盖模式前建议先备份目标设备
- 增量恢复自动检测依赖，保证一致性
8. 应用场景
设备更换迁移、设备故障替换、数据回滚到时间点、设备重置后还原用户数据。
9. 竞品对比
| 维度 | 本模块 | 手工还原 |
|---|---|---|
| 加密恢复 | ✅ 密码验证 | ⚠️ |
| 合并 / 覆盖 | ✅ 双模式 | ❌ |
| 增量依赖处理 | ✅ 自动 | ❌ |
| 结果校验 | ✅ 逐类计数 | ❌ |
10. 配置参考
恢复模式（合并 / 覆盖）、恢复范围在确认页选择；目标设备须为「已激活」。部署见 安装部署。
11. 性能指标
恢复耗时随数据量线性增长（解密 + 写入）；增量恢复需先应用基础完整备份；过程中勿断网。
12. 测试覆盖
密码验证、AES-256-GCM 解密、合并 / 覆盖语义、增量依赖恢复顺序由后端集成测试覆盖。
13. 安全考虑
- 恢复需 AES 密码验证；多次失败锁定操作
- 覆盖模式清空目标设备数据——执行前建议先备份目标设备
- 恢复操作需管理员权限 + JWT，写
device_logs审计
14. 故障排除
见正文「常见问题」表：密码错误、备份已过期、目标设备不可用、恢复中断、增量缺基础备份。
15. 关键文件
| 资源 | 说明 |
|---|---|
key_backups 表 | 备份依赖链 / 有效期 |
/api/backups/*/restore | 恢复 REST API |
| 前端「数据恢复」页 | 5 步恢复向导 |
16. 使用示例
见正文「恢复流程」5 步（选备份 → 选设备 → 验密码 → 确认 → 验结果）。