数据表达与分析 · YUDS

状态：建议稿 v0.2，可调整；未批准为正式产品数据字典，未完成实现或业务计算验收，未验证任何真实业务数据或计算结果。第 02 章六条设计原则沿用原有确认状态与效力。参考任务、指标目录及首期图表能力仍待选择。更新：2026-10-18（UTC+8）

本章不指定图表库、数据平台、前端框架或产品计算引擎。

专题地点选择与只读关系探索说明地点显式单选与只读关系探索的有界候选；地图或关系图只是一种呈现，列表／关系表保留同等任务路径。

1. 目标与责任

用户看到一个数字时，应知道它代表什么、适用于哪个范围、是否可以比较，以及依据在哪里。表格、图表、提示层、报表和导出应表达同一业务事实，不能因为呈现方式不同就改变指标口径或静默忽略缺失项。

YUDS 负责表达契约、状态词汇、比较提示、交互和可访问性要求。产品负责指标定义、业务模型、计算公式、聚合方式、时间窗口、分母、阈值、汇率选择与权限。实现项目负责按契约正确呈现并验证数据和界面的一致性。YUDS 不成为财务计算或领域算法库。

下列内容是交付给界面与验证团队的说明项，不强制成为统一后端字段 schema。产品可以用自己的模型承载，但必须能提供必要含义。

共同说明可以放在表头、图题或区块上下文，不需每个单元重复。但离开原上下文后，复制、展开、钻取和导出仍要能理解数值含义。

避免设计一个互斥枚举，把“已加载、预测、过期、部分数据、只读”混成一种状态。至少考虑以下独立维度：

例如“截至昨日的预测值，仅覆盖 8／10 个项目”可以同时为已加载、预测、旧数据和部分覆盖。界面不能因为已加载就显示为“正常完整”，也不能因为是预测就隐藏其更新时间。

列表行、分组小计、总计、指标卡和图表应说明各自的聚合范围。“本页小计”“筛选结果合计”“有权访问范围合计”不能仅用“合计”混称。分页、虚拟化或只加载前若干条都不是把本地已加载数据当成总量的理由。

比较前检查期间、时区、币种、样本、定义版本、实际／预测性质及完整性。无法直接比较时，可并列显示事实并提示差异，不默认计算一个具有误导性的增长率。是否有可接受的调整方法由产品定义，调整后展示说明与原口径入口。

以下为虚构验收场景，不是任何产品的真实指标：审核人员查看“9 月合同回款率”，界面说明“2026 年 9 月，组织 A，有权访问合同范围，统计时区 Asia/Shanghai”。产品给出分子、分母及金额归属规则，YUDS 不替其定义。

如果 10 个项目中只有 8 个已上报，指标旁显示“部分数据：8／10 个项目”；不能把另外 2 个按零处理后称为全组织实际值。图表、表格与导出使用同一口径与快照，用户可查看范围说明及获准访问的来源。

若用户切换到另一币种、不同时间窗或新的快照，显示相关变化，并重算依赖结果。旧请求晚到时不能覆盖新选择；若某一视图未能刷新，明确它仍属于旧快照，不能将新标题套在旧数字上。

“可比项目回款率 85.0%，较上月增加 2.0 个百分点；本期新增项目未纳入比较”。限制与结论一起呈现，详情可查样本定义。

“回款率增长 2%”没有说明相对增长还是百分点，也未说明新增项目改变了分母。

未取得数据的项目显示“未上报”，后台重试时保留这一事实；历史已知值若继续显示，标注其日期。

缺失显示 0，获取失败显示横线，横线同时代表不适用和无权限，最终被用户当成零参与决策。

对同一个固定样例，核对指标卡、列表、图表、详情、复制和导出的值、范围、单位、期间与状态。再分别引入部分覆盖、权限收回、数据过期、分母为零、币种不同、请求乱序和刷新失败。

验收通过需满足：

每项记录“通过／失败／未执行／不适用”。业务公式与界面表达分别验收，不能互相替代。

本章为建议规范，未验证任何真实业务数据或计算结果。参考任务、指标目录及首期图表能力仍待选择。

用指标身份＋定义版本＋范围＋期间＋快照识别一次分析结果。卡片、图、表、下钻和输出的任一维度不一致时，须在结论旁说明，不能共用“已更新”掩盖。数字与时间格式主档为指标、数值与时间格式；来源与导出主档为来源、快照与依据追溯；专题不另定精度与业务计算。

输入与动作	可验预期	反例
样例 S1 只覆盖 8/10 项目，切图表、表格、导出	各处保持同一 S1 和覆盖说明，缺 2 项不补零；任务所需完整值可取得	导出删掉部分覆盖标记，把局部值称全组织实际值
新快照 S2 只刷新成功图表、表格仍 S1	各区显示所属快照，停止把跨区结果合成确定比较；重试不改口径	页面统一写“刚刚更新”，用 S2 图解释 S1 表

此为 YUDS 表达一致性验收夹具。业务公式正确性、跨视图运行及实际导出均未执行。