一、用例描述是啥?—— 用例图的“文字说明书” 📖

关键字:用例描述、what而非how、事件流

📌

用例图是“功能的漫画”,

用例描述就是“漫画的文字脚本”

——它讲清楚“这个用例是做啥的、谁来用、怎么用”,但

不写“系统内部怎么实现”

(比如不写“用Java还是Python开发”)。

💡 新手类比:

就像点外卖的“操作说明”:只写“打开APP→选餐→付款→等配送”,不写“APP后台怎么调接口、怎么算配送费”。

二、用例描述的“标配内容”:一个都不能少 ✅

关键字:用例名称、参与者、触发器、前置/后置条件、事件流

📋 核心组成(以“提交订单”为例):

  • 🔤用例名称:比如“提交订单”(动词短语,说清楚干啥);
  • 👫参与者:比如“会员”(谁用这个功能);
  • 🚨触发器:“当用户点击‘提交订单’按钮时”(啥时候触发这个用例);
  • 🔑前置条件:“用户已登录且购物车有商品”(用例执行前必须满足的条件);
  • 🏁后置条件:“订单生成并扣减库存”(用例执行后的结果);
  • 🔄事件流:用例的“操作步骤”(最核心的部分!)。

三、事件流:用例的“操作剧本” 🎬

关键字:基本事件流、扩展事件流、快乐路径

  1. 基本事件流:“一帆风顺”的操作 ✨

也叫“快乐路径”——描述

没出任何问题的理想流程

,用编号写步骤。比如“提交订单”的基本事件流:

  1. 会员在购物车点击“提交订单”; 2. 系统验证会员信息和商品信息; 3. 系统检查商品库存; 4. 系统计算订单总价; 5. 系统从会员账户扣减金额; 6. 系统生成订单并发送给仓库; 7. 系统显示“订单提交成功”页面。

  2. 扩展事件流:“出意外”的应对方案 ⚠️

描述

异常/分支情况

,比如“库存不足”“账户余额不够”,用“A-编号”区分。比如:

A-1 若商品库存不足: 1. 系统提示“商品XXX库存不足”; 2. 用例终止,会员需修改订单。

四、补充约束:用例的“隐形规则” 📜

关键字:数据需求、业务规则、非功能需求

📌

除了“怎么操作”,还要写用例的“规则”——比如:

  • 📊数据需求:“订单信息包含订单号、商品列表、金额”;
  • 📏业务规则:“只有商品信息确认无误后,才能要求支付”;
  • 非功能需求:“订单提交响应时间不超过2秒”。

五、用例文档:把描述“打包”成正式文件 📁

关键字:用例文档、标准化模板

📚

把上面的内容整理成“标准化文档”,就是用例文档——比如课本里“提交订单”的用例文档(表4-2),是团队沟通的“统一手册”(产品、开发、测试都看这个)。

💡 新手提醒:

写用例描述时,

别写界面细节

(比如“点击红色的提交按钮”)——因为界面可能改,但“提交订单”的流程不会变~

总结:用例描述是“需求的统一语言” 🗣️

🎉

用例描述解决了“产品说的功能,开发听不懂”的问题——它用“业务语言”写清楚功能的“谁、做啥、咋做”,让所有人对“需求”的理解保持一致~