浏览 AI 知识库

写代码前先定信息架构、页面状态和异常路径

只画登录后的理想页面,开发到最后一定会补空状态、失败状态和权限分支。先把页面、状态和异常路径列全,接口与组件才有稳定边界。

沿完整工作流推进

前一阶段的可检查结果,是下一阶段的输入;中间证据不足时停在当前阶段。

  1. 01设计稿只有成功页面,真正开发时还会遇到哪些状态
  2. 02先确认这次任务的起点、边界和交付
  3. 03从“列用户任务和入口”走到“用主流程走一遍”
  4. 04订单列表不能只设计‘有数据’这一格
  5. 05完成后的页面清单与状态矩阵
沿一件真实任务走到底

设计稿只有成功页面,真正开发时还会遇到哪些状态

设计稿只有登录成功后的看板。开发完成后才发现还缺未登录、首次空数据、加载失败、无权限和会话过期,排期被迫重估。

  • 关键页面都有加载、空、错误和权限状态
  • 状态转移可以从入口走通
  • 接口状态与页面文案一致
本例材料

先确认这次任务的起点、边界和交付

需要确认本例内容
现有材料产品包含登录、项目列表和项目详情三页;角色为成员与管理员;接口可能返回 401、403、404 和 500。
不能越过的边界先列页面、状态和转移,再做视觉;错误状态必须给用户下一动作;权限由后端验证。
要交付的结果页面清单与状态矩阵
处理记录

从“列用户任务和入口”走到“用主流程走一遍”

当前阶段实际处理
列用户任务和入口按用户目标而不是部门或数据库表组织导航,标明主要入口和返回路径。
画页面与数据关系每个页面写核心对象、主要动作、来源和去向,删除没有任务的展示页。
补全常规状态加载、空、部分数据、成功、校验错误、系统错误和离线各自定义可见反馈。
补权限与危险动作未登录、无权限、只读、删除、付款和发布要有阻止、解释和确认路径。
用主流程走一遍从首次进入到完成任务逐屏检查返回、刷新、重复提交和中断恢复。
状态矩阵示例

订单列表不能只设计‘有数据’这一格

状态触发用户看到允许动作验收
加载首次进入或刷新骨架和当前筛选取消请求不闪出旧数据
空无订单说明原因和创建入口新建订单不显示无意义分页
部分失败列表成功、统计失败列表可用,统计区标注失败重试统计不阻断主任务
无权限接口 403说明需要联系管理员返回上一层不暴露资源存在性
重复提交同一订单连续点击按钮进入处理中取消或等待只创建一条记录
最终输出

完成后的页面清单与状态矩阵

状态矩阵为每页列加载、空、成功、部分失败、无权限与会话过期;导航图标出登录回跳和详情不存在。项目列表空状态带创建权限判断,403 不再伪装成 404。

常见失败

为什么“状态列齐了,用户仍会走进死路”还不能交付

状态列齐了,用户仍会走进死路

原因
只描述页面样子,没有下一动作和转移
怎么改
为每个状态写可执行操作、目标页面和无法恢复时的退出路径
验收方式

页面清单与状态矩阵通过哪些检查才算完成

进一步核对

从零做项目:参考资料与核对入口