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

YUDS 文档

复杂数据工作模式

按任务在普通表、交互网格、矩阵、树形表和列表之间选择,并给出数据工作区的共同状态、可访问性、失败模型与验收要求。

状态:全章为建议,可调整,未经实现验收。D06(合成中性任务)与 D05(四端设计目标)已采用;真实业务证据仍待产品与实现提供,全部测试及 Web、Apple、Android、HarmonyOS 运行验证均未执行。 更新:2026-10-18

本章描述可复用任务契约,不宣称已有组件代码,也不承诺首版覆盖全部能力。业务模型、计算、权限及执行规则仍归产品。

1. 按任务选择结构

  • 阅读、检索与少量逐行操作:优先普通数据表。表中有排序按钮或链接,不自动需要网格。
  • 高频单元格定位、编辑、范围复制与键盘操作:评估交互数据网格,同时承担完整焦点和编辑模式成本。
  • 行列交叉的维度比较、期间计划或权限展示:使用矩阵模式,但先解释每个轴和交叉值,再决定实现为表或网格。
  • 真实父子关系加多列数据:评估树形表或 treegrid;普通分组标题不是业务树,不能为了视觉缩进引入复杂语义。
  • 少量独立对象的摘要或窄空间任务:记录列表或卡片可能更合适,见容器组件:分组、展开与工作区组织。

选择依据是任务、输入方式、数据关系与失败代价,不能仅因记录多就使用交互网格。普通表和交互网格在 Web 上采用不同的焦点模型,详见数据表与交互网格契约。依据:APG Table、APG Grid。

2. 专题目录

前四篇分别负责结构、交叉维度、作用域与比较语义;排程篇补充明确时间语义的限定通用任务。页面可以组合这些模式;同一任务和数据范围内,各模式应保持查询与选择状态一致。独立任务或面板可以保留各自的查看位置,不因此改变业务事实与权限。数值含义与来源见数据表达与分析;执行结果与恢复见系统状态、权限与恢复。

3. 工作区解剖

一个数据工作区至少有任务/对象名称、当前数据范围、查询入口、数据主体、已知状态、操作与结果。必要上下文包括期间、单位、币种、版本、更新时间及来源;共同口径可在区块或表头统一说明,不必复制每格。

建议把状态分为:查询草稿、已应用查询、返回快照、展示偏好、选中集合、编辑草稿和执行任务。改变列宽只影响展示;改变期间改变查询;批量执行创建任务。应分别说明这些状态的作用,避免用一个笼统的“表格状态”掩盖业务影响。

概念数据契约包括:稳定记录 ID、字段身份和类型、权限与可操作性、查询版本、快照或一致性说明、总量是否可靠、排序规则、值状态及错误来源。它们是协议要求,不是已经批准的接口命名、数据库结构或框架。

4. 交互与可访问性共同要求

焦点、选中、正在编辑和数据已变化分别表示。键盘快捷路径遵守与普通路径相同的范围、权限和风险校验。拖列、拖拽排序、调整列宽及填充同时需要键盘替代和无需拖拽的单指针替代操作,分别验收;没有可访问替代时不能宣称基本任务已完整。

复杂二维数据可能确有双向滚动需求,但表外的标题、筛选、错误与主操作仍应适配窄空间。缩减列、卡片摘要或单项详情要保留当前任务的关键比较信息,不能用“移动端”理由隐藏关键风险。

虚拟化仅是实现策略:必须保留逻辑行列身份、可访问位置、焦点与编辑状态,避免 DOM 回收把当前键盘位置丢掉。若当前方案无法支持辅助技术完成任务,应提供功能足够的替代呈现,并记录其限制及验收,不用静态导出替代编辑工作。

5. 失败模型

首次加载、后台刷新、查询失败、部分加载、旧数据、无结果、受限、服务端冲突和结果未知都有独立含义。旧数据可继续展示时,标识快照与时效;用户不可据旧事实执行高风险动作时,解释限制并提供重新验证。

读请求可按明确策略重试,防止旧响应覆盖新意图。写请求失败先判断是否已执行;没有幂等、事务或任务查询支持时不能安全地盲目重试。UI 负责表达已知状态,不负责凭空保证服务端一致性。

6. 建议实施顺序与验收

建议按依赖关系分三步评估能力:

  1. 可靠阅读与查询、明确单位、稳定排序、分页、单项详情、键盘与状态反馈。
  2. 列偏好、保存视图、明确范围的选择与少量批量操作。
  3. 交互网格、矩阵编辑、范围粘贴、跨页全量选择和并发任务恢复。

这是能力依赖建议,不是已批准的实施排期。

参考任务:筛选一组合同、比较两个期间、选择符合条件的记录、修改一个字段、处理部分失败。该任务仅是验收样例,不替用户确定首发业务场景。

每项交付应有:真实字段和样例数据、正常/空/受限/失败/并发场景、任务级键盘流程、量级与性能环境、实际测试记录。测试状态当前全部为未执行;性能阈值应按目标设备和真实数据设定,不能无依据宣称支持百万行。

7. 反例与未决项

不接受:

  • 全选只有一个布尔值;
  • 未知总量却显示 100%;
  • 红绿差异不附文字;
  • 排序后用行号保存编辑;
  • 跨币种直接相减;
  • 100 项中 97 项成功却显示“操作失败”并重试全量;
  • 只设置 grid 角色却没有键盘模型。

D06 已采用合成中性任务,D05 已设四端设计目标。待产品与实现提供真实证据:产品流程、实际支持版本、规模、远程分页方式、快照语义、任务取消及重试协议、字段权限、比较口径和审计要求。没有这些输入时可以完成设计契约,但不能验收真实业务可靠性。

来源核查日期为 2026-10-18。外部引用仅支持 Web 语义区分,实施顺序与数据契约为 YUDS 建议。

8. 任务契约与可检验范围

规则 YUDS-090000-01(任务选择)

先用“查到对象→核对期间与口径→选择范围→修改或比较→核实结果→返回”描述任务,再决定是否需要网格。每个实现实例记录普通表/网格的选择理由、输入方式、非网格替代入口及当前交付不支持的能力;不能用组件名称代替任务交付范围。规则 ID 用于规范追踪,不是组件 API。

输入与动作 可验预期 反例
仅需查合同并打开详情;用键盘完成查询与返回 普通表中操作可达,返回保留有效查询与对象位置;无需逐格导航 为十万条记录直接选 grid,却没有内部导航
需要修改项目×月份的多个值;选择窄屏替代路径 按项目和期间定位,能核对原值、新值、单位、约束并提交同一更改集 用只读下载表替代编辑,称功能等效

上述任务选型为 YUDS 根据既有可预期、有效上下文原则推导的规范要求。业务是否允许跨格原子提交仍须产品给出;能力缺失时该任务标为不支持,不能跳过验收。文档夹具可按此逐项走查,Web、Apple、Android、HarmonyOS 的运行验证均未执行。