50-参数注册卡 Template v1.0 | 第11章 可视化与审计（仪表板与报告）

目录 ／ 文档-技术白皮书 ／ 50-参数注册卡 Template v1.0

第11章 可视化与审计（仪表板与报告）

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

• 统一参数注册的**可视化（仪表板）与审计（报告与事件）**输出规范，覆盖指标版面、图表样式、合规模块与审计轨迹，确保跨链路监控、复核与发布。
• 涉及路径量（到达时/相位）时，正文显式 gamma(ell) 与测度 d ell，并在卡片数据侧记录 delta_form ∈ {general, factored}；对外发布要求 p_dim = 1.0。

II. 仪表板结构（Dashboards）

• 参数概览卡（Per-Param Card）：param_id / symbol / status / version / unit / range / default / cov_group / freshness.ttl。
• 新鲜度面板（Freshness Panel）：valid_from/valid_to 时间轴、clock_state 状态条、超期告警。
• 量纲合规模块（Dim Compliance）：p_dim 仪表（=1 要求）、check_dim_report.json 摘要链接。
• 不确定度与覆盖（UQ）：estimate 与区间（k/alpha/quantile），稳健代理（如 Huber）的标识。
• 协方差透视（Cov View）：cov_group 关系图、组内核与参数（σ^2, L_c, φ 等）、正定性检查结果。
• 血缘桑基/网图（Lineage Sankey/Graph）：depends_on → param_id 流向，显示上游版本与 checksum。
• 路径型专栏（若适用）：n_eff(ell) 剖面图，图注标注 Δell 与 delta_form，参考窗说明。

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）

• 事件类型：created | updated | validated | locked | deprecated | rolled_back。
• 必记录字段：时间戳、操作者、输入哈希 input_hashes[]、软件/版本、seed、变更说明、签名与 checksum。
• 输出文件：audit.jsonl（逐行 JSON），在发布 report_manifest.yaml 中列出与校验哈希。

V. 合规模块（Compliance Block）

• 展示 p_dim、anchor_coverage / ver_presence、valid_to / clock_state、coverage 口径、cov_group 正定性与组配置一致性结果。
• 任何核心门未通过（见第10章）应在图表与清单中标注 [Restricted] 并仅发布定性信息。

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（示例行）

{"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）

• Schema 与 API：见第9章；质量门与校验：见第10章；版本与新鲜度：见第6章；不确定度与协方差：见第8章；血缘：见第5章。
• 误差预算卡：协方差与传播（Ch.5/Ch.6）、阈值映射（Ch.9）；结果页规范参考 PTN Template 第11章。

IX. 执行勾选清单（Checklist）

• 仪表板包含：参数快照、新鲜度、量纲合规、不确定度、协方差、血缘与路径专栏（若适用）。
• 图表双份导出（PDF/SVG 与 PNG），轴单位显式、图注含 see[]/version；路径图标注 Δell 与 delta_form。
• audit.jsonl 事件完备；report_manifest.yaml 列出所有制品与校验哈希/签名。
• 合规模块展示 p_dim、anchor_coverage、clock_state/valid_to、覆盖口径与协方差 PD 检查。
• 对 [Restricted] 场景已追加标签并限制为定性呈现；所有引用锚点直指率 ≥ 90%。