跳到正文
定位、使用者与职责边界
定位、使用者与职责边界
搜索 YUDS 文档

YUDS 文档

来源、快照与依据追溯

数据的来源、时间、快照与口径如何在界面、复制和导出中表达,以及权限变化和来源失败时如何如实说明限制。

状态:本页为建议稿,可调整,沿用已确认的六条设计原则;它不是已实现的数据血缘系统、审计保证或合规证明。第 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 沿用旧授权输出隐藏列;生成成功掩盖范围变化
来源仅有最新版本,用户从旧审批快照打开来源 告知无法复现当时依据,显示获准的当前来源及差异限制 猜一个历史链接或自动生成解释冒充原证据

真实输出、权限及文件再导入核验未执行;运行记录须保留生成身份、文件校验值及抽样差异,不把文档扫描作为输出验收。

相关:指标、数值与时间格式、图表选择、交互与可访问等效、数据表与交互网格契约。