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

YUDS 文档

页面与端到端模板

如何把共同规则组合成可复用的页面骨架,以及每类模板的适用任务、结构、必须覆盖的变体与验收重点。

状态:本页全部为建议,可调整。下列模板是候选组织方式,不是已确认的首版目录、组件实现或产品完成声明;模板验收对应的实际产品测试均未执行。

本章对应大纲第 10 章,将共同规则组合成可复用的页面骨架。先按任务选择模板,再用端到端任务旅程与验收案例检查跨页面的完整流程;模板不替代各专题的行为规则。

业务对象、行业模型、计算公式、审批制度与流程配置仍由产品负责。

1. 模板的用途与边界

模板帮助团队复用稳定的任务结构:身份与范围放在哪里,主内容和参照资料如何配合,用户如何操作、获知结果并返回。模板不等于固定截图,也不应把某个产品的领域字段、组织层级或算法固化为通用设计系统。

同一模板可以组合不同组件和任务模式;不同平台也可采用不同布局。复用的核心是信息职责、操作语义、状态与验收要求。只有确实反复出现的结构才进入公共模板,单一产品的特殊工作保留局部实现,并通过公共契约接入。

2. 所有模板的共同骨架

每个页面按任务需要承载以下职责,区域可以合并或重新排列:

  1. 身份与范围:当前对象或工作类别,以及影响判断的组织、项目、期间、版本或筛选。
  2. 任务与真实状态:用户来做什么,业务当前如何,哪些内容只是在浏览。
  3. 主要内容:完成判断与操作所必需的数据、表单或依据。
  4. 参照与深入内容:关系、说明、历史或明细,有清楚入口且能返回。
  5. 操作与条件:当前可执行动作、必要前置条件、作用范围及后果。
  6. 反馈与后续:保存或执行状态、真实结果、错误和可行恢复路径。

没有组织、版本或流程概念时不添加空层级;没有可靠进度或预计时间时不绘制虚构数据。模板不要求所有页面出现同样数量的区块。

3. 列表工作台

适用任务

寻找对象、筛选工作、比较记录、逐条核查或批量处理。数据结构和交互复杂度决定使用普通表格、数据网格、树形结构或卡片,不以“企业软件”作为必须使用复杂网格的理由。

建议结构

  • 工作标题与数据范围。
  • 搜索、筛选、已应用条件及必要的保存视图入口。
  • 结果摘要、排序与记录区域。
  • 当前查看记录的详情或参照区域,适用时提供。
  • 批量选择状态与仅在有选择时出现的相关操作。
  • 加载、刷新、空结果、部分数据与任务结果入口。

批量任务摘要分别表达批次进度和逐项结果:仍在运行时显示“处理中”及已完成数量;确认结束后汇总已核实结果,未核实项仍标为“待确认”。

查看记录不等于勾选记录;筛选、勾选和批量范围的关系必须明确。返回列表时保留仍有效条件与合理位置。操作后记录不再符合筛选时,应说明其离开结果集,而不是继续显示旧状态。

必须覆盖的变体

无记录、筛选无结果、读取失败、局部刷新失败、部分权限、选中项失效、全部查询结果选择、批量执行中部分完成、批次结束后的部分成功及结果待确认。详细契约见数据表与交互网格契约、导航、深链接与上下文保留。

4. 对象详情

适用任务

理解一个对象的当前事实、查看相关资料和历史,并进入有权限的工作。

建议结构

  • 稳定对象身份及必要的状态、范围、版本或数据时间。
  • 面向理解的摘要,优先展示当前任务所需信息。
  • 对象内部内容分区,如基本资料、关系、附件与历史;名称由产品定义。
  • 关联任务与明确的执行入口。
  • 关系和依据入口,打开后可辨新目标并可返回。

对象摘要不应把重要异常藏在“更多”之后。多个任务同时存在时,说明任务身份,不把其中一个任务状态误作对象唯一状态。历史版本应与当前版本清楚区分,不能让用户在历史页误执行针对当前内容的动作。

必须覆盖的变体

只读、部分字段不可见、对象已归档或删除、版本不可访问、关联数据缺失、任务已完成、打开关系后返回。权限原因的解释遵守不泄露原则。

5. 编辑与提交页

适用任务

创建或修改一个有明确目标的对象,或收集推进某项任务所需的信息。

建议结构

  • 编辑目标、任务身份和数据基准。
  • 分组或分步表单及必要说明。
  • 参照资料和跨字段关系说明。
  • 保存状态、草稿与正式提交的不同操作。
  • 错误摘要、影响预览和提交结果。

步骤组织填写内容,不自动表示业务阶段。用户能查看其他分区再返回;保留仍有效输入,影响判断的数据变化要求重新核查。提交结果待确认时保留任务身份并核查结果,不直接重开提交按钮。

必须覆盖的变体

未保存、正在保存、草稿保存失败、异步校验待定、跨字段错误、并发冲突、权限改变、任务已结束、提交结果未知。详细规则见表单校验、草稿与提交。

6. 复杂任务工作空间

适用任务

需要同时编辑、核查依据、比较多个对象或浏览流程的复杂工作。

建议结构

  • 持续可辨的对象、任务及当前业务阶段。
  • 主工作区承担当前编辑或判断。
  • 参照区承载附件、依据、差异或相关对象,明确各自身份与数据基准。
  • 流程或分区定位,分别标明实际业务阶段与正在查看的步骤。
  • 当前动作、条件、保存状态和真实结果。

多面板的价值在于减少记忆和往返,不在于同时塞入全部功能。参照区的动作必须明确目标,不能意外修改主对象或另一个对象。面板开关、尺寸调整与替代输入方式应按平台能力设计,不把拖拽作为唯一操作方式。

必须覆盖的变体

资料暂不可用、并行分支、退回补充、任务途中查看其他步骤、返回时对象变化、另一人已完成、参照内容权限收回。主档见对象、任务与流程的衔接、流程推进与协作责任。

7. 分析与仪表盘

适用任务

理解总体状态、发现异常、比较变化并进入可处理的明细。仪表盘的意义是支持判断与后续工作,不是展示尽可能多的图表。

建议结构

  • 分析问题、总体范围、期间、数据时间与必要口径。
  • 少量与任务相关的关键指标及状态。
  • 解释差异或趋势的图表和可访问数据替代。
  • 异常或需要关注的对象、明细与来源入口。
  • 下钻后返回同一分析范围的路径。

零、缺失、估算、部分来源和旧数据要可区分。指标与图表使用一致口径;下钻明细范围变化时明确说明,不制造汇总可直接由当前几行相加得到的假象。

从分析进入处理任务时,带入相关对象和依据,但不能自动把分析推断变成已验证业务事实或审批结论。计算逻辑与行业模型归产品,模板只规定表达与核查入口。

必须覆盖的变体

无数据、部分来源失败、旧数据、不可比期间、权限受限指标、下钻无结果、导出与屏幕口径差异、文字放大后的替代表达。

8. 审核中心与处理页

适用任务

集中处理当前身份有权处理的任务,核查对象及依据,并作出明确业务决定。

建议结构

  • 待办范围、角色或代理身份、筛选与任务优先信息;优先级和截止时间只取真实业务数据。
  • 当前任务身份、对象、数据基准和真实阶段。
  • 主要内容、差异、附件、历史及必要条件。
  • 当前可用动作、需要的意见与明确后果。
  • 结果与返回任务列表路径。

“已打开”不等于“已审核”;保存意见不等于正式提交。用户查看资料或其他步骤后返回时,重新核查任务与数据。任务被他人完成时展示当前结果,旧动作不可继续。

连续处理下一项可以提升效率,但新任务必须清楚更换身份和依据。上一项的选择、确认、意见与敏感内容不能未经说明地带入下一项。批量审批只有产品明确支持且能提供必要核查时才提供,不能作为通用模板默认能力。

必须覆盖的变体

没有待办、仅可查看、并行审批、退回补充、代理身份、数据变化、任务已由他人完成、提交结果待确认、批量部分成功。

9. 管理设置页

适用任务

调整有清楚作用范围的产品配置。配置字段和影响由产品定义,不能用通用设置模板推导用户拥有管理权限。

建议结构

  • 配置范围与当前状态,区分个人、工作区或组织级影响。
  • 主题分组、当前值及必要说明。
  • 保存或立即生效语义。
  • 重要影响预览、权限说明及真实恢复方式。
  • 更改结果和已有历史入口。

安全、权限、外部连接或大范围业务配置具有不同后果,应按产品政策设计确认与授权。没有撤销能力就不承诺恢复默认可消除所有影响。

必须覆盖的变体

只读、部分配置可改、未保存、保存冲突、部分保存、权限撤回、配置已被其他人变更,以及当前设置对进行中任务的影响说明。

10. 窄容器、分屏与不同输入方式

响应式调整优先保持任务语义。身份、范围、重要数据、风险和结果不得为维持桌面布局而隐藏。

  • 列表可以转为摘要卡片或减少默认列,但重要差异仍需可查,选择范围不能改变含义。
  • 主从面板可以转为顺序页面,返回时保留仍有效的查询和位置。
  • 参照内容可以按需打开;必要比较若无法同时显示,应提供清楚的比较视图或可用替代,不能强迫凭记忆完成高后果判断。
  • 固定操作区不得遮挡输入、焦点或错误;软键盘出现时仍可到达主要动作。
  • 键盘、触控和辅助技术路径遵守相同权限、数据与风险要求,不要求相同手势或像素布局。

11. 模板交付契约

每个准备进入实现的模板应附带:

  1. 适用与不适用任务,真实使用者与目标。
  2. 必需区域、可选区域及产品可扩展位置。
  3. 导航与上下文契约,数据与权限来源。
  4. 关键动作、前置条件、范围与真实结果。
  5. 状态矩阵,含空、错误、权限、旧数据、冲突和恢复。
  6. 窄容器、文字放大、键盘及辅助技术路径。
  7. 端到端测试和设计/代码/任务验证证据,分别标记状态。

只展示默认状态的模板画廊不足以作为交付。没有真实产品字段时,可用清楚标注的虚构夹具检验行为,不能把它们记成产品已验证能力。

12. 模板验收重点

以下为模板验收设计,实际产品测试均为未执行:

  • 用户在任何模板里均能辨认对象、范围、真实状态及下一步。
  • 相同操作跨模板保持相同含义、授权、结果与恢复规则。
  • 列表到详情、详情到任务、任务到依据并返回的上下文可连续恢复。
  • 数据或任务变化后不沿用过期确认;已完成任务不再执行。
  • 空、局部失败、部分成功、权限变化和结果未知都有真实路径。
  • 窄容器及替代输入路径能够完成完整基本任务,不只“看起来布局正确”。

13. 将模板实例化成可验收任务

实例化清单按“模板→对象与任务→数据夹具→平台适配→异常→实际结果”填写。以列表工作台为例:固定查询和对象 ID,指定只是查看还是批量选择;进入合同 C 的任务 T-C-1,填意见、看依据再返回;注入 v1 变 v2 或提交回执丢失,再检查当前结果。字段、权限和版本仅是端到端任务旅程与验收案例的虚构夹具,真实实例由产品提供。

每份模板实例引用 A–E 的完整正常路径,再选择 G 组平台组合和失败注入;页面截图不是实例验收。若平台缩窄使列表转单页,仍以同一对象、查询和任务继续;若没有并列比较能力,提供有明确双方身份的顺序比较或专门比较页。必要差异无法核查时停止该高后果提交并说明所需完整工作环境,不以隐藏列完成适配。

验收记录至少包含一个正常完成、一个结果未知或权限变化、一个替代输入路径和一个内容增长组合;适用测试未运行一律标未执行,模板目录不能显示为“已验证”。

跨分支任务入口:认证与安全返回见权限变化、并发修改与保存冲突 PAT-AUTH;首次使用见流程推进与协作责任 PAT-ONBOARD;告知选择见表单校验、草稿与提交 PAT-CONSENT。具体文件名由当前主档登记定位。

手册选型补充:布局分配区域,页面模板组织当前任务,跨页旅程维护上下文与结果;同一模板可采用单页或多区布局,不因换布局改变提交含义。贯穿的任务→模板选择与正反例见接入示例:共享资料清单。