05 · 需求文档 · 配套篇

老链路兼容与灰度回退

重构的安全边界——老数据不丢、老行为不漂移、随时能退回。

类型
兼容性需求说明 · 7 章
我的角色
方案设计 · 版本拆分 · 线上验收
三条底线
只读映射 / 等价翻译 / 置灰即开关
关联
主篇《批量混剪功能重构 · PRD》

三条底线

  • 老数据 · 只读映射。老表零改动,只产生新记录。改坏了没有后悔药,所以索性不动。
  • 老行为 · 等价翻译。出片参数只允许偏差 0。不是「差不多」,是老用户拿到的结果必须和昨天一模一样。
  • 老入口 · 置灰即开关。代码与路由全程保留,置灰状态本身就是回退开关——要退回去,改一个状态位。

映射怎么定

老脚本与新脚本的结构并不一致(两代结构并存、台词多句、画面参考描述独立存放)。规则是:一个段落/镜头 → 一个新镜头组,段落数 = 镜头组数;段落台词全量进入该组口播池,首句居首,不截断、不拼接——这样「第一条口播」仍然是用户原来写的第一句。

判断兼容做得好不好只有一条标准:老用户第二天早上打开,什么都变了,但什么都没变。

改造顺序与依赖铁律

第四章把顺序写成铁律,因为兼容里最危险的从来不是某一步做错,而是两步做反了顺序:先上新的再翻译老的,中间那段时间谁都说不清线上跑的是哪套逻辑。

实践中暴露的判定分叉

第六章记录那些文档写的时候没想到、上线才撞见的判定分叉——比如同一个老作品在两套判定下会落到不同分组。这类东西只能靠真跑一遍才能发现,所以我把它单列一章,而不是悄悄改掉。

关于脱敏

基于真实项目脱敏重写:产品名与场景为虚构,兼容口径、改造顺序、回退判定与回归基线均来自真实交付。可独立阅读,不依赖主篇。

0老表的改动量
0老行为允许的偏差
3条不可退让的底线
7章 · 含回归基线

原件陈列柜

以下为交付原件,未做任何视觉改造,保留原始排版以便核验。

打开原件 ↗ 下载 HTML HTML · 7 章 · 单文件
原件 · 站内预览
下一件 · 06

促销模拟器