55-决策与变更记录 Template v1.0 | 第3章 记录单结构（人读 + 机读）

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

第3章 记录单结构（人读 + 机读）

I. 章节目标与边界（强制）

• 以同一“记录单（Decision Record, DR）”同时满足人读与机读两类消费：人读用于裁决、沟通与归档；机读用于校核、检索、统计与审计导出。
• 本章给出字段清单、取值约束、最小必填、状态机与门禁（gate）对齐、示例样稿与导出格式（YAML/JSON 等价）。

II. 人读结构（强制，固定段落顺序）

• 封面与摘要：DR 编号、标题、状态、提出者与时间、摘要。
• 问题/动因：场景、触发条件、边界与非目标。
• 候选方案与证据：≥2 个可比方案，假设/约束、证据清单与来源。
• 影响评估：对象 × 维度（性能/成本/时间/风险/依赖），优先级与范围。
• 决策与不做清单：裁定、覆盖范围、例外条款、退出条件。
• 回滚设计：监控指标与阈值、触发条件、回滚步骤、恢复判据。
• 实施与验证：里程碑、资源、验证脚本与基准、通过线（gates）。
• 引用与附注：按“卷名 + 版本 + 锚点（S/P/M/I）”列出；机读 see 与人读一致。

III. 机读结构（强制，Schema 与最小必填）

• 标识与元信息（必填）：id，title，status，requester，created_at。
• 裁定相关（至少其一必填）：options，decision。
• 校核相关（建议必填）：impact，verification，rollback，references.see。
• 状态机与门禁（自动/人工兼容）：sign_chain.states，sign_chain.transitions。

IV. 字段清单与取值约束（可直接拷贝）

V. 机读 Schema（YAML；JSON 等价）

decision_record:

id: "DR-2025-0001"

title: ""

status: "Draft" # Draft/Review/Approved/Implemented/Verified/Archived/RolledBack

requester: { name: "", role: "Requester" }

approvers: [{ name: "", role: "Approver" }]

created_at: "YYYY-MM-DD"

effective_at: "YYYY-MM-DD"

scope: ["卷/模块/工件"]

motive: "问题与动因（结构化段落）"

options:

- name: "方案A"

assumptions: []

pros: []

cons: []

- name: "方案B"

assumptions: []

pros: []

cons: []

decision: "裁定与不做清单（结构化段落）"

rollback:

triggers: ["监控指标@阈值@观察窗口"]

steps: ["回滚步骤1","回滚步骤2"]

impact:

dimensions: ["性能","成本","时间","风险","依赖"]

dependencies: ["EFT.WP.Core.Equations v1.1:S20-1","EFT.WP.Core.Metrology v1.0:check_dim"]

verification:

gates: ["gate_latency<…","gate_accuracy>…"]

regression_suite: ["dataset@version","script@commit"]

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"

export:

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

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: ["risk_accepted","consistency_ok"] }

- { from: "Approved", to: "Implemented", gate: ["plan_ready","resources_locked"] }

- { from: "Implemented", to: "Verified", gate: ["verification_pass","regression_ok"] }

- { from: "Verified", to: "Archived", gate: ["audit_ok","export_artifacts"] }

- { from: "Implemented", to: "RolledBack", gate: ["trigger_threshold","rollback_plan_ready"] }

VI. 人读 × 机读对位（映射表，强制）

VII. 最小必填示例（可直接拷贝）

decision_record:

id: "DR-2025-0123"

title: "统一 T_arr 口径至一般形式"

status: "Review"

requester: { name: "Alice Zhang", role: "Requester" }

created_at: "2025-09-27"

motive: "跨卷到达时表达不一致影响验证复现，需统一口径。"

options:

- name: "A-常量外提"

assumptions: ["c_ref 为段内常量"]

pros: ["形式简洁"]

cons: ["对 c_ref 空间漂移敏感"]

- name: "B-一般形式"

assumptions: []

pros: ["适配空间变 c_ref 与 n_eff"]

cons: ["计算与叙述复杂度略高"]

decision: "采用一般形式：T_arr = ( ∫ ( n_eff / c_ref ) d ell )；对需常量外提的场景以例外条款记录。"

impact:

dimensions: ["性能","风险","依赖"]

dependencies: ["EFT.WP.Core.Equations v1.1:S20-1","EFT.WP.Core.Metrology v1.0:check_dim"]

rollback:

triggers: ["gate_accuracy<0.98@7d"],

steps: ["恢复 A-常量外提表达","同步更新导出模版"]

verification:

gates: ["gate_accuracy>=0.99@CMB-Set","gate_latency<=2h@pipeline"]

regression_suite: ["cmb_set_v3","arrive_time_check.py@a1b2c3"]

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"

VIII. 字段校验规则（正则/枚举/一致性，强制）

• 编号：^DR-[0-9]{4}-[0-9]{4}$。
• 状态：status ∈ {Draft,Review,Approved,Implemented,Verified,Archived,RolledBack}。
• 引用：references.see[*] = "^EFT\.WP\.[\w\.]+ v\d+\.\d+(?:\.\d+)?:[PSMI]\d+(?:-\d+)?$"。
• 日期：created_at ≤ effective_at（若存在）。
• 方案：若 decision 非空，options 可为 ≥1；若 decision 为空，options 必须 ≥2。
• 门禁：verification.gates[*] 需包含“指标 + 比较符 + 阈值 + 可选观察窗口”。

IX. 导出与审计（最小要求）

• 导出件：yaml/json/pdf。PDF 版含封面、签署页、正文与附录；YAML/JSON 版用于自动审计与回放。
• 审计要点：编号唯一、状态机可追溯、门禁可量化、引用可解析、影响与回滚闭环完备。

X. 书写示例片段（人读正文 × 引用口径一致）

• 到达时口径：见《EFT.WP.Core.Equations v1.1》Ch.2 S20-1；在本 DR 中采用 T_arr = ( ∫ ( n_eff / c_ref ) d ell )；路径 gamma(ell) 与测度 d ell 于“实施与验证”段落中给出实验化定义。
• 量纲校核：见《EFT.WP.Core.Metrology v1.0》Ch.1–3，check_dim。
• 数据契约：见《EFT.WP.Core.DataSpec v1.0》I30-*；导出字段列表与本 DR 的 export.artifacts 对齐。

B