一、用例描述是啥?—— 用例图的“文字说明书”📖
关键字:用例描述、what 而非 how、事件流
📌
用例图是“功能的漫画”,用例描述就是“漫画的文字脚本”——它讲清楚“这个用例是做啥的、谁来用、怎么用”,但 不写“系统内部怎么实现”(比如不写“用 Java 还是 Python 开发”)。
💡 新手类比:
就像点外卖的“操作说明”:只写“打开 APP→选餐→付款→等配送”,不写“APP 后台怎么调接口、怎么算配送费”。
二、用例描述的“标配内容”:一个都不能少 ✅
关键字:用例名称、参与者、触发器、前置 / 后置条件、事件流
📋 核心组成(以“提交订单”为例):
- 🔤用例名称:比如“提交订单”(动词短语,说清楚干啥);
- 👫参与者:比如“会员”(谁用这个功能);
- 🚨触发器:“当用户点击‘提交订单’按钮时”(啥时候触发这个用例);
- 🔑前置条件:“用户已登录且购物车有商品”(用例执行前必须满足的条件);
- 🏁后置条件:“订单生成并扣减库存”(用例执行后的结果);
- 🔄事件流:用例的“操作步骤”(最核心的部分!)。
三、事件流:用例的“操作剧本”🎬
关键字:基本事件流、扩展事件流、快乐路径
1. 基本事件流:“一帆风顺”的操作 ✨
也叫“快乐路径”——描述 没出任何问题的理想流程,用编号写步骤。比如“提交订单”的基本事件流:
1. 会员在购物车点击“提交订单”;
2. 系统验证会员信息和商品信息;
3. 系统检查商品库存;
4. 系统计算订单总价;
5. 系统从会员账户扣减金额;
6. 系统生成订单并发送给仓库;
7. 系统显示“订单提交成功”页面。
2. 扩展事件流:“出意外”的应对方案 ⚠️
描述 异常 / 分支情况,比如“库存不足”“账户余额不够”,用“A- 编号”区分。比如:
A-1 若商品库存不足:
1. 系统提示“商品 XXX 库存不足”;
2. 用例终止,会员需修改订单。
四、补充约束:用例的“隐形规则”📜
关键字:数据需求、业务规则、非功能需求
📌
除了“怎么操作”,还要写用例的“规则”——比如:
- 📊数据需求:“订单信息包含订单号、商品列表、金额”;
- 📏业务规则:“只有商品信息确认无误后,才能要求支付”;
- ⚡非功能需求:“订单提交响应时间不超过 2 秒”。
五、用例文档:把描述“打包”成正式文件 📁
关键字:用例文档、标准化模板
📚
把上面的内容整理成“标准化文档”,就是用例文档——比如课本里“提交订单”的用例文档(表 4 -2),是团队沟通的“统一手册”(产品、开发、测试都看这个)。
💡 新手提醒:
写用例描述时,别写界面细节(比如“点击红色的提交按钮”)——因为界面可能改,但“提交订单”的流程不会变~
总结:用例描述是“需求的统一语言”🗣️
🎉
用例描述解决了“产品说的功能,开发听不懂”的问题——它用“业务语言”写清楚功能的“谁、做啥、咋做”,让所有人对“需求”的理解保持一致~