交互与用户体验 / 系统课时
将交互触发条件写成状态规格
将交互触发条件写成状态规格
原型能展示按钮和页面,却难以说明何时允许点击、请求超时后如何处理、重复操作是否会创建多笔申请。本篇以订单退款为例,将操作拆成当前状态、触发事件、前置条件、状态变化和界面反馈,形成开发能实现、测试能验收的状态规格。
学习目标
- 将一次交互写成可判定的事件、条件、状态迁移与反馈。
- 为成功、校验失败、重复点击和网络超时分别指定处理路径。
- 使用状态图和验收用例检查规格是否存在遗漏或歧义。
确定状态与业务边界
以已支付 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 秒后断网或超时 | 输入和幂等键未丢失;不自动重试,不误报失败 |
| 查询明确确认未创建后重试 | 请求内容未变则沿用同一键;重新锁定按钮并显示提交反馈 |
最后还要把错误文案、按钮禁用时机、焦点落点和状态播报写进交付稿。例如字段错误聚焦对应输入框;转入“结果待核实”时播报“尚未确认提交结果,可查询申请状态”。如果后端无法按幂等键核实申请是否创建,就不能设计“超时后一键重新提交”,应保留待核实状态与人工查询入口。