架构与系统设计 / 系统课时
怎样从需求文档提取事件
怎样从需求文档提取事件
需求文档通常写的是流程、规则和系统行为,而不会主动列出领域事件。提取事件的关键不是圈出所有业务名词,而是寻找“前后有什么业务事实发生了变化”,再把这些变化改写成可排列在时间线上的事件。
学习目标
- 从需求描述中识别订单、支付、库存和退款等关键状态变化
- 区分领域事件、待执行动作和普通业务数据
- 将候选事件整理成可供业务人员校验的时间线
先找变化,不要先找名词
阅读需求时,很容易先看到「订单」「库存」「支付」「退款」这些名词,但名词只能告诉你业务中有哪些对象,不能直接说明发生了什么。真正值得提取为事件的是对象状态、责任或业务承诺发生变化的时刻。
例如需求写道:
用户提交订单后,系统检查商品库存。库存满足时预留商品并等待付款。用户付款成功后订单进入待发货状态;如果付款超时,则释放已预留的库存。已付款订单在允许的条件下可以申请退款。
其中「订单」「库存」和「付款」本身都不是事件。顺着变化寻找,可以得到「订单已提交」「库存已锁定」「支付已完成」「库存已释放」「退款申请已提交」等候选事件。
动作词可以作为线索,但不能直接照抄。需求中的「预留商品」更像系统要做的事情,真正留下的业务事实可以命名为「库存已锁定」。
按句子提取候选事件
可以把需求拆成较小的业务陈述,再询问每句话执行前后有什么事实发生变化。重点关注「提交后」「成功后」「超时」「审核通过」「取消」「完成」等表示状态转换或业务节点的词语。
| 需求描述 | 先识别的变化 | 候选领域事件 |
|---|---|---|
| 用户提交订单 | 订单从不存在变为已被业务接受 | 订单已提交 |
| 库存满足时预留商品 | 可售库存的一部分被占用 | 库存已锁定 |
| 用户付款成功 | 付款义务被履行 | 支付已完成 |
| 付款超时后释放库存 | 原有库存占用被解除 | 库存已释放 |
| 用户申请退款 | 新的退款处理过程开始 | 退款申请已提交 |

这里的目标不是一次就得到最终事件,而是先形成可讨论的候选集合。需求文档可能省略业务术语,也可能把多个变化压缩在一句话中,因此候选事件还需要经过时间线和业务人员验证。
把候选事件排进时间线
领域事件具有时间含义。把候选事件按典型业务流程排列,可以快速发现遗漏、重复和错误粒度。例如一个正常支付流程可能暂时整理为:
- 订单已提交。
- 库存已锁定。
- 支付已完成。
- 订单已进入履约过程。
付款超时则会形成另一条分支,在「库存已锁定」之后出现「支付已超时」和「库存已释放」。退款也通常不是正常下单主线中的下一个固定步骤,而是在满足条件时从已付款或已履约状态进入另一段流程。
如果某个候选名称放进时间线后不像“已经发生的事情”,它很可能仍是命令。例如「释放库存」应继续追问执行结果,并改成「库存已释放」。如果两个事件无法判断先后,也要确认它们究竟是独立事实,还是同一事实的两种说法。
合并、拆分和过滤候选事件
第一次提取通常会得到过多候选项。整理时需要根据业务意义做三种处理。
合并同义事件。 文档不同章节可能分别写「付款成功」「交易支付完成」「订单完成付款」。如果业务上指向同一个事实,应统一术语,避免时间线上出现伪造的多个步骤。
拆分会触发不同规则的变化。 「退款处理完成」可能掩盖了「退款已批准」和「退款已完成」两个节点。前者表示业务批准,后者表示资金已经退回;如果它们触发不同后续行为,就应保留为不同事件。
过滤没有业务意义的技术动作。 「写入订单表」「调用库存 API」「发送 Kafka 消息」通常是实现细节。除非业务规则直接依赖这个技术事实,否则不应把它与「订单已提交」「库存已锁定」并列在领域事件时间线上。
回到业务语境确认事件
需求文档只能作为事件发现的入口,不能代替业务确认。文档经常缺少异常分支、人工操作和默认规则,例如支付成功但库存锁定失败、退款被拒绝、订单由客服取消等情况,都可能需要在讨论中补充。
校验每个候选事件时,可以询问“什么触发了它”“发生后谁会关心”“是否存在失败或撤销路径”。如果「支付已完成」发生后仓库会开始履约,它显然是重要业务事件;如果某个变化发生后没有任何业务角色、规则或后续流程关心,则应重新判断它是否值得进入领域模型。
最终得到的不是需求文档的逐句翻译,而是一条由业务事实组成的时间线。它把订单、支付、库存和退款等分散描述转换成可讨论的状态变化,为后续识别命令、策略、角色以及领域边界提供稳定依据。