交互与用户体验 / 系统课时

将交互触发条件写成状态规格

将交互触发条件写成状态规格

原型能展示按钮和页面,却难以说明何时允许点击、请求超时后如何处理、重复操作是否会创建多笔申请。本篇以订单退款为例,将操作拆成当前状态、触发事件、前置条件、状态变化和界面反馈,形成开发能实现、测试能验收的状态规格。

学习目标

  • 将一次交互写成可判定的事件、条件、状态迁移与反馈。
  • 为成功、校验失败、重复点击和网络超时分别指定处理路径。
  • 使用状态图和验收用例检查规格是否存在遗漏或歧义。

确定状态与业务边界

以已支付 168 元的订单申请部分退款为例:用户填写退款金额 80 元、原因“商品破损”,点击“提交申请”。金额必须大于 0 且不超过该订单当前可退金额;本例暂按 168 元计算,实际可退额度仍由服务端最终校验。

先约定五个互斥的页面主状态,字段错误提示属于“编辑中”的局部状态,不必另建一个页面状态。

页面状态 可见内容与允许操作
编辑中 金额与原因可修改;点击提交时校验字段
提交中 锁定提交入口;保留输入并显示“正在提交”
结果待核实 不宣称成功或失败;提供“查询申请状态”
已受理 展示受理编号与“申请已提交,等待审核”
可重试 仅在服务端明确确认未创建申请后开放重试

还需在规格中记录订单标识、退款金额、原因、submissionKey(本项目拟约定的幂等键)和受理编号。同一个 submissionKey 只能关联同一份请求内容;修改退款金额或原因后,必须使用新键。后端需要约定按键查询结果及去重有效期,例如 24 小时,而不是由界面单方面假定。

按触发事件填写状态转移表

每条规则都回答五件事:当前处于什么状态、发生什么事件、满足什么条件、转入哪里、用户看到什么。条件不同的同一次点击应拆成独立规则,不写“提交失败后提示错误”这种无法验收的描述。

当前状态 触发事件与前置条件 下一状态 动作与反馈
编辑中 点击提交;金额为 180 元,超过可退 168 元 编辑中 聚焦金额输入框,提示“最多可退 168 元”;不发送请求
编辑中 点击提交;金额 80 元、原因非空且本地校验通过 提交中 先生成并保存 submissionKey,再发起请求;立即禁用重复提交
提交中 再次点击或按 Enter 触发提交 提交中 忽略重复事件,不再发送请求
提交中 服务端确认申请已创建,并返回受理编号 已受理 显示“申请已提交,等待审核”及受理编号
提交中 服务端明确返回字段校验不通过 编辑中 保留输入,标明具体字段;修改内容后重新生成键
提交中 8 秒内未收到可确认结果,或连接中断 结果待核实 保留表单与原键;提示“正在核实提交结果”,禁止盲目重发
结果待核实 查询确认该键对应申请已创建 已受理 显示查询到的受理编号,不新建申请
结果待核实 服务端明确确认该键未创建申请 可重试 开放重试;请求内容未变时沿用原键
结果待核实 查询仍无法确定是否创建 结果待核实 告知状态尚未确认,保留查询与人工处理入口
可重试 用户点击重试,且请求内容未修改 提交中 沿用原键重新提交,并再次锁定提交入口

表中的 8 秒是本案例约定的结果等待阈值,并非所有产品通用。前端应在点击后立即更新按钮状态;服务端返回 HTTP 成功码也不应自动解释为退款完成,必须以约定的“申请已创建”业务结果为准。

用状态图核对分支

画图时把页面状态画成节点,把事件与条件写在连线上。重点检查三类容易漏掉的路径:重复点击是否留在原状态,超时是否先核实结果,以及服务端迟到的成功回执能否将同一 submissionKey 的“结果待核实”更新为“已受理”。

退款申请触发条件与状态迁移图

还要规定异步响应的归属:只处理与当前订单和 submissionKey 匹配的结果;用户修改表单生成新键后,旧请求的迟到响应不得覆盖新表单或被当作新申请回执。网络超时表示结果未知,不等于申请失败。

将规格转成开发验收项

交付时附上以下最小验收表。设计、前端、后端与测试应对“已创建”“明确未创建”“状态未知”的服务端判定口径达成一致。

测试情境 可检查的预期结果
输入 180 元后提交 出现金额错误,焦点回到金额框;请求次数为 0
输入 80 元并连续触发提交 3 次 界面只进入一次提交中;前端发送 1 次请求,服务端至多创建 1 笔申请
收到明确的申请创建回执 展示实际受理编号与“等待审核”,不显示“退款已到账”
等待 8 秒后断网或超时 输入和幂等键未丢失;不自动重试,不误报失败
查询明确确认未创建后重试 请求内容未变则沿用同一键;重新锁定按钮并显示提交反馈

最后还要把错误文案、按钮禁用时机、焦点落点和状态播报写进交付稿。例如字段错误聚焦对应输入框;转入“结果待核实”时播报“尚未确认提交结果,可查询申请状态”。如果后端无法按幂等键核实申请是否创建,就不能设计“超时后一键重新提交”,应保留待核实状态与人工查询入口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

将交互触发条件写成状态规格

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通