迁移
切换部署方式时规划身份、业务数据、文件、订阅和发布流程。
已上线产品切换模式是一项迁移工程。安全顺序是：盘点 → 身份映射 → 数据复制 → 文件复制 → 权益对账 → 分阶段发布客户端。
迁移检查清单
- 冻结源 Schema，并导出用户、Provider identity、业务 Row、文件和订阅证据。
- 建立源 User ID 到 Better Auth User ID 的持久映射，不要假设 ID 格式不变。
- 使用目标 Session 身份重新建立 Profile 与业务数据所有权。
- 复制文件并保留 MIME 与所有权 metadata，验证后再改写持久化 URL。
- 在开放购买入口前，为每个目标用户对账并建立唯一权威订阅快照。
- 在宿主配置可信 Origin、OAuth audience、Webhook Secret、存储和推送 Provider。
- 发布一个配置明确、无回退的 Unified Staging 构建，并运行共享冒烟测试。
- 在可观测性和回滚窗口保护下逐步发布；确认新路径后再撤销旧 Session。
身份与权益映射完成前，绝不能只把现有客户端指向新 Base URL。网络请求成功并不代表数据绑定到了正确账户。
反向迁移遵循相同原则：建立独立身份与存储、复制数据，最后修改已部署客户端的 Backend 预设。