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

YUDS 文档

接入示例:共享资料清单

用合成记录 R-001 演示从查找、阅读、编辑、保存到返回清单的组件与模板组合,以及必备异常分支。

状态:手册组合示例,不是产品方案;所有字段、版本、权限和回执均为测试替身。设计仍暂停,本页不新增设计稿,不声明实现、运行或视觉验收通过;全部步骤为预期行为,服务、辅助技术、键盘和四端走读均未实际运行。四端呈现为本例 YUDS 默认建议,不是平台强制规则;HarmonyOS 原生组件、系统返回、辅助技术与浮层映射仍待核实。 所属章节:页面与端到端模板

定位:手册组合示例,不是产品方案

本页把组件、任务模式和页面模板连成一条可逐步核查的路径,采用 D06 的合成记录 R-001、范围 S1。所有字段、版本、权限和回执均为测试替身;没有真实共享、上传、支付、审批或生产写入。设计仍暂停;本页不新增设计稿,不声明实现、运行或视觉验收通过。

阅读顺序:先理解用户目标,再看推荐装配和逐步状态,最后把异常与四端路径交给实现。完整契约以链接主档为准,不以本例简化覆盖。

1. 任务卡:先说明做什么,不先挑组件

  • 使用者目标:在 S1 的共享资料清单找到 R-001,阅读详情,修改允许修改的信息,保存后确认结果,再返回原清单。
  • 合成对象:R-001,名称“资料甲”;版本 v1。名称、金额与币种、纯日期、分类选择值、备注承接 D06;金额只是输入夹具,不代表费用、付款或财务规则。
  • 范围含义:“共享资料”只是中性清单标题,不表示所有人可见,也不授予分享权限。S1 是合成范围,不是真实租户。
  • 执行语义:“保存资料”在本例是一次显式受控提交事件;只有与该次对象、基准及任务匹配的成功回执才能说保存成功。未承诺自动保存、草稿服务、离线写入、跨端继续或撤销服务。
  • 任务边界:查询、勾选、浏览、编辑、保存是不同意图。打开详情不是选择;勾选不是编辑;字段接受不是远端保存;关闭面板不是取消已发写入。
  • 不适用:行业审批、成员授权管理、批量写入、附件生命周期和真实协作锁不在本例。需要这些能力时另按相应主档接入,不从清单名称推导能力。

事实与版本主档:对象、任务与流程的衔接、权限变化、并发修改与保存冲突。原始 D06 与能力开关见端到端任务旅程与验收案例。

2. 推荐装配:一个任务,不是一屏组件展览

区域 本例选择 保留的责任 不这样拼装
页面身份 壳+标题“共享资料清单”+可披露范围 S1 当前范围与返回路径可辨 把范围藏在头像提示里,或切范围后沿用旧数据
查找 查询输入+分类筛选+已应用条件摘要 查询原稿与已应用查询分离 每按键就覆盖结果身份,晚结果冒充当前查询
结果 记录列表;确有列关系时才用普通数据表 稳定记录 ID、状态、可明确打开的名称 为企业感强上复杂网格;整行点击同时勾选和打开
选择 可选的独立复选入口+已选范围说明 集合与当前查看项分离 将当前详情高亮冒充“已选1项”
详情 对象详情页;宽窗可在非模态侧区读取 R-001 与版本身份、获准内容、编辑入口 在小型 popover 里承载整份长表单
编辑 单一表单,字段按阅读顺序分组 原始稿、接受值、基准、保存状态 每张字段卡各设“保存”主按钮,却一起提交整份对象
选择值 简单候选用单选;复杂查找才用值帮助 子选择接受只更新父草稿 子层“确定”直接提交父表单
保存与结果 唯一主操作“保存资料”+持续结果位置 当前请求身份、可信结果、恢复入口 关闭动画或绿色 toast 作为成功证据
返回 明确返回清单 重新授权后恢复仍有效查询和定位 回列表即重放保存,或刷新丢失原查询

组件入口:操作组件:按钮与动作入口、输入组件:文本、结构化编辑与专用输入、选择组件:值、范围与层级、容器组件:分组、展开与工作区组织。模板入口:页面与端到端模板。

选择能力的非适用处理

本例保留勾选分支只为核查“选中不等于查看”。若真实产品没有任何集合任务,移除复选和批量工具栏,不为了示范组件提供无意义勾选。本例不虚构“批量保存”。如需展示选中集合,仅作本地集合查看,不能暗示远端动作能力。

2.1 任务、模板与布局分别选择

当前问题 选择的页面模板 可换的布局 不改变的跨页任务
我要找资料 列表工作台 全宽列表/带详情侧区 查询→打开→返回同一查询
我要理解 R-001 对象详情 单页/主从内容区 阅读→进入编辑→返回详情
我要修改获准字段 编辑与提交页 单列分组/有参照的双区 原稿→校验→保存→确认结果
我要核查复杂依据 本例默认不启用;需要时选工作空间 并排或明确参照页 查看依据后返回同一编辑任务

布局只分配区域,页面模板组合当前任务组件,跨页旅程负责上下文与结果连续性。窄窗将双区改成顺序页面,不会把一个保存任务拆成多个任务。这里借鉴 SAP 布局与页面类型的区分,具体 R-001 组合为 YUDS 示例,不是 SAP 产品模板。

3. 正常路径:从入口到返回

以下每一步均为预期行为,实际未执行。任务标识 T1 仅作合成追踪标识。

步骤 用户所做 界面应表达 状态与事件边界 主要契约
1 浏览 进入 S1 清单 标题、当前范围、读取状态 先授权再显示;空记录与失败不同 权限主档、CT-LIST
2 筛选 输入“资料”,选择分类并应用 已应用条件与对应结果 编辑查询原稿不伪称已应用;旧查询回包不覆盖新结果 QRY-SEARCH、查询、选择范围与批量执行
3 选择 勾选 R-001,再打开其名称 选择集合与详情对象分别可辨 勾选集合不因打开详情被清空;打开不触发写事件 CT-LIST、数据表与交互网格契约
4 阅读 查看 R-001/v1 获准内容、版本、编辑资格 阅读不表示已编辑或已保存 导航、深链接与上下文保留
5 编辑 进入表单修改名称等字段 当前目标与未保存状态 本地原始稿可含“1.”等未解析输入;不被异步刷新改写 字段共同契约、表单校验、草稿与提交
6 接受选择 打开分类选择,换值后接受 新值进入同一父稿 关闭子层不提交 T1;取消按子会话契约保护原稿与父新修订 SEL-SINGLE/SEL-HELP、LP-G03
7 保存 激活“保存资料” 正在保存、对象和任务仍可辨 校验成功后发一次受控 T1;重复激活不能另发同一任务 CMP-ACTION、异步执行、结果核查与恢复
8 获知结果 收到匹配 T1 的确认成功 “资料已保存”,可查当前值及新基准 回执才改变确认状态;toast 可补充,不能是唯一结果 FB-BANNER/FB-TOAST
9 返回 返回清单 原查询及仍有效定位;R-001 当前事实 先核查授权和数据;不再符合筛选则解释并提供获准查找入口 导航主档、权限主档

若采用读写分离的详情页,保存成功后可继续留在详情,不自动回列表造成用户错过结果。若实例决定成功后返回,也要在目标清单提供可持续理解的结果与对象定位;此决定必须在实例卡写明。本例默认留详情,由用户返回。

3.1 一次具体走读:改备注,再看到确实保存

这条说明性路径固定:读写权限有效且允许披露全部合成字段、R-001/v1 未被别人修改、查询结果含 R-001、所有读取完成、没有并存子层或新任务夺取焦点;T1 写入由测试替身确认成功并返回 v2。以下焦点预期只适用于这些前提,不覆盖 LP-G05 例外。

  1. 在清单输入“资料”并应用,按名称“资料甲”打开 R-001。Web 独立页进入可识别的详情标题/主内容起点;原生按所选导航机制使新页面标题与对象身份可获取,不硬套 Web Tab 序列。列表保存查询和原来入口的安全定位。
  2. 详情显示备注旧值“待补充说明”,版本 v1。选择“编辑资料”后进入编辑标题/表单起点;不自动聚焦金额并弹出键盘,也不自动提交。用户将备注改为“补充阅读顺序说明”。此时屏幕可显示“有未保存更改”,不能显示“已保存”。
  3. 用户打开“分类”选择器,选择合成候选“参考资料”,再按“使用此分类”。子会话接受后返回仍存在且合法的“分类”触发字段;备注仍为用户的新原稿。接受分类只改变父稿,T1 尚未发出。如果选择器取消,则恢复规则遵循 LP-G03,不清空其他父稿。
  4. 为演示修正,用户暂把金额写成未完成输入“1.”并按“保存资料”。本夹具明确将此最终提交值拒绝;显示“请补全金额”,关联金额字段,并在错误摘要提供定位入口。焦点到摘要或首个无效字段的选择须在实例卡固定,本例固定到错误摘要,用户激活“金额”后到该字段;不由晚到的校验反复抢焦点。未发 T1,备注原稿仍在。
  5. 用户把金额修正为合成合法值“1.00”,其他字段保持有效,再按“保存资料”。此时发出一次 T1,界面显示“正在保存资料甲”。无需焦点跳到进度;当前动作忙碌状态可获取,结果尚未证实。
  6. 匹配 T1 的成功回执到达,返回 R-001/v2,备注确认为“补充阅读顺序说明”。持续结果区显示“资料已保存”,详情采用 v2 新基准。用户没有请求导航时不因回执抢焦点;变化通过适当状态通知可感知。新基准必须来自回执/可信读取,不从按钮点击自行加版本号。
  7. 用户激活“返回清单”。核查仍有权限且 R-001 仍在该查询后,恢复原查询及 R-001 的合理位置。Web 本例固定将焦点回到仍有效的 R-001 名称入口;原生按导航返回机制恢复可理解的记录定位,并验证辅助技术路径。如果行不再存在、授权变化或已有新任务接管,改按导航/LP-G05 合同处理,不无条件回焦。

这次走读只有一次已发写事件。步骤 4 被拒绝的尝试不是保存失败回执,步骤 3 接受分类不是保存成功,步骤 6 的新基准不是业务审批通过。服务、辅助技术、键盘和四端走读均未实际运行。

4. 推荐与禁止:同一画面也可能是不同任务

4.1 普通编辑不是状态决定

推荐:表单中的“保存资料”使用 D03 普通主操作职责;取消或返回为次要入口。字段错误有文字与关联提示,焦点和错误同时存在。

禁止:因为预期成功而把保存永久设为 success;把只读字段染成 failure;把焦点色当业务选中状态。七角色与固定 step、浅深主题沿Token 契约、主题与状态/色彩语义与可辨状态,三文字角色各九档沿排版层级与文字可读性。本例不新增颜色、字号、间距或命中数值。

4.2 需要参照时保留上下文,不制造层层确认

推荐:简单说明在字段附近;短暂查找用独立值帮助;长资料用明确详情/参照页。手机可顺序打开后返回原稿,宽窗可侧区阅读。子任务有自己的接受/取消边界。

禁止:编辑弹窗内再弹全量详情、再弹筛选、再弹确认;用连续浮层避免页面导航。确需受控子层时继承 CMP-LAYER,而不是任意叠层。背景动作不可穿透,外点、返回手势和 Escape 都不能绕过未保存保护。

4.3 “可见”“可改”“可提交”独立判断

推荐:可读不可改时展示只读详情;仅部分字段可改时明确字段范围;可改但当前提交条件未满足时说明阻塞和真实下一步。

禁止:把只读内容全部改成不可读禁用输入;以“管理员”标签替代逐项能力;对本不允许知道存在的对象显示名称及“申请权限”。本例只在夹具明确允许时展示原因或请求路径。

5. 必备异常分支:状态不是一组颜色

注入条件 应看到与可做 不能做 核查点
清单确实无记录 创建等入口仅在真实具备时提供 捏造可创建权限 FB-EMPTY
筛选无结果 展示已应用条件,可修改/清除 把空结果说成读取失败 QRY-SEARCH
列表刷新失败但仍可披露旧数据 明示旧数据与失败范围,允许真实读取重试 把旧数据当最新,或混用新标题旧操作 CT-LIST、FB-BANNER
保存前字段拒绝 错误摘要与字段定位;保留原始稿 清空不完整金额,拿旧合法值提交 DSP-MESSAGE-SUMMARY
写入已发但结果未知,查询能力开 保持 T1 未知,只查询原任务结果 无条件“再保存一次” 异步恢复主档
写入已发但结果未知,查询能力关 说明无法确认;保留获准任务信息及真实退出路径 画可用“查询任务”或承诺后台跟踪 D06 能力开关
仅撤写权,读权仍有效 获准内容只读,停止新写;允许稿按政策处理 断言已发 T1 自动取消 权限主档
撤读权 停止披露受限值及应用可控缓存/辅助文本 仅盖遮罩,或建议导出受限原稿 YUDS-120200-01
v1 期间出现 v2 提示基准变化,获准原稿保留,按真实能力比较重填 静默覆盖或默认提供强制保存 YUDS-120200-02
用户已转向 R-002,T1 迟到成功 按 T1 归属保存可披露结果,不夺新任务焦点 把 R-002 标成保存成功 LP-G05、异步恢复主档
返回后 R-001 离开筛选 说明变化且维持查询;必要时给获准定位 偷改筛选以维持旧行,或显示旧状态 导航主档

关闭仅终止呈现。请求能否取消、结果是否可核查以及何种输入可保留,由明确服务与权限能力决定;没有能力就是限制,不用更精美的反馈补造能力。

6. 四端同任务,不同呈现

具体组件逐项选型见组件平台选型:先定任务,再定呈现;以下为本例 YUDS 默认建议,不是平台强制规则。

  • Web:清单+详情路由;空间足够时可非模态侧区阅读。编辑默认独立内容页,短选择才用锚定层。真实列关系采用表格,不因可点击就变成网格。
  • iOS/iPadOS:窄内容区域按清单→详情→编辑顺序;短、相关的选择任务可用 sheet,宽内容区可用锚定 popover。完整多字段编辑不塞进小 popover。原生返回与显式取消共享离开保护,不要求模仿 Web 键位。
  • Android:窄窗顺序清单/详情,宽窗可列表详情双区;短选择可用模态 bottom sheet,长编辑用完整页面。系统返回先经过当前任务的关闭/离开仲裁。
  • HarmonyOS:同样设计清单→详情→编辑的任务路径;首选候选为完整页面和内联表单,具体原生组件、系统返回、辅助技术与浮层映射仍待官方及目标版本核实。不能把 Android sheet 行为当已证实替代。

所有端都要覆盖长名称、最大目标文字、软键盘、RTL、替代输入与授权变化。窗口变化不得重复创建保存任务,旧浮层迟到回调不能写入新页面。布局切换属于呈现变化,不是提交或授权变化。

7. 接入交付卡:把建议变成可验证实例

交付者填写以下内容;缺项就写“待补”,不能用本例推断生产能力:

  1. 真实对象、范围、字段、稳定身份和并发基准;说明哪些 D06 字段在真实任务不适用。
  2. 读取、修改、提交、披露和输出权限来源;撤权后草稿处理规则。
  3. 保存是否原子、请求标识、可信回执、查询开关、取消能力;未知结果恢复路径。
  4. 当前查询、已选集合、详情对象、父草稿与子选择会话的独立状态所有者。
  5. 每个平台的布局/原生控件候选、模态性、返回/关闭、焦点恢复和不适用说明。
  6. 至少运行正常闭环、字段拒绝、查询开/关的未知结果、撤写/撤读、基准变化、迟到回执及增长/替代输入组合。
  7. 分别附文档审查、设计、实现、运行与视觉证据;尚无证据时均保留未执行/未验证,不把“已写用例”计为通过。

退出本例的条件

已能说明各状态来源、所有动作真实边界以及受限时的替代路径,方可进入下一阶段设计。这里没有宣布达到该条件;设计暂停不因文档补齐自动解除。

相关页面:端到端任务旅程与验收案例、组件平台选型:先定任务,再定呈现、质量基线、门禁与验收证据。