# 发布说明正反例

正例是发布可追溯性的最低要求；版本、提交、演进资产、证据和负责人必须替换为本次真实发布信息。本例采用关系型存储，其他项目应记录自身适用的数据或结构演进方式。

## 正例

- 版本：`2.4.0`，制品 digest `sha256:...`，目标环境 `production-cn`
- 变更：`REQ-014` 订单幂等提交；影响 `order-api` 与客户端 3.9
- 数据库：先执行兼容性 DDL `20260715_add_idempotency_key_up.sql`；本例的逆向脚本已在生产等价数据上证明不会丢失业务数据
- 验证：验证表分别记录与本次风险相关的正常、边界和异常场景；测试报告记录 186 项通过、0 失败、2 项有明确跳过原因；代码审查无未关闭 error
- 部署：先数据库兼容变更，再 API，最后客户端；每步通过健康与冒烟后继续
- 停止/恢复触发：按本次已批准发布阈值，5xx 超过 1% 持续 5 分钟，或订单重复率高于基线 0.01%
- 已知限制：旧客户端不展示幂等冲突原因，不影响下单结果

## 反例

- 本次优化订单功能
- 测试已通过
- 按正常流程发布
- 有问题回滚

问题：没有版本、范围、证据、顺序、阈值、回滚对象或已知限制。

## 迁移到当前项目

替换版本、日期、变更、目标环境、验证记录、观察阈值和恢复对象。内容必须来自实际 diff、最新验证/审查状态和经确认的发布计划，不能复用示例结论。