55-决策与变更记录 Template v1.0 | 第10章 发布策略与版本关系

目录 ／ 文档-技术白皮书 ／ 55-决策与变更记录 Template v1.0

第10章 发布策略与版本关系

I. 章节目标与范围（强制）

• 定义发布策略（通道/节奏/门禁/通告）与版本关系（主干/分支/兼容线/弃用线），保证版本演进可追溯、可审计、可回退。
• 与第4章状态机、第7章回滚闭环、第8章签署、第9章实施与验证对齐；引用遵循“卷名 + 版本 + 锚点（S/P/M/I）”。

II. 版本模型与命名（强制）

1. 版本线：v1.* 稳定线（公开引用）、v0.* 草案线（需标注“草案/非承诺”）、v1.(x+1) 次主版本线（兼容性窗口）。
2. 命名口径：<artifact>@<semver>[@sha256:HASH]；发布标签：release-<YYYYMMDD>-<semver>。
3. 兼容性注记：
   • 向后兼容（Backward Compatible, BC）：无需消费者改动；
   • 条件兼容（Conditionally BC, cBC）：需在窗口期内完成适配；
   • 破坏性变更（Breaking）：需显式通告与回退预案。

III. 渠道与节奏（强制）

• 发布渠道：alpha（内部验证）、beta（受控外部）、stable（公开）；可选 lts（长期维护）。
• 灰度节奏：canary → partial → full，以比例/地域/租户为维度推进。
• 冻结窗口：发布冻结期内仅允许热修复（Hotfix），需 Approver/Owner 署名。

IV. 发布门禁（gates）与证据（强制）

• 命名：gate_<metric><comparator><threshold>@<window>；示例：
  gate_accuracy>=0.99@7d、compat_rate>=0.995@replay、gate_latency<=2h@7d、incident_level<2@24h。
• 证据：验证报告、回归套件结果、覆盖率、工件哈希、审计轨；硬门禁未过不得进入下一通道。

V. 版本关系与兼容策略（强制）

1. 关系图谱：v1.x 主干 ←（回合并） Hotfix 分支；v1.(x+1) 从 v1.x 切出；v0.* 不得直接并入稳定线。
2. 兼容策略：
   • API/Schema：提供 version_range 与 fallback；Breaking 需双栈（old/new）并行 ≥ 一个观察窗口。
   • 数据契约：导出字段增加为 BC，删除/重命名为 Breaking。
   • 运行口径：变更 S/P/M/I 锚点时，需在发布说明中列出“受影响锚点表”。

VI. 通告与生命周期（强制）

• 通告级别：Advisory（不影响兼容）、Notice（cBC）、Breaking（必须动作）。
• 生命周期：Active → Maintenance → Deprecated → EOL；每阶段给出支持政策、安全修复与最后使用日期。
• 退出与废止：达成退出条件时，进入 Deprecated 并发布三次滚动通告（T-60/T-30/T-7）。

VII. 回退策略与保底线（强制）

• 保底线：任何 stable 升级都需可在同一窗口内回退至上一个 stable 标签；Hotfix 需可原地撤销。
• 触发器：gate_accuracy<0.98@7d、compat_rate<0.99@replay、incident_level≥2、data_drift>0.03@14d。
• 回退执行：遵循第7章流程，产出 RollbackReport 与再发布条件。

VIII. 路径/公式一致性（强制）

1. 若发布涉及到达时判据，统一使用：
   • 常量外提：T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
   • 一般口径：T_arr = ( ∫ ( n_eff / c_ref ) d ell )
2. 文中出现 T_arr 时，同段或紧邻段落声明路径 gamma(ell) 与测度 d ell；量纲校核需通过 check_dim。
3. 禁混：T_fil≠T_trans，n≠n_eff，c≠c_ref；公式/符号/定义禁用中文。

IX. 人读发布清单模板（可直接拷贝）

• 版本与渠道：semver / alpha|beta|stable|lts
• 范围与影响面：模块/接口/数据契约/地域/批次
• 门禁与结果：硬/软门禁列表与证据定位
• 兼容与迁移：version_range、fallback、迁移步骤
• 回滚预案：触发器/脚本/恢复标准
• 通告与时间线：受众/渠道/频次/冻结窗口
• 审计与工件：导出件（yaml/json/pdf）、哈希、锚点表

X. 机读发布与版本关系 Schema（YAML；JSON 等价，可直接拷贝）

release:

id: "REL-2025-1001"

semver: "1.4.0"

channel: "stable" # alpha/beta/stable/lts

date: "2025-10-12"

scope:

modules: ["pipeline.arrival_time"]

contracts: ["api.metrics.v2","dataspec.arrival_time"]

regions: ["EU","APAC"]

gates:

hard: ["gate_accuracy>=0.99@7d","compat_rate>=0.995@replay"]

soft: ["unit_cost<=1.0x@30d"]

evidence:

reports: ["verification@sha256:…","replay@sha256:…"]

coverage: { functional: "0.96", path: "0.92", data: "0.91" }

compatibility:

api_schema:

version_range: "[2.0,3.0)"

fallback: "adapter_v1_enabled"

breaking: false

dataspec:

change_type: "additive" # additive/rename/remove

breaking: false

lifecycle:

phase: "Active" # Active/Maintenance/Deprecated/EOL

deprecates: ["1.2.x"]

eol_at: "2026-04-01"

rollback:

baseline: "release-20250930-1.3.2"

triggers: ["gate_accuracy<0.98@7d","incident_level>=2"]

playbook: "RB-Playbook:v2"

communication:

audiences: ["internal","partners","public"]

channels: ["status_page","mailing_list"]

cadence: ["T0","T+24h","Weekly"]

audit:

artifacts: ["yaml","json","pdf"]

hashes: ["sha256:…","sha256:…"]

anchors:

- "EFT.WP.Core.Equations v1.1:S20-1"

- "EFT.WP.Core.Metrology v1.0:check_dim"

version_graph:

stable_line: ["1.2.0","1.3.2","1.4.0"]

lts: ["1.3.x"]

draft_line: ["0.9.5","0.9.6"]

hotfix_branches:

- { from: "1.4.0", to: "1.4.1", reason: "security" }

policy:

bc: "no consumer change required"

cbc: "adapter/fallback within window"

break: "dual-stack + notice T-60/T-30/T-7"

XI. 人读 × 机读对位（强制）

XII. 最小填写示例（可直接拷贝）

release:

id: "REL-2025-1015"

semver: "1.4.1"

channel: "beta"

date: "2025-10-15"

gates: { hard:["gate_accuracy>=0.99@7d"] }

rollback: { baseline:"release-20250930-1.3.2", triggers:["gate_accuracy<0.98@7d"] }

communication: { audiences:["partners"], channels:["mailing_list"], cadence:["T0","T+24h"] }

audit: { artifacts:["yaml","json","pdf"], hashes:["sha256:…"] }

version_graph:

stable_line: ["1.3.2","1.4.0"]

XIII. 通过线与发布完成（强制）

• 完成判据：所有硬门禁通过、兼容/迁移按计划完成、通告按节奏发布、审计包入库。
• 收口动作：打 release-<date>-<semver> 标签，冻结变更；更新版本关系图与弃用时间线。