Link report structure and production guidance (0.8.0)
This commit is contained in:
@@ -2,6 +2,14 @@
|
||||
|
||||
`chart_component.py`把明确的数据生成一个独立 SVG `g`:其中包含原生 Chart metadata、同源的可见 SVG fallback,以及标题、单位、图例和来源文字。把它组合进所选 template 的页面;组件不复制母版、版式或页面 UI。它是技术组件接口,不替调用者决定报告应使用哪些图表。
|
||||
|
||||
## 按判断任务选图
|
||||
|
||||
先说明当前图表支撑哪个判断、所需数据和比较口径,再选择表达方式。内容方案可能建议箱线图、小提琴图等;这些是表达任务的建议,不表示本组件已支持。当前原生接口只支持下表七类。
|
||||
|
||||
建议类型不受支持时,判断已选制作路线能否用原生对象或可验证的 SVG 图示保真实现;明确其实际对象类型和编辑范围。若不能实现,返回受影响页 ID、缺少的能力及具体内容选项。不能把分布静默改成均值、遗漏会改变判断的对照,或以图片宣称原生 Chart;也不静默更换后端、在线服务或安装其他 Skill。
|
||||
|
||||
比较前优先统一对象、定义、单位、分母/基线、时间范围、样本和统计方法;保留有效换算、重算或区间对齐的依据。确实无法统一时,分开展示或限定可比较的情境,让结论与实际证据范围一致;仅标“口径不同”不能支撑排名。
|
||||
|
||||
## 支持范围
|
||||
|
||||
| type/示例数据 | 用途与适配 | 当前技术边界 |
|
||||
@@ -26,7 +34,7 @@ JSON顶层字段:`schema_version: 1`,`data_kind`(`synthetic-demo`/`obser
|
||||
|
||||
`source`只作为显示文字与元数据保留,工具不会读取链接、补充出处或证明其真实性。所有原始数据同时放入marker的`component_data`,供工程审计;原生图表cache及内嵌XLSX保存未缩放的实际数值。
|
||||
|
||||
遵循[文字与容器约束](text-and-containers.md):小号灰色/弱化说明只承载补充背景、来源或非关键口径。图表的实质性解释、关键条件和时机、结论,以及影响解释范围的限定或免责说明,必须进入可读的主体层级,不得塞进`source`、小字或仅存讲稿。关键单位和口径也不能因字段名被降级。图表标题、说明和正文承担不同作用时,用字号、字重和/或调色板颜色作出明确区分,不能只换字体。
|
||||
遵循[文字与容器约束](text-and-containers.md):数据源、一般范围、统计口径与引用定位可使用小字;直接影响核心判断的条件、实质解释与结论放在相关主体中。先修正有歧义或过强的正文,删除无助于理解的预防性辩解;具体、有用的警示按作用适度表达。字段名不能把必要信息降级为`source`,也不把正常来源文字改成警告。图表标题、说明和正文承担不同作用时,用字号、字重和/或调色板颜色作出明确区分,不能只换字体。
|
||||
|
||||
## 样式来源
|
||||
|
||||
|
||||
Reference in New Issue
Block a user