首页/开发/系统分析与架构设计速查/领域术语表(Glossary)
需求分析与建模61 条

领域术语表(Glossary)

术语表汇总业务概念、英文名、定义、别名与禁用叫法,是通用语言的落地载体;它让需求、接口与代码使用同一套词。

领域术语表是什么

术语表把业务概念的名称、英文名、定义、别名与禁用叫法集中维护,是通用语言的落地载体。它的作用是让需求、接口、数据库与代码使用同一套词:同一个概念只有一个官方叫法,销售口中的「账单」和财务口中的「结算单」不再混用。术语表要放在团队可编辑的位置并纳入评审流程,否则会迅速过期;新增概念时先查表再命名,避免两个词指同一件事。

基本信息

收录内容中文名、英文名、定义、别名与禁用叫法、负责人
维护位置团队可编辑的文档或知识库,与需求文档互相链接
更新机制概念评审时同步更新,禁用叫法要显式标注原因
使用范围需求、接口命名、数据库表字段、代码类名与前端文案
检查方式接口与表结构评审时对照术语表核对命名一致性

典型使用场景

  • 新成员上手:通过术语表快速理解业务概念与边界
  • 接口评审:字段命名对照术语表,避免同一含义多种写法
  • 跨部门沟通:业务、产品与研发用同一套词讨论需求
  • 数据治理:指标与报表口径依赖概念定义的一致性
  • 多语言产品:中文名与英文名成对维护,翻译与文案统一
  • 重构与迁移:把历史系统里的多种叫法收敛到官方术语

术语字段示例

字段内容说明
中文名结算单对外与内部统一的正式叫法
英文名Settlement代码命名、接口字段与数据库命名依据
定义按周期汇总应收应付并生成对账依据的单据一句话说清边界,包含与不包含都要明确
别名与禁用叫法账单(易与 Invoice 混淆,禁用)标注原因,否则禁用规则会被重新打破
负责人财务产品经理概念变更时的确认人

落地使用要点

落地使用要点
# 1 命名前先查术语表:已有官方叫法时不得另造新词
# 2 代码与表结构使用英文名:Settlement 而不是 Bill、Statement 混用
# 3 前端文案使用中文名:与对外文档、帮助中心保持一致
# 4 新增术语走评审:明确定义、别名与禁用叫法后再进入使用
# 5 变更要打补丁:概念含义调整时同步检查接口、报表与历史数据口径
# 6 定期巡检:抽查接口字段与表字段,列出与术语表不一致的项
术语表只写中文不写英文名时,代码命名仍然靠个人翻译,同一概念在不同服务里出现多种拼写,联调与检索成本上升。
禁用叫法要和原因一起记录:只写「禁用」不写为什么,后来者不知道边界在哪里,很容易重新启用造成混淆。

易错点

  • 术语表只写中文不写英文名:代码命名靠个人翻译,同一概念多种写法
  • 新增术语不走评审:出现两个词指同一概念,需求与实现各自解读
  • 长期不更新:业务概念已经演进,术语表仍是旧定义,参考价值归零
  • 术语表与需求文档分离存放:评审时不查表,命名一致性无从保障
  • 定义过于笼统:只写「与结算相关的单据」,边界不清,用法继续发散

数据来源与参考

  • Eric Evans《Domain-Driven Design》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌