xiaobaifupan/next/docs/final/cutover-checklist.md

NAS切换清单

此清单是最终人工确认前的准备资产，不授权当前任务停止或替换正式容器。

切换前阻断项

• NAS或预发布机实际执行docker compose config与docker compose build。
• 验证容器以非root、只读根文件系统启动，/app/data可写，健康检查稳定。
• 验证容器重启后账号、行情、自选、复盘、会员、模型、问天和选股记录不丢失。
• 在NAS受控目录完成数据库、环境密钥和私有Skill整套备份，并做一次独立恢复。
• 保持APP_PUBLISH_PORT=8876启动新容器，完成真实数据的日间/夜间、1080P/4K/390px抽验。
• 记录实际APP_IMAGE标签，确认该标签可在不重新构建的情况下用于回退演练。
• 用户明确确认最终切换窗口。

切换步骤

1. 记录旧镜像、容器配置、端口和旧数据库校验和，创建最终一致性备份。
2. 暂停旧系统写入，不删除旧容器和数据卷。
3. 对最终只读旧库运行tools.legacy_migration到全新目标，核对报告和外键完整性。
4. 用固定APP_ENCRYPTION_KEY和新数据卷启动新容器临时端口。
5. 抽验真实账号登录、共享快照、私有记录、会员/模型、问天、选股和LLM一次成功调用。
6. 切换反向代理或宿主端口；观察健康、5xx、数据库写入和后台任务至少一个完整刷新周期。
7. 只有观察期通过后才归档旧容器；旧数据库和旧镜像按回退周期保留。

回退条件与动作

出现登录失败、私有数据错绑、数据库完整性失败、关键行情不可读、后台任务持续失败或无法恢复的5xx时立即回退。

1. 停止新容器写入并保存故障数据库副本和日志。
2. 将流量切回旧容器；不要对新数据库自动执行migration降级。
3. 若需用旧镜像读取新时期数据，只能恢复升级前与旧镜像匹配的整套备份。
4. 修复后重新从最新只读旧库执行迁移，不在失败目标库上手工改表。

当前状态

代码、真实旧库副本迁移、备份恢复、SPA生产形态、性能、安全和全量浏览器回归均已完成。 本机没有Docker，以上6个切换前阻断项仍需在NAS/预发布环境执行；正式容器保持不变。