架构与系统设计 / 系统课时

怎样从需求文档提取事件

怎样从需求文档提取事件

需求文档通常写的是流程、规则和系统行为,而不会主动列出领域事件。提取事件的关键不是圈出所有业务名词,而是寻找“前后有什么业务事实发生了变化”,再把这些变化改写成可排列在时间线上的事件。

学习目标

  • 从需求描述中识别订单、支付、库存和退款等关键状态变化
  • 区分领域事件、待执行动作和普通业务数据
  • 将候选事件整理成可供业务人员校验的时间线

先找变化,不要先找名词

阅读需求时,很容易先看到「订单」「库存」「支付」「退款」这些名词,但名词只能告诉你业务中有哪些对象,不能直接说明发生了什么。真正值得提取为事件的是对象状态、责任或业务承诺发生变化的时刻。

例如需求写道:

用户提交订单后,系统检查商品库存。库存满足时预留商品并等待付款。用户付款成功后订单进入待发货状态;如果付款超时,则释放已预留的库存。已付款订单在允许的条件下可以申请退款。

其中「订单」「库存」和「付款」本身都不是事件。顺着变化寻找,可以得到「订单已提交」「库存已锁定」「支付已完成」「库存已释放」「退款申请已提交」等候选事件。

动作词可以作为线索,但不能直接照抄。需求中的「预留商品」更像系统要做的事情,真正留下的业务事实可以命名为「库存已锁定」。

按句子提取候选事件

可以把需求拆成较小的业务陈述,再询问每句话执行前后有什么事实发生变化。重点关注「提交后」「成功后」「超时」「审核通过」「取消」「完成」等表示状态转换或业务节点的词语。

需求描述 先识别的变化 候选领域事件
用户提交订单 订单从不存在变为已被业务接受 订单已提交
库存满足时预留商品 可售库存的一部分被占用 库存已锁定
用户付款成功 付款义务被履行 支付已完成
付款超时后释放库存 原有库存占用被解除 库存已释放
用户申请退款 新的退款处理过程开始 退款申请已提交

从需求描述提取领域事件的流程图

这里的目标不是一次就得到最终事件,而是先形成可讨论的候选集合。需求文档可能省略业务术语,也可能把多个变化压缩在一句话中,因此候选事件还需要经过时间线和业务人员验证。

把候选事件排进时间线

领域事件具有时间含义。把候选事件按典型业务流程排列,可以快速发现遗漏、重复和错误粒度。例如一个正常支付流程可能暂时整理为:

  1. 订单已提交。
  2. 库存已锁定。
  3. 支付已完成。
  4. 订单已进入履约过程。

付款超时则会形成另一条分支,在「库存已锁定」之后出现「支付已超时」和「库存已释放」。退款也通常不是正常下单主线中的下一个固定步骤,而是在满足条件时从已付款或已履约状态进入另一段流程。

如果某个候选名称放进时间线后不像“已经发生的事情”,它很可能仍是命令。例如「释放库存」应继续追问执行结果,并改成「库存已释放」。如果两个事件无法判断先后,也要确认它们究竟是独立事实,还是同一事实的两种说法。

合并、拆分和过滤候选事件

第一次提取通常会得到过多候选项。整理时需要根据业务意义做三种处理。

合并同义事件。 文档不同章节可能分别写「付款成功」「交易支付完成」「订单完成付款」。如果业务上指向同一个事实,应统一术语,避免时间线上出现伪造的多个步骤。

拆分会触发不同规则的变化。 「退款处理完成」可能掩盖了「退款已批准」和「退款已完成」两个节点。前者表示业务批准,后者表示资金已经退回;如果它们触发不同后续行为,就应保留为不同事件。

过滤没有业务意义的技术动作。 「写入订单表」「调用库存 API」「发送 Kafka 消息」通常是实现细节。除非业务规则直接依赖这个技术事实,否则不应把它与「订单已提交」「库存已锁定」并列在领域事件时间线上。

回到业务语境确认事件

需求文档只能作为事件发现的入口,不能代替业务确认。文档经常缺少异常分支、人工操作和默认规则,例如支付成功但库存锁定失败、退款被拒绝、订单由客服取消等情况,都可能需要在讨论中补充。

校验每个候选事件时,可以询问“什么触发了它”“发生后谁会关心”“是否存在失败或撤销路径”。如果「支付已完成」发生后仓库会开始履约,它显然是重要业务事件;如果某个变化发生后没有任何业务角色、规则或后续流程关心,则应重新判断它是否值得进入领域模型。

最终得到的不是需求文档的逐句翻译,而是一条由业务事实组成的时间线。它把订单、支付、库存和退款等分散描述转换成可讨论的状态变化,为后续识别命令、策略、角色以及领域边界提供稳定依据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

怎样从需求文档提取事件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通