软件工程课程设计中,用例图和需求说明常常各写各的:图上有一堆椭圆,文档里却只有几句功能描述。评审时老师问“这个用例的触发条件是什么”,团队一时答不上来。要让两者对齐,第一步不是画图,而是先统一参与者。把使用系统的人、外部系统或定时任务列成清单,标明每个参与者的目标和边界。参与者不清,后面的用例很容易把后台任务、管理员操作和普通用户行为混在一起。
第二步是控制用例粒度。用例应围绕一个可观察的目标,而不是把每个按钮或每个页面都画成用例。可以用“参与者为了什么目标,触发什么动作,系统给出什么结果”来检验。如果一个用例内部包含多个彼此独立的目标,就拆开;如果两个用例只是同一流程的分支,就合并或用扩展关系表达。需求说明中要为每个用例保留唯一编号和名称,确保图与文能互相检索。
第三步是把主流程和异常流程写清楚。需求说明不能只写“系统显示结果”,还要交代前置条件、触发事件、基本流程、异常情况和后置状态。比如输入不完整、权限不足、外部服务超时分别怎么处理。用例图不必画出所有细节,但需求说明要能支撑后续设计和测试。这样课程设计中的界面原型、数据库表和测试用例才有依据,而不是凭感觉补。
第四步是建立验收标准。每个用例至少写出一条可验证的结果,说明什么情况下算完成。验收标准不必写成正式合同,但要能对应到测试场景。团队可以用一张简单追踪表,把用例编号、需求条目、原型页面和测试点连起来。评审前逐项检查:参与者是否都有目标,用例是否有唯一编号,异常流程是否有人负责,验收标准是否可观察。
最后,课程设计中的对齐不是追求文档厚度,而是减少返工。画完图后让不熟悉的同学按需求说明复述流程,如果复述与图不一致,就说明还有隐含假设。把这些问题在小组内先暴露出来,比在答辩时被追问更划算。