架构与系统设计 / 系统课时
用真实业务场景回放模型
用真实业务场景回放模型
领域模型画完并不代表边界正确,最有效的检查方式之一是拿真实业务场景重新“走一遍”。本节用创建、支付、取消和异常路径回放订单模型,观察每一步由谁负责、状态是否可达、规则是否被守住,并据此发现职责遗漏和边界错误。
学习目标
- 能把业务场景拆成命令、聚合状态变化、领域事件和外部协作
- 能通过正常与异常路径检查订单模型的职责和状态约束
- 能根据回放暴露的问题调整聚合边界,而不是只补条件判断
先固定本次回放规则
回放之前必须明确业务假设,否则同一个场景会得到互相冲突的结论。本练习采用一组最小规则:新订单初始为待支付;待支付订单可以取消;订单一旦确认支付,不再直接执行“取消”,而应进入退款流程;已取消订单不能再次确认支付。
这些规则只是练习假设,不是所有业务的通用答案。真正项目中应让领域专家确认“支付后能否取消”“取消与退款是否同一动作”等规则,再据此建模。

按主路径逐步回放
回放时不要只问“代码能不能执行”,而要记录每一步的业务输入、负责对象、状态变化和可观察结果。下面的最小 Python 模型把这四类场景串起来,目的是验证状态规则是否自洽。
from dataclasses import dataclass, field
from enum import Enum
class OrderStatus(Enum):
PENDING_PAYMENT = "PENDING_PAYMENT"
PAID = "PAID"
CANCELLED = "CANCELLED"
@dataclass
class Order:
order_id: str
status: OrderStatus = OrderStatus.PENDING_PAYMENT
events: list[str] = field(default_factory=list)
@classmethod
def create(cls, order_id: str) -> "Order":
order = cls(order_id)
order.events.append("OrderCreated")
return order
def confirm_payment(self) -> None:
# 支付确认只能作用于仍然待支付的订单。
if self.status is OrderStatus.CANCELLED:
raise ValueError("cancelled order cannot be paid")
if self.status is OrderStatus.PAID:
raise ValueError("order already paid")
self.status = OrderStatus.PAID
self.events.append("OrderPaymentConfirmed")
def cancel(self) -> None:
# 本练习约定:已支付订单必须转入退款流程,而不是直接取消。
if self.status is OrderStatus.PAID:
raise ValueError("paid order must use refund flow")
if self.status is OrderStatus.CANCELLED:
raise ValueError("order already cancelled")
self.status = OrderStatus.CANCELLED
self.events.append("OrderCancelled")
paid_order = Order.create("O-1001")
print(paid_order.order_id, paid_order.status.value, paid_order.events)
paid_order.confirm_payment()
print(paid_order.order_id, paid_order.status.value, paid_order.events)
try:
paid_order.cancel()
except ValueError as error:
print("ERROR", error)
cancelled_order = Order.create("O-1002")
cancelled_order.cancel()
print(cancelled_order.order_id, cancelled_order.status.value, cancelled_order.events)预期输出:
O-1001 PENDING_PAYMENT ['OrderCreated']
O-1001 PAID ['OrderCreated', 'OrderPaymentConfirmed']
ERROR paid order must use refund flow
O-1002 CANCELLED ['OrderCreated', 'OrderCancelled']这段回放验证了三件事:创建后有明确初始状态;支付和取消都会产生可观察的业务事实;非法转换不会悄悄修改聚合状态。实际项目中的事件对象会比字符串更正式,但检查方法相同。
用异常场景攻击模型边界
正常路径只能证明模型“能工作”,异常路径才能暴露边界是否合理。至少要补做重复支付、重复取消、取消后再支付、支付后直接取消等场景,并明确期望是幂等、拒绝还是转交其他流程。
如果“支付后取消”需要同时修改订单、创建退款单、调用支付渠道并发送通知,就不要把所有职责塞进 Order.cancel()。这通常说明应用服务需要编排多个边界,或者“退款”本身属于另一个聚合甚至另一个限界上下文。聚合负责守住自身不变量,不负责吞下整条业务流程。
把回放结果变成模型修改
每发现一个问题,都要先判断它属于哪一类,而不是立即增加 if。状态不可表达,说明缺少状态或概念;一个方法需要跨多个聚合改数据,说明职责可能越界;同一规则散落在多个服务里,说明不变量没有被正确收拢;事件消费者需要读取订单内部大量细节,说明边界或事件载荷可能需要调整。
完成修改后,应重新跑同一组场景。只有正常路径仍然成立、异常路径被明确拒绝或转交、每个状态变化都有唯一责任主体,模型才算通过这一轮回放。这样得到的领域模型不是“看起来合理”的类图,而是经业务行为验证过的规则系统。