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

用统一语言消除概念歧义

用统一语言消除概念歧义

业务讨论里最危险的不是术语多,而是同一个词在不同人嘴里代表不同对象,或同一概念被代码和接口写成不同名字。本篇用订单履约中的“订单、商品、取消”等例子建立统一语言,并把它落实到模型与接口命名。

学习目标

  • 识别同义异名和同词异义两类常见概念冲突。
  • 把业务术语稳定映射到领域模型、接口和事件名称。
  • 判断一个词应在全局统一,还是只在特定业务上下文内统一。

先抓住两类语言冲突

统一语言首先解决的不是“起一个更漂亮的名字”,而是让一句业务话在团队里只有一个可执行的解释。最常见的冲突有两类:同一个概念被叫成多个名字,以及同一个名字在不同上下文里表示不同概念。

例如,业务人员说“商品”,商品管理关注的是名称、类目和上架状态,库存管理更关心可售单元、数量和占用状态。如果代码里都用 Product 承载这些含义,模型会不断膨胀,接口参数也会变得含糊。相反,如果“取消订单”在客服、支付和履约环节分别意味着停止销售承诺、撤销支付或终止发货,就不能只靠一个 cancel() 方法掩盖差异。

让术语贯穿业务、模型和接口

一个术语只有出现在会议纪要里还不算统一。它应同时进入需求描述、领域对象、方法、接口路径和事件名称。这样代码评审或接口评审一旦出现陌生词,团队就能立刻发现模型正在偏离业务。

业务表达 领域模型 接口或事件
创建履约单 FulfillmentOrder POST /fulfillment-orders
取消履约 cancelFulfillment() FulfillmentCancelled
库存预留 StockReservation StockReserved

统一语言在业务讨论、模型与接口之间的映射关系

片段示例:假设团队已经确认“履约单”是履约上下文的正式术语,下面的 OpenAPI 定义展示接口名称如何与该术语保持一致;它依赖实际服务实现,不能单独运行。

yaml
paths:
  /fulfillment-orders/{orderId}:
    get:
      operationId: getFulfillmentOrder
      parameters:
        - name: orderId
          in: path
          required: true
      responses:
        "200":
          description: 返回履约单

这类接口定义的生效行为是:调用方看到路径和 operationId 就能直接对应业务中的“履约单”。验证时应把需求用词、领域对象名和 API 名称并排检查;如果同一概念又出现 deliveryOrder、shipmentOrder 等近义命名,就应先回到业务含义确认,而不是继续扩散别名。

用业务句子验证术语是否真的清楚

定义术语后,不要只审词条,应把它放回真实业务句子。一个好术语必须能让业务人员、开发和测试对状态变化产生同样理解。

可以依次做三件事:

  1. 用业务角色会说的话描述动作,例如“客服为尚未出库的履约单发起取消”。
  2. 追问动作影响的对象和状态,例如取消的是销售承诺、支付记录,还是履约过程。
  3. 把确认后的词同步到代码、接口、事件和验收用例,删除旧别名或明确兼容期限。

如果一句话必须不断补充“这里的订单其实指……”,说明术语仍然过宽。此时应拆成更精确的概念,而不是依赖口头解释维持一致。

在上下文边界内保持一致

统一语言和业务边界是互相验证的。若两个团队必须长期为同一个词维护不同定义,通常说明它们不在同一个模型上下文中。反过来,如果一个上下文内部频繁出现多个近义词,也说明模型尚未稳定。

评审时只要检查三个问题:这个词对应的业务对象是什么;它在哪个上下文内成立;需求、代码和接口是否使用同一语义。能稳定回答这三个问题,统一语言才真正成为后续事件风暴和服务拆分可依赖的基础。

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

目录与阅读设置

阅读设置

17

记录一个想法

用统一语言消除概念歧义

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

登录哪都通