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

怎样维护一份领域词汇表

怎样维护一份领域词汇表

领域词汇表不是把业务名词抄进文档,而是持续记录团队对关键术语的共同约定。本篇将建立一份轻量、可维护的领域词典,让产品、业务和研发在讨论同一概念时使用同一含义,并能在出现新歧义时快速修正。

学习目标

  • 为领域术语记录定义、别名、上下文和必要边界
  • 识别同词异义、同义多词等容易破坏统一语言的问题
  • 建立随需求和模型一起更新的词汇表维护方式

词汇表要解决什么问题

业务讨论中的歧义往往不是因为没人解释术语,而是不同角色默认了不同解释。例如“客户”在销售场景里可能指潜在购买者,在合同场景里却可能只指已经签约的主体。如果模型直接使用一个笼统的“客户”,后续规则就容易互相冲突。

词汇表的作用是把这种隐含理解变成明确约定。它不追求收录所有名词,而应优先记录会影响业务规则、流程判断、对象命名和团队沟通的术语。

一条术语应该记录什么

一份实用的领域词汇表可以从四项信息开始:标准术语、定义、别名和上下文。必要时再补充容易混淆的边界或示例。

术语 定义 别名或旧称 上下文
会员 已完成平台注册并拥有会员身份的用户 注册用户 会员管理
订单 用户提交并等待后续履约处理的一次购买请求 交易单 交易
已支付订单 已确认收到有效支付结果的订单 支付成功订单 支付、履约

定义应描述业务含义,而不是用另一个模糊词互相解释。例如“订单就是订单记录”几乎没有信息;“用户提交并等待履约处理的一次购买请求”则说明了它代表什么业务事实。

发现歧义时怎么处理

维护词汇表时重点关注两类问题。第一类是同词异义:大家都说“账户”,但财务指结算账户,用户中心指登录账户。第二类是同义多词:产品说“退款单”,运营说“售后退款”,代码里又叫 refundRequest,实际描述的是同一概念。

遇到同词异义时,不应简单挑一个解释覆盖其他解释,而要先确认它们是否属于不同上下文,再分别命名。遇到同义多词时,则选定一个标准术语,其余写入“别名或旧称”,并逐步让需求、接口和模型采用统一名称。

让词汇表跟着模型变化

领域词汇表最容易失败的原因,是第一次整理后再也没人更新。更可行的做法是把修改动作嵌入日常建模和需求讨论:出现新术语时补充定义;发现已有定义与业务不符时立即修正;模型中的对象改名时同步调整标准术语和旧称。

评审一个术语时,可以连续检查三个问题:不同角色看到这个词是否会理解成同一件事;定义是否能够帮助判断一个具体对象属于或不属于这个概念;模型、需求和讨论中是否使用了相同名称。如果其中任意一项无法回答,词汇表就还没有真正消除歧义。

词汇表最终应成为统一语言的索引,而不是静态术语档案。它越接近日常需求、模型和代码中的真实用词,越能减少团队重新解释同一个概念的成本。

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

目录与阅读设置

阅读设置

17

记录一个想法

怎样维护一份领域词汇表

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

登录哪都通