55-决策与变更记录 Template v1.0 | 第4章 决策流程与状态机

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

第4章 决策流程与状态机

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

• 建立从提出→评审→裁决→实施→验证→归档/回滚的受控状态机；所有转移通过**门禁（gate）**驱动，门禁由可量化指标、阈值与观察窗口构成。
• 适用于跨卷理论口径、参数/数据契约、方法流程与实现绑定等一切需要可追溯与可回放的决策与变更。

II. 状态定义（强制）

• Draft：记录单已创建，内容未达评审门槛。
• Review：多角色并行评审，收集一致性/风险/影响意见。
• Approved：裁决完成，明确范围、例外与退出条件。
• Implemented：实施进行或完成，提交验证材料与回归结果。
• Verified：验证通过，达到发布/切换标准。
• Archived：归档完成，导出审计工件；禁止再编辑，仅允许引用。
• RolledBack：受控回退分支，完成恢复并产出复原报告。

III. 事件与触发（强制）

• Propose：进入 Draft；由 Requester 触发。
• RequestReview：进入 Review；满足完整性门后触发。
• Approve：进入 Approved；由 Approver/Owner 触发，满足一致性/风险门。
• Implement：进入 Implemented；资源锁定、计划批准后触发。
• Verify：进入 Verified；验证与回归通过线达到。
• Archive：进入 Archived；审计完成、导出工件就绪。
• Rollback：从 Implemented/Verified 进入 RolledBack；触发器达到或人工裁定。

IV. 状态机（ASCII 概览）

Draft ──RequestReview──▶ Review ──Approve──▶ Approved ──Implement──▶ Implemented

▲ │ │ │

│ └──────────Reject/Revise◀────────────────┘ │

│ │

└─────────────────────────────────────◀─────────────────────────────────────┘

Implemented ──Verify▶ Verified ──Archive▶ Archived

│ │

└──Rollback(trigger)▶ RolledBack ──(post-check)──▶ Draft/Review/Approved

V. 进入/退出条件与门禁（强制，表格可直接拷贝）

VI. 超时与升级策略（强制）

• Review 超时：review_sla 到时自动升级给 Approver/Owner，可触发强制裁定或退回 Draft。
• Implemented 超时：implement_sla 达到且关键里程碑未完成时，触发风险复核，必要时进入 Rollback。
• Verified 超时：archive_sla 达到未归档，自动生成临时发行记录并通知 Auditor 收敛。

VII. 并行评审与冲突处理（强制）

• 并行模型：Reviewer 可多名；评审结果聚合规则为强否决制 + 需最少 N 个同意（N 由卷或项目配置）。
• 冲突解决：若 consistency_ok=false，则自动回退 Draft 并生成差异清单；若仅为范围冲突，允许在 Review 内二轮会签。

VIII. 回滚分支与复原闭环（强制）

1. 触发器范式：gate_accuracy<阈值@窗口、gate_latency>阈值@窗口、incident_level≥X、data_drift>阈值。
2. 回滚步骤（最小）：
   • 暂停新流量或切回旧版本；
   • 恢复参数/口径/数据契约的先前快照；
   • 运行复原验证与复原回归；
   • 产出 RollbackReport 与再实施条件（门禁清单）。
3. 复原完成后，可根据复盘结果将 DR 返回 Draft/Review/Approved 任一状态继续闭环。

IX. 审计轨与导出（强制）

• 审计要素：所有状态转移的时间戳、操作者、门禁结果、证据引用与工件哈希。
• 导出件：yaml/json/pdf；PDF 含签署页与门禁断言；YAML/JSON 用于自动审计与重放。

X. 机读状态机 Schema（YAML；JSON 等价，直接复用）

sign_chain:

states: ["Draft","Review","Approved","Implemented","Verified","Archived","RolledBack"]

transitions:

- { from: "Draft", to: "Review",

gate: ["completeness_check","see_refs_present"] }

- { from: "Review", to: "Approved",

gate: ["consistency_ok","risk_accepted","impact_covered"] }

- { from: "Approved", to: "Implemented",

gate: ["plan_ready","resources_locked","rollback_plan_ready"] }

- { from: "Implemented", to: "Verified",

gate: ["regression_ok","gate_accuracy>=0.99@7d","gate_latency<=2h@7d"] }

- { from: "Verified", to: "Archived",

gate: ["audit_ok","export_artifacts_present"] }

- { from: "Implemented", to: "RolledBack",

gate: ["trigger_threshold","incident_level>=2","rollback_plan_ready"] }

- { from: "Verified", to: "RolledBack",

gate: ["slo_breach","data_drift>0.03","rollback_plan_ready"] }

audit_trail:

required: ["timestamp","actor","from","to","gate","evidence_hash","notes"]

XI. 门禁（gate）规范与命名（强制）

• 命名口径：gate_<metric><comparator><threshold>@<window>，例如：gate_accuracy>=0.99@7d、gate_latency<=2h@7d。
• 证据口径：每条 gate 均需给出数据来源、统计方法、可信区间/置信度与脚本定位（script@commit）。
• 失败策略：hard（禁止前进）、soft（提示但允许前进，需 Approver 署名）。

XII. 角色与责任在状态机中的映射（强制）

XIII. 示例配置片段（可直接拷贝）

gates:

completeness_check: true

see_refs_present: true

consistency_ok: true

risk_accepted: true

impact_covered: ["performance","cost","time","risk","dependencies"]

plan_ready: true

resources_locked: true

regression_ok: { suite: ["cmb_set_v3","arrive_time_check.py@a1b2c3"] }

gate_accuracy: ">=0.99@7d"

gate_latency: "<=2h@7d"

audit_ok: true

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

triggers:

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

data_drift: ">0.03@14d"

slo_breach:

availability: "<99.0%@24h"

XIV. 引用与交叉引用体例（强制）

1. 文内固定写法：“见《<卷名> vX.Y》Ch.x S/P/M/I…”；优先锚点而非整卷。
2. 与记录单对齐：references.see 中提供机读清单（示例）
   • "EFT.WP.Core.Terms v1.0:P10-3"
   • "EFT.WP.Core.Equations v1.1:S20-1"
   • "EFT.WP.Core.Metrology v1.0:check_dim"
   • "EFT.WP.Core.DataSpec v1.0:I30-2"