Files
order-notification-automation/docs/backup-restore-guide.md
T

26 lines
2.0 KiB
Markdown

# 本机备份与恢复
备份包含应用状态、实际PDF、Windows当前用户保护的加密键及SHA256文件清单。历史默认永久保留;归档会话或退役异常不会删除原业务证据。备份含敏感信息,应保存在受控目录。
在项目目录运行以下命令。先停止本机测试服务;备份命令会拒绝仍被服务占用的状态目录。
```powershell
npm run service:stop
npm run backup -- create --destination C:\OrderBackups\snapshot-20261021
npm run backup -- verify --source C:\OrderBackups\snapshot-20261021
```
目标备份目录必须尚不存在。默认读取当前应用状态与项目输出目录;隔离测试可显式指定`--state <state-dir> --output <pdf-dir>`。校验会检查文件大小、SHA256、目录清单、链接和路径边界,缺失、增添或修改文件均拒绝。SHA256是完整性校验,不能代替可信来源确认。
恢复只允许新的空目录,不覆盖正在使用的状态:
```powershell
npm run backup -- restore --source C:\OrderBackups\snapshot-20261021 --destination C:\OrderRecovery\isolated-state
```
恢复会实际验证DPAPI、为新目录注册对应的受保护键,并把本地PDF引用迁入新状态目录的`restored-pdf`;原目录和原键不改。`restore-config.json`记录迁移摘要,应用在未显式配置输出目录时使用此隔离输出。现有不同密钥、不可解密、路径越界及非空目标都拒绝。此版本按当前Windows用户设计,不保证跨用户或跨机器可解密。
恢复命令本身不启动服务、不启用处理或发信。隔离启动需要明确指定新状态目录,使用空闲端口,并确认原配置中的两个业务开关暂停。不要用服务控制命令误启动默认状态来代替恢复演练。恢复验证通过后,再单独安排实际切换。
系统设置的“系统健康”提供数据容量、永久保留说明和PDF历史导出。导出包含安全业务摘要,不含本地路径、密码或原始表单。它不能代替完整备份。