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

用真实业务场景回放模型

用真实业务场景回放模型

领域模型画完并不代表边界正确,最有效的检查方式之一是拿真实业务场景重新“走一遍”。本节用创建、支付、取消和异常路径回放订单模型,观察每一步由谁负责、状态是否可达、规则是否被守住,并据此发现职责遗漏和边界错误。

学习目标

  • 能把业务场景拆成命令、聚合状态变化、领域事件和外部协作
  • 能通过正常与异常路径检查订单模型的职责和状态约束
  • 能根据回放暴露的问题调整聚合边界,而不是只补条件判断

先固定本次回放规则

回放之前必须明确业务假设,否则同一个场景会得到互相冲突的结论。本练习采用一组最小规则:新订单初始为待支付;待支付订单可以取消;订单一旦确认支付,不再直接执行“取消”,而应进入退款流程;已取消订单不能再次确认支付。

这些规则只是练习假设,不是所有业务的通用答案。真正项目中应让领域专家确认“支付后能否取消”“取消与退款是否同一动作”等规则,再据此建模。

订单场景回放状态图

按主路径逐步回放

回放时不要只问“代码能不能执行”,而要记录每一步的业务输入、负责对象、状态变化和可观察结果。下面的最小 Python 模型把这四类场景串起来,目的是验证状态规则是否自洽。

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)

预期输出:

text
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。状态不可表达,说明缺少状态或概念;一个方法需要跨多个聚合改数据,说明职责可能越界;同一规则散落在多个服务里,说明不变量没有被正确收拢;事件消费者需要读取订单内部大量细节,说明边界或事件载荷可能需要调整。

完成修改后,应重新跑同一组场景。只有正常路径仍然成立、异常路径被明确拒绝或转交、每个状态变化都有唯一责任主体,模型才算通过这一轮回放。这样得到的领域模型不是“看起来合理”的类图,而是经业务行为验证过的规则系统。

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

目录与阅读设置

阅读设置

17

记录一个想法

用真实业务场景回放模型

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

登录哪都通