51-管线卡 Template v1.0 | 第0章 前言与使用说明

目录 ／ 文档-技术白皮书 ／ 51-管线卡 Template v1.0

第0章 前言与使用说明

I. 目的与范围（Purpose & Scope）

• 统一跨链路数据/计算管线的定义、执行与治理规范，覆盖拓扑（DAG/状态机）、数据契约、阶段控制式、质量门、UQ 耦合与发布工件。
• 适用：批处理、流式、近实时与混合管线；满足近轴小角、缓变介质与相干窗条件。
• 对路径量（到达时/相位）相关阶段，正文显式路径 gamma(ell) 与测度 d ell，并在数据侧记录 delta_form ∈ {general, factored}；发布要求 p_dim = 1.0。

II. 读者与适用域（Audience & Applicability）

• 读者：架构/实施工程师、计量与数据治理、运维与发布负责人、审校与合规模块维护者。
• 场景：端到端建模/推理/计量与回灌闭环；参数注册卡、误差预算卡、实验协议卡与 PTN 结果页的衔接执行。

III. 规范性引用（Normative References）

• 见《EFT.WP.Core.Terms v1.0》P10-*、见《EFT.WP.Core.Equations v1.1》Ch.2 S20-1/S21-2、见《EFT.WP.Core.Metrology v1.0》check_dim、见《EFT.WP.Core.DataSpec v1.0》TARR。
• 见《PTN Template v1.0》Ch.5/Ch.11、见《参数注册卡 Template v1.0》Ch.3/Ch.9、见《误差预算卡 Template v1.0》Ch.5/Ch.6/Ch.8/Ch.9、见《实验协议卡 Template v1.0》Ch.5/Ch.11。
• 引用一律“卷名 + 版本 + 锚点（P/S/M/I）”，锚点直指率 ≥ 90%，禁止外链与别名。

IV. 写作与排版（Style & Numbering）

• 小节标题用罗马数字并加粗；项目符号用“- 空格”；编号列表用“1. 空格”。
• 内联符号一律反引号（如 T_arr、Phi、n_eff、c_ref）；任何含除号/积分/复合算符的表达必须加括号。
• 冲突名强制：T_fil（张力）≠ T_trans（透射系数）；n（数密度）≠ n_eff（有效折射率）；禁止裸用 c、T、n。
• 到达时两口径（统一示例）：
  T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
  T_arr = ( ∫ ( n_eff / c_ref ) d ell )

V. 管线定义与工件（Pipeline Artifacts）

• 计算图与状态机：pipeline_graph.json（DAG(V,E)、状态转移与幂等键）。
• 数据契约：入站/出站 Schema 与版本演进（与 TARR 对齐）。
• 阶段规格：stage.yaml（输入/输出、控制式 Sxx-?、参数依赖、质量门）。
• 质量门与校验：/validate 报告（G1–G8 / S1–S5）、check_dim_report.json（p_dim = 1.0）。
• UQ 耦合：Σ 配置与 u^2(y) ≈ J·Σ·Jᵀ 的接口对接（Δ/MC/自举）。
• 审计与发布：audit.jsonl、report_manifest.yaml、制品签名与校验和。

VI. 质量与合规（Gates & Compliance）

• G1 Schema 完整｜G2 引用合规｜G3 路径规范｜G4 量纲闭合｜G5 新鲜度｜G6 不确定度覆盖｜G7 协方差一致｜G8 唯一性。
• 任一核心门失败触发 S1–S5 停止/回退；必要时进入 [Restricted]，仅发布定性趋势与诊断图。

VII. 接口与实现绑定（Interfaces & Bindings）

1. 统一接口（示例）：
   • I60-stage_exec(ctx, x) -> y | err（阶段执行）
   • I61-validate_gate(card, gates[]) -> report.json（质量门校验）
   • I62-export_artifacts(fmt) -> {manifest, checksums}（制品导出）
2. 错误语义、重试与幂等键、OpenAPI/gRPC/CLI 片段在第 11 章详述。

VIII. 发布工件与结果页（Release & Results）

• 发布目录与文件：pipeline_graph.json、stage.yaml、param_registry.csv、check_dim_report.json、audit.jsonl、图表（DAG/性能/路径剖面）与 report_manifest.yaml。
• 结果页版式沿用 PTN Template v1.0 Ch.11：核心指标（延迟/吞吐/Q_res/p_dim 等）与门阈对照、图表双份导出（PDF/SVG 与 PNG）。

IX. 执行勾选清单（Pre-Flight Checklist）

• pipeline_graph.json 与阶段规格（stage.yaml）完整；幂等与状态转移清晰。
• 入/出站 Schema 与 TARR 对齐；路径量显式 gamma(ell)、d ell，delta_form 已记录。
• I70-dim_check 通过并附 check_dim_report.json；p_dim = 1.0。
• /validate 通过 G1–G8，无 S1–S5；see[]/references[] 合规且锚点直指率 ≥ 90%。
• UQ 耦合配置（Σ、方法 Δ/MC/自举）一致；性能与资源指标达标。
• 发布包包含 report_manifest.yaml、audit.jsonl 与签名；禁止外链/别名。