rebuild(stage-14): deliver migration and recovery tooling

2026-07-30 08:29:37 +08:00
parent 9eb7b548f3
commit fa7a8dde06
17 changed files with 1397 additions and 3 deletions
@@ -46,11 +46,24 @@ npm.cmd run dev

 回退只允许显式执行；代码回退不会自动回退数据库。

+旧库迁移、生产部署与恢复不进入正常运行时代码。迁移只读打开旧库并写入独立目标：
+
+```powershell
+$env:APP_ENCRYPTION_KEY='<现有固定密钥>'
+.\.venv\Scripts\python.exe -m tools.legacy_migration `
+  --source ..\data\review.db `
+  --target data\xiaobai.db `
+  --report data\migration-report.json
+```
+
+一致性备份、校验恢复和 Docker 部署见 [docs/deployment.md](docs/deployment.md)。正式 NAS
+容器不会被脚本自动替换，切换必须在最终验收后单独人工确认。
+
 ## 最小质量门禁

 ```powershell
 cd next
-.\.venv\Scripts\python.exe -m ruff check backend tests
+.\.venv\Scripts\python.exe -m ruff check backend tools tests
 .\.venv\Scripts\python.exe -m pytest
 cd frontend
 npm.cmd run check