状态:本页为建议稿,可调整,沿用已确认的六条设计原则;它不是已实现的数据血缘系统、审计保证或合规证明。第 11 节验收场景与第 12 节的真实输出、权限及文件再导入核验均未执行。 更新:2026-10-18(UTC+8),含官方资料核查。 所属章节:数据表达与分析
1. 追溯要帮助用户作判断
来源入口的目标是帮助用户回答:这是什么数据、来自哪里、经过了什么处理、对应哪个范围和版本、是否适合当前判断。它不只是一个“数据来源”图标,也不要求把技术流水线全部展示给每个人。
产品负责计算与数据处理事实,服务端负责授权和审计完整性,YUDS 规定这些事实如何被清楚表达和查阅。界面有来源链接不等于数据正确,存在日志不等于日志完整;没有实际证据时不得宣称可复现、不可篡改或审计合规。
2. 按阅读需要组织来源说明
2.1 当前判断必须可见的信息
在指标、图表或表格附近显示指标名称、期间、单位、必要范围,以及影响判断的旧数据、部分覆盖、估算或口径差异。重要限制不能全部藏在来源面板。
2.2 按需展开的说明
提供用户能理解的定义、统计对象、纳入与排除规则、来源名称、数据截至时间、更新时间、产生方式和必要计算说明。入口命名应具体,如“查看指标口径”“查看来源与更新时间”,避免只留不明问号。
2.3 获准访问的细节
需要核查时可进入原始记录、来源文件、计算版本或变更记录。技术标识与诊断详情只在有意义且授权的范围提供;不能把数据库表名或一段原始查询当成所有用户都能理解的解释。
W3C PROV 以实体、活动和参与者等概念组织来源信息,可作为“数据由什么产生、经过何种过程”的概念参考。本页不要求实现 PROV 协议或采用其技术栈。W3C PROV Overview
3. 建议记录内容
| 内容 | 表达要求 |
|---|---|
| 指标与口径版本 | 名称、版本及变更含义,避免同名不同口径 |
| 来源 | 用户可理解的系统、文件或记录名称;能否打开及所需权限 |
| 时间 | 业务期间、数据截至、来源更新、计算和快照时间分别明确 |
| 范围 | 组织、对象、筛选、权限范围和覆盖情况 |
| 处理 | 汇总、换算、剔除、估算、人工修订或模型处理的必要说明 |
| 快照身份 | 足以区分两个结果集合的稳定标识或用户可识别版本 |
| 质量限制 | 缺失、重复待处理、延迟、局部失败及已知不可比条件 |
| 责任与下一步 | 指标维护方或产品已提供的支持路径,不捏造联系人 |
这些是用户需要的说明信息,不要求每个数据点携带所有字段。相同来源可在图表或数据集层共享,但单项例外要能定位。
4. 来源时间与时效
至少分清“业务事实截至何时”“来源何时更新”“此结果何时计算”“页面何时取回”。最后取回时间不能替代来源更新时间。用户按了刷新,只能确认重新请求;不能据此宣称上游已更新。
是否过期由产品根据任务与数据服务约定定义,不能由设计系统统一规定“超过 5 分钟都过期”。过期提示说明影响范围和适用限制;是否仍可查看、导出或据此执行操作由产品风险规则决定。
有旧值时可在许可条件下保留并明确标记;没有旧值时显示获取失败或等待状态。旧值不应在一次刷新动画后自动获得新的时间标签。长期无更新且系统不知道原因时,说明已知事实,不猜测“上游故障”。
5. 快照一致性
一个分析工作区内的指标卡、图、表和来源说明尽量绑定同一查询与结果版本。不能图表已刷新、总计仍旧,却共同挂着“刚刚更新”的时间。
无法原子更新全部区域时,显示每个区域的快照或明确刷新中状态,避免将不同版本合成一个确定结论。用户切换筛选、组织、时区或口径后,旧响应不能覆盖新意图;旧数据暂时保留时仍属于旧条件,并清楚标明。
用户打开来源或下钻详情时,产品明确它展示的是原快照还是当前最新记录。如果原记录已变化,提供差异提示;无法打开历史版本时如实说明,不让“查看依据”假装精确复现当时数据。
6. 比较与计算说明
计算说明首先用业务语言解释组成、条件和限制,再提供确有必要的公式与技术细节。分子分母、换算日期、聚合范围、估算方法及人工调整由产品提供;YUDS 不重新定义或修补这些规则。
比较双方标明各自期间、范围、版本及数据性质。可以直接比较时共享公共说明;不一致时在差异附近列出不同点。只有产品确认的调整方法才可生成“可比口径”,并保留原口径和调整依据。
AI 生成的解释、人工注释或自动异常摘要是对依据的解释层,不能替代原始来源。展示它们时说明生成或编辑身份、依据版本与限制;解释文字不能作为执行或计算成功的证据。
7. 权限与受限来源
来源入口遵守与数据相容的权限,不因追溯需求扩大访问。只显示授权后的汇总时,是否允许看到来源对象名称、条数、链接或计算细节,需要产品明确。聚合说明也可能泄露受限规模,不能假定所有元数据都公开。
权限在页面打开期间变化时,及时清除或替换应用可控制且不再允许展示的值与详情;提示层、隐藏文本、可访问名称、后续复制/导出和缓存视图都应覆盖。此前合法复制、已下载及外部副本不承诺自动追回,遵守权限变化、并发修改与保存冲突的 YUDS-120200-01 控制边界。不能只是把数字用遮罩挡住,底层仍向用户端提供受限明细。
受限状态的文案与可申请路径必须符合产品安全策略。用户无权查看原件时,不以含机密名称的路径、缩略图或未授权下载链接解释原因。
8. 复制、报表与导出
复制或导出前明确对象与范围:“当前页”“已选择记录”“全部筛选结果”“当前图表数据”不是同一集合。服务端执行时再次确认查询与权限范围;界面已有授权状态不替代服务端授权。
导出随数据保留必要上下文:指标和列定义、单位币种、期间时区、筛选范围、数据截至时间、快照或口径版本、部分覆盖与估算说明。可通过工作表、文件头或说明页承载,不要求每行重复全部信息。
输出形式分别定义:
- 展示型报表保留可读标签、状态与格式,不能只留下图像且无法核查值。
- 数据型导出保留明确类型、完整精度策略及状态字段,避免日期、前导零编号被静默改写。
- 图像导出保留图题、单位、期间、图例和关键限制,必要时与数据表共同交付。
- 复制明确“显示值”或“完整值”,不能把“12.3 万”无提示复制为另一个倍率的数字。
表格输出还应检查危险内容是否被目标软件误解释为可执行公式;采取不会改变原始业务含义的安全编码或类型策略,并验证导入后的结果。导出脱敏不是授权绕过方式,不输出界面无权取得的原值。
如果只能导出当前最新数据、无法固定用户所见快照,应在生成前说明并给出导出时间。不能让文件名写“当前视图”而数据已经来自另一版本。
9. 来源失败与恢复
来源链接失效不等于指标本身为零;来源系统暂不可用也不证明数据无效。分别说明“指标仍为当前快照”“来源暂不可打开”或“无法确认来源”等已知事实,避免混成一个笼统错误。
可安全重试时提供重试;可能跳转到另一版本时说明变化;无法恢复历史依据时明确限制。不要为凑齐来源而提供猜测链接,也不要以自动生成的解释补足不存在的原始证据。
10. 企业场景正反例
- 合适: 审核人员看到“本次分析使用 9 月 30 日快照;10 月 2 日来源已修订”,可分别查看当时结果与授权后的最新记录;比较页说明修订影响范围。
- 不合适: 把“查看来源”永远链接到最新记录,却将其标为历史审批依据,用户无法解释为何金额与审批时不同。
- 合适: 导出注明“当前筛选的 128 条,按所见快照生成,其中 3 条为估算”,文件保留状态列和口径说明。
- 不合适: 页面只加载 50 条却导出 50 条并命名“全部数据”;文件删除估算与受限状态,只保留数值。
11. 验收场景
- 固定样例:从指标到图、表、来源、复制和导出,值与上下文一致。
- 并发修订:来源记录在查看过程中变化,能区分旧快照与最新记录。
- 局部刷新失败:区域更新时间不冒充全页时间,不用新条件包装旧数字。
- 权限收回:所有呈现和输出路径不再泄露值、名称或受限依据。
- 部分来源不可用:准确说明覆盖与限制,不自动把缺失计为零。
- 历史版本不存在:如实说明无法重现,不宣称审计保证。
- 导出精度、类型和状态:打开文件后保留编号、时间、币种和质量说明。
验收分业务口径正确、权限正确、界面可理解、输出一致四组分别记录。以上场景均未执行,不据此宣称任何产品的数据可追溯性已通过验证。
12. 可追溯输出的核对规则
规则 YUDS-100300-01(输出身份)
生成前确定范围、权限、快照、口径、类型和完整精度策略;生成后核对文件实际内容与该说明。时间点与本地日期遵守指标、数值与时间格式的 YUDS-100100-01~02;机器值和显示文本分开,数字未知状态不能成为空白或 0。来源链接指向最新而非当时版本时,直接说明“当前记录”,不称历史依据。文件生成成功、下载完成与用户业务任务完成分别表达。
| 输入与动作 | 可验预期 | 反例 |
|---|---|---|
| 导出所见 S1 的 3 条:编号 000123、明确 0、未知金额;本地日期与带偏移时刻 | 打开文件后编号和类型保留,未知独立,S1 及时间语义可查;按产品精度复算一致 | 表格软件吞前导零;未知被当零;日期平移 |
| 生成途中来源更新 S2 且用户撤回某字段读取权 | 按实际协议失败、缩小范围并说明,或重新核验获准输出;不交付受限字段,不把 S2 冒充 S1 | 沿用旧授权输出隐藏列;生成成功掩盖范围变化 |
| 来源仅有最新版本,用户从旧审批快照打开来源 | 告知无法复现当时依据,显示获准的当前来源及差异限制 | 猜一个历史链接或自动生成解释冒充原证据 |
真实输出、权限及文件再导入核验未执行;运行记录须保留生成身份、文件校验值及抽样差异,不把文档扫描作为输出验收。