架构与系统设计 / 系统课时
阅读订单需求并提取业务术语
阅读订单需求并提取业务术语
领域建模的第一步不是画类图,而是从需求原文中找出业务人员真正关心的概念。本节以订单场景为例,把订单、商品、金额、优惠、支付等表达整理成候选领域术语,并区分业务概念、属性和动作。
学习目标
- 能从需求描述中识别有业务含义的候选术语
- 能区分领域对象、属性、动作与技术词汇
- 能整理一份可继续用于建模讨论的术语表
从需求原文开始提取概念
假设收到下面这段需求:
用户选择商品和购买数量后提交订单。系统按当前商品价格计算商品金额,并应用可用优惠。订单生成后,用户需要在规定时间内完成支付;支付成功后订单进入已支付状态。若支付前商品价格发生变化,需要提示用户重新确认。
第一次阅读时,不要立即决定哪些词必须设计成实体或值对象。先圈出反复出现、会参与业务判断或需要保存状态的词,例如:用户、商品、购买数量、订单、商品价格、商品金额、优惠、支付、订单状态。
同时记录动词。提交、计算、应用、支付、确认等动作虽然通常不会直接变成领域对象,却能帮助发现对象承担的行为,以及后续需要梳理的业务流程。
不要把所有名词都变成实体
候选术语需要继续分类。一个简单判断方法是询问:这个概念是否具有独立身份、是否需要记录生命周期,还是仅用于描述另一个对象。
| 需求表达 | 候选术语 | 初步分类 | 判断依据 |
|---|---|---|---|
| 订单 | 订单 | 领域对象 | 有订单编号,并经历创建、支付、取消等状态变化 |
| 商品 | 商品 | 领域对象 | 有独立商品标识,可被多个订单引用 |
| 购买数量 | 数量 | 属性或值 | 描述某个订单商品购买多少件 |
| 商品价格 | 单价 | 值概念 | 参与金额计算,本身通常不靠独立身份区分 |
| 商品金额 | 金额 | 值概念 | 由价格与数量计算得到 |
| 优惠 | 优惠 | 候选领域概念 | 存在资格、额度或适用范围等业务规则 |
| 支付 | 支付 | 候选领域对象或过程 | 需要根据支付业务进一步判断是否具有独立编号和生命周期 |
| 订单状态 | 订单状态 | 状态值 | 描述订单当前所处阶段 |
这里的分类只是建模前的假设。例如支付在简单系统中可能只是订单上的一次操作,在需要处理多次支付尝试、退款和支付流水时,则很可能具有自己的身份与生命周期。
用业务语言消除同词异义
需求中的词不能只看字面。团队需要进一步确认每个词在当前业务中的准确含义,否则同一个术语可能被不同角色理解成不同东西。
以金额为例,商品金额可能表示所有订单行的原价合计,也可能已经扣除商品级优惠;订单金额还可能包含运费。建模前应把这些含义明确命名,例如商品原价合计、优惠金额、应付金额,而不是全部简称为金额。
对每个关键术语至少确认三个问题:它表示什么业务事实,由谁产生或修改,哪些规则会使用它。无法回答这些问题的词,暂时保留为候选项,不急着放进领域模型。
排除实现细节造成的干扰
需求文档经常混入数据库表、接口字段、缓存、消息队列等实现词汇。例如订单写入 order_info 表只是实现方式,不能因此把 order_info 当作领域术语。领域术语应该来自业务含义,而不是当前代码或数据结构的名字。
类似地,price_cents 可能是接口字段,但领域语言仍然应该表达为商品单价或金额。技术命名可以在后续设计阶段映射到领域概念,不能反过来主导业务模型。
形成可以继续讨论的术语表
完成第一轮提取后,可以得到一组候选术语:订单、订单商品、商品、数量、单价、商品金额、优惠、优惠金额、应付金额、支付、订单状态。此时还不需要确定聚合边界或类结构,重点是让业务、产品和研发对这些词的含义形成一致理解。
一份合格的术语表应当能够回到原始需求中解释业务,而不是只罗列名词。后续梳理下单流程时,如果出现库存、价格快照、支付期限等新概念,再把它们补充进术语表,并持续修正已有定义。