一、为什么需要三段语义
页面改版有两个诉求互相冲突:
- 运营希望随时改,活动节点前改完就上线
- 技术希望改坏能退,出问题不用手工复原
只做「保存即生效」,运营的每次试错都直接落到线上;只做「改完发版」,运营就被研发排期拖住。
草稿 / 发布 / 回滚三段分别解决:试错不落线上、确认后才生效、出错能退回。
二、数据层怎么落地
装修模板以 JSON 存储,一条模板有三类数据:
| 数据 | 说明 | 是否会生效 |
|---|---|---|
| 草稿态 | 运营正在编辑的内容 | 否 |
| 发布态 | 当前线上生效的内容 | 是 |
| 历史版本 | 每次发布生成一份快照 | 否,可回滚 |
关键点:草稿与发布是两份独立数据,不是同一份数据的两个标记位。如果用标记位,发布时就要原地改数据,一旦改坏,回滚只能靠另外的备份。
三、组件白名单
白名单限制「可被拖入页面的组件集合」。它解决的不是安全问题,是可维护性问题:
- 没有白名单,运营可能拼出 20 种变体的轮播,每种都要单独适配
- 有白名单,可用区块收敛在固定集合内,样式与响应式只需覆盖这些
白名单在代码里是可配置的列表,新增一个组件意味着要同步做样式、响应式与深色模式适配,因此增组件要走评审而不是随手加。
四、发布流程
- 运营在后台编辑草稿
- 预览(看到的是草稿态,不影响线上)
- 确认发布 → 当前发布态存入历史快照,草稿态成为新的发布态
- 发布动作记入操作日志(谁、什么时候、发布了哪张模板)
五、回滚流程
- 在历史版本里选一份
- 回滚 → 该版本成为新的发布态
- 注意:回滚不会删除当前版本,当前版本会先进历史快照,所以「回滚的回滚」是可能的
六、几个容易做错的点
发布不能跳过校验。模板 JSON 结构错误时发布成功但页面崩,这类问题要在发布前校验,而不是靠运营肉眼检查。
回滚粒度是整张模板,不是单个区块。想只改一个区块,应该走草稿 + 发布,而不是回滚。
素材要一起管。模板引用的图片素材如果被删除,模板就会渲染失败。素材必须有引用计数,被引用的素材不允许直接删。
七、验收问句
上线前用这四个问题自查:
- 改坏了能不能一键退回上一版?
- 预览看到的和发布后看到的是不是同一份数据?
- 运营能拼出的区块是否都在白名单内?
- 模板引用的素材有没有删除保护?