领域术语表是什么
术语表把业务概念的名称、英文名、定义、别名与禁用叫法集中维护,是通用语言的落地载体。它的作用是让需求、接口、数据库与代码使用同一套词:同一个概念只有一个官方叫法,销售口中的「账单」和财务口中的「结算单」不再混用。术语表要放在团队可编辑的位置并纳入评审流程,否则会迅速过期;新增概念时先查表再命名,避免两个词指同一件事。
基本信息
| 收录内容 | 中文名、英文名、定义、别名与禁用叫法、负责人 |
|---|---|
| 维护位置 | 团队可编辑的文档或知识库,与需求文档互相链接 |
| 更新机制 | 概念评审时同步更新,禁用叫法要显式标注原因 |
| 使用范围 | 需求、接口命名、数据库表字段、代码类名与前端文案 |
| 检查方式 | 接口与表结构评审时对照术语表核对命名一致性 |
典型使用场景
- 新成员上手:通过术语表快速理解业务概念与边界
- 接口评审:字段命名对照术语表,避免同一含义多种写法
- 跨部门沟通:业务、产品与研发用同一套词讨论需求
- 数据治理:指标与报表口径依赖概念定义的一致性
- 多语言产品:中文名与英文名成对维护,翻译与文案统一
- 重构与迁移:把历史系统里的多种叫法收敛到官方术语
术语字段示例
| 字段 | 内容 | 说明 |
|---|---|---|
| 中文名 | 结算单 | 对外与内部统一的正式叫法 |
| 英文名 | Settlement | 代码命名、接口字段与数据库命名依据 |
| 定义 | 按周期汇总应收应付并生成对账依据的单据 | 一句话说清边界,包含与不包含都要明确 |
| 别名与禁用叫法 | 账单(易与 Invoice 混淆,禁用) | 标注原因,否则禁用规则会被重新打破 |
| 负责人 | 财务产品经理 | 概念变更时的确认人 |
落地使用要点
落地使用要点
# 1 命名前先查术语表:已有官方叫法时不得另造新词
# 2 代码与表结构使用英文名:Settlement 而不是 Bill、Statement 混用
# 3 前端文案使用中文名:与对外文档、帮助中心保持一致
# 4 新增术语走评审:明确定义、别名与禁用叫法后再进入使用
# 5 变更要打补丁:概念含义调整时同步检查接口、报表与历史数据口径
# 6 定期巡检:抽查接口字段与表字段,列出与术语表不一致的项术语表只写中文不写英文名时,代码命名仍然靠个人翻译,同一概念在不同服务里出现多种拼写,联调与检索成本上升。
禁用叫法要和原因一起记录:只写「禁用」不写为什么,后来者不知道边界在哪里,很容易重新启用造成混淆。