文档
开发文档

迁移与切换

前端、产品账号钱包与历史客户的迁移边界和核对顺序

全局顺序见路线图。平台开发中可以提前做迁移审计和隔离演练,不提前删掉仍在使用的产品账号/钱包。

Console / Admin

迁入 React 前端 → 完成旧到新接口映射 → 平台会话/权限改接 → 逐页真实回读 → 去除 BFF、旧会话与 Core/Contracts 构建依赖 → 平台嵌入发布 → 入口切换 → 原仓库归档。

记录来源提交与保留内容,先留可回退快照。迁移目录不等于接口完成;原仓库归档前必须证明无运行依赖。

Studio 接入

平台阶段 2 首发通过后,在阶段 3 映射旧用户到平台 ID、迁移或关联账号、核对余额与价格、迁移 Key/会话策略和未完成任务,再把模型与非模型消费接到平台。用户/钱包主写入口切换必须有明确时间点,不能长期双写余额。

用户关联不能只按用户提交的邮箱自动合并;依据已验证身份与人工核对规则建立映射,冲突进入待处理。冻结、待结算、退款、赠送和历史价格分别核对,不能仅复制一个余额数值。旧 Key 和会话是否失效/重新签发须有迁移政策与通知内容,不能假设所有旧凭据自动兼容。

建议先隔离影子核对、再小范围切换;只有平台接入与恢复验收后才移除 Studio 自有账号、钱包、渠道和路由。产品任务/素材不迁入平台,只保存需要的用户与操作关联。

Drama / Commerce

阶段 4 合入 oceanway-studio 三子站应用,分别取得产品作用域角色与服务凭据。共用工程不等于共用来源标签;三产品任务与消费必须可区分。Drama 业务以标准 1.7.0为准,后端按 Next.js 重写,不把旧 Node 服务直接变成平台模块。

sub2api 零售客户

阶段 5 单独制定购买力换算、旧价保护模型/期限、赠送和套餐规则。建立迁移批次、旧账户→平台账户映射、来源余额/单位、冻结及未结算事实、换算快照、实际入账与差异处理。

同一批次重跑不能重复充值。迁移前后按账户核对金额与价格待遇,小批验证通过再扩大。uumi 现有模型对接客户继续原业务,不加入此迁移。

共通完成条件

身份映射无冲突、余额/冻结/流水可解释、未完成任务可恢复、原凭据政策明确、入口切换有证据、重复迁移受唯一批次保护。回退时保留切换后发生的支付/消费事实,不能覆盖回旧导出余额。

当前仅定义要求,具体批次工具、账户数据和切换操作均未执行;需要在对应阶段形成真实执行方案与验收。

On this page