第11章 可视化与审计(仪表板与报告)


I. 目的与范围(Purpose & Scope)


II. 仪表板结构(Dashboards)


III. 图形规范(Figures)

  1. 通用:矢量 PDF/SVG 与位图 PNG 双份导出;DPI ≥ 300;坐标轴显式单位(s, rad, 1, m/s 等);图注含 see[]/version。
  2. 建议图型
    • 参数快照:水平条形(当前值 vs range vs default)。
    • 新鲜度热图:参数 × 时间栅格,过期高亮。
    • 协方差热力:组内 Σ 热力图/谱半径;PD 失败高亮。
    • 路径剖面:n_eff(ell) 对 ell,叠加不确定度带。
    • 审计时序:关键事件 created/updated/validated/locked 时间线。

IV. 审计与事件(Audit & Events)


V. 合规模块(Compliance Block)


VI. 机读模板(Machine-Readable Templates)


A. 仪表板配置 dashboard.yaml

version: "1.0.0"

widgets:

- id: "param_card"

binds: ["param_id","symbol","status","version","domain.unit","domain.range","domain.default","cov_group"]

- id: "freshness_panel"

binds: ["freshness.valid_from","freshness.valid_to","freshness.policy.clock_state"]

- id: "dim_compliance"

binds: ["p_dim","links.check_dim_report"]

- id: "uq_panel"

binds: ["uncertainty.estimate","uncertainty.coverage","uncertainty.distribution"]

- id: "cov_view"

binds: ["cov_group","cov_model.kernel","cov_model.params","cov_pd"]

- id: "lineage_graph"

binds: ["lineage_graph.json"]

- id: "path_profile"

requires: ["path.gamma","path.measure","path.delta_form"]

binds: ["n_eff_profile","path.delta_form","meta.delta_ell"]


B. 审计事件 audit.jsonl(示例行)

JSON json
{
  "ts": "2025-09-24T16:10:00Z",
  "event": "validated",
  "param_id": "PHY-03-n_eff_profile",
  "version": "1.0.0",
  "user": "ci-bot",
  "input_hashes": [ "sha256:..." ],
  "notes": "schema+gates passed",
  "signature": "PGP:...",
  "checksum": "sha256:..."
}

C. 报告清单 report_manifest.yaml

version: "1.0.0"

bundle:

figures:

- "figs/param_snapshot.pdf"

- "figs/freshness_heatmap.svg"

- "figs/cov_heatmap.pdf"

- "figs/path_profile.svg"

reports:

- "reports/check_dim_report.json"

- "reports/audit.jsonl"

tables:

- "tables/param_registry.csv"

- "tables/compliance_table.csv"

metadata:

dataset_id: "ptn-demo"

method_version: "2.0.0"

checksums: ["sha256:..."]

see:

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

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


VII. 发布目录(Release Layout)

PTN_EXPORT/

figs/

param_snapshot.pdf

freshness_heatmap.svg

cov_heatmap.pdf

path_profile.svg

reports/

check_dim_report.json

audit.jsonl

tables/

param_registry.csv

compliance_table.csv


report_manifest.yaml

SIGNATURE.asc


VIII. 交叉引用(Cross-References)


IX. 执行勾选清单(Checklist)