架构与系统设计 / 系统课时
怎样维护一份领域词汇表
怎样维护一份领域词汇表
领域词汇表不是把业务名词抄进文档,而是持续记录团队对关键术语的共同约定。本篇将建立一份轻量、可维护的领域词典,让产品、业务和研发在讨论同一概念时使用同一含义,并能在出现新歧义时快速修正。
学习目标
- 为领域术语记录定义、别名、上下文和必要边界
- 识别同词异义、同义多词等容易破坏统一语言的问题
- 建立随需求和模型一起更新的词汇表维护方式
词汇表要解决什么问题
业务讨论中的歧义往往不是因为没人解释术语,而是不同角色默认了不同解释。例如“客户”在销售场景里可能指潜在购买者,在合同场景里却可能只指已经签约的主体。如果模型直接使用一个笼统的“客户”,后续规则就容易互相冲突。
词汇表的作用是把这种隐含理解变成明确约定。它不追求收录所有名词,而应优先记录会影响业务规则、流程判断、对象命名和团队沟通的术语。
一条术语应该记录什么
一份实用的领域词汇表可以从四项信息开始:标准术语、定义、别名和上下文。必要时再补充容易混淆的边界或示例。
| 术语 | 定义 | 别名或旧称 | 上下文 |
|---|---|---|---|
| 会员 | 已完成平台注册并拥有会员身份的用户 | 注册用户 | 会员管理 |
| 订单 | 用户提交并等待后续履约处理的一次购买请求 | 交易单 | 交易 |
| 已支付订单 | 已确认收到有效支付结果的订单 | 支付成功订单 | 支付、履约 |
定义应描述业务含义,而不是用另一个模糊词互相解释。例如“订单就是订单记录”几乎没有信息;“用户提交并等待履约处理的一次购买请求”则说明了它代表什么业务事实。
发现歧义时怎么处理
维护词汇表时重点关注两类问题。第一类是同词异义:大家都说“账户”,但财务指结算账户,用户中心指登录账户。第二类是同义多词:产品说“退款单”,运营说“售后退款”,代码里又叫 refundRequest,实际描述的是同一概念。
遇到同词异义时,不应简单挑一个解释覆盖其他解释,而要先确认它们是否属于不同上下文,再分别命名。遇到同义多词时,则选定一个标准术语,其余写入“别名或旧称”,并逐步让需求、接口和模型采用统一名称。
让词汇表跟着模型变化
领域词汇表最容易失败的原因,是第一次整理后再也没人更新。更可行的做法是把修改动作嵌入日常建模和需求讨论:出现新术语时补充定义;发现已有定义与业务不符时立即修正;模型中的对象改名时同步调整标准术语和旧称。
评审一个术语时,可以连续检查三个问题:不同角色看到这个词是否会理解成同一件事;定义是否能够帮助判断一个具体对象属于或不属于这个概念;模型、需求和讨论中是否使用了相同名称。如果其中任意一项无法回答,词汇表就还没有真正消除歧义。
词汇表最终应成为统一语言的索引,而不是静态术语档案。它越接近日常需求、模型和代码中的真实用词,越能减少团队重新解释同一个概念的成本。