初入职场:把“做个列表”拆成可验收任务

需求写成“做个订单列表”,开发和验收可能各自理解成不同东西。

edyang · 2014-01-15

需求写成“做个订单列表”,开发和验收可能各自理解成不同东西。任务边界需要在动手之前具体化。

本文使用Java Web 小项目的演示工程与协作场景。初入团队时,重要的不只是写出功能,还包括让别人能够复现、审查和接手。本文使用匿名任务说明工作方法,不指代某家公司的内部流程或真实交付成绩。

1. 从现象推到机制

列表至少涉及谁能看、显示什么、怎样排序、如何筛选和空结果怎么表达。页面组件只是结果载体,数据权限和金额口径才决定内容是否正确。把加载失败与没有数据区分,也能减少后续误报。

初入职场:把“做个列表”拆成可验收任务的处理、反馈与观察关系

图中的四个节点分别表示需求描述、条件清单、演示输入、验收反馈。顺着实线检查输入如何变成输出,再沿虚线核对反馈条件。图示表达的是本文讨论的关系,不是实测曲线或现场截图。

2. 最小实现与输入条件

先给每个条件写一个输入与预期结果,演示数据覆盖不同权限和状态。只做本轮确认的字段,不把未来可能需要的功能自动纳入。

1
2
3
4
5
role: own_orders_only
columns: number, amount, status
sort: created_at DESC, id DESC
empty: explicit empty message
error: retry entry with no fake rows

示例命令需要在独立演示工程中执行,路径和服务均由读者准备。操作前保留当前版本与输入,修改后对照原来的问题验证,而不是只证明新代码能够编译。

3. 用对照区分原因

下表列出需要主动改变的条件。预期行为来自机制分析,复现时还需记录运行环境和原始输出,不能将预期当作已经测得的结果。

改变的条件 需要验证的行为
普通用户查询别人的订单 结果不得越过数据权限
相同创建时间有多条记录 翻页仍保持稳定顺序
接口返回错误 页面不能显示成没有订单

对照 1:普通用户查询别人的订单

结果不得越过数据权限。观察时记录服务端查询条件而非隐藏按钮。把这个条件与基准情形分开,有助于判断变化来自哪一层;若得到相反结果,应先核对前提,再修改实现。

对照 2:相同创建时间有多条记录

翻页仍保持稳定顺序。观察时记录排序是否含唯一的次级键。把这个条件与基准情形分开,有助于判断变化来自哪一层;若得到相反结果,应先核对前提,再修改实现。

对照 3:接口返回错误

页面不能显示成没有订单。观察时记录错误状态与空结果分支。把这个条件与基准情形分开,有助于判断变化来自哪一层;若得到相反结果,应先核对前提,再修改实现。

4. 适用条件与取舍

验收条件要以业务行为描述,避免绑定某个实现类。实现方式可以调整,只要权限、输入输出和约定体验保持可验证。

一次正常运行只覆盖了这组输入。继续扩展前,应把上面的异常对照保留下来,尤其关注“接口返回错误”这一分支。后续方案若改变了图中任意一处依赖,原来的判断就要重新验证,不能仅凭界面相似或返回值相同沿用结论。

同月延伸

参考资料

  1. Maven 3.1.1 文档
  2. Spring Framework 3.2.6 参考文档