数据字典不是字段名称的罗列,而是让产品、开发、分析和业务对同一个字段使用同一套口径。本文以订单净收款为例,画清字段定义、来源表、计算规则、负责人和变更记录之间的关系;示例字段与口径需要替换成组织实际数据。

当字段关系涉及来源、加工和报表使用时,可以用数据流图先看流向,再在白板上补责任和版本信息。本文不把数据字典等同于数据血缘:前者强调“字段是什么意思”,后者强调“数据从哪里流到哪里”。
一、先确定字段卡片的最小内容
订单金额字段至少记录中文名、英文名、数据类型、单位、口径、来源、更新频率、负责人和示例值。本例将支付成功金额减已确认退款称为“订单净收款”,还要说明优惠、运费和税费如何计入;没有这些限定,同名字段在不同报表里就会产生不同数字。
| 字段 | 示例填写 | 需要谁确认 |
|---|---|---|
| 字段名称 | 订单净收款 | 产品与业务 |
| 口径 | 支付成功金额减已确认退款,不含未支付优惠 | 财务与分析 |
| 来源 | 订单表 payment_amount、退款表 refund_confirmed | 开发与数据 |
| 更新频率 | 订单状态变化后更新 | 数据负责人 |
| 变更记录 | 版本、日期、变更原因 | 维护人 |
二、把字段、来源和使用场景连成关系
本例先把订单表和退款表连到“订单净收款”字段,再连到收款日报和销售漏斗报表。关系线上标注“计算、引用或校验”,不要只画一条无方向的线。若某个报表仍使用旧字段,标注“待迁移”并指定负责人。
例如,订单 A 支付成功 100 元,有两条已确认退款记录,分别为 10 元和 20 元,则订单净收款为 100 −(10 + 20)= 70 元。计算时先按 order_id 汇总已确认退款,再与每单一行的支付金额关联,避免一对多关联后重复累计支付金额;待处理退款不计入本例的扣减金额。若源数据以分存储,就统一按 10000 −(1000 + 2000)= 7000 分计算,再换算为 70 元展示,不能将“分”和“元”直接相减。
三、四类角色怎样共同维护
业务确认字段在决策中的含义,产品记录使用场景,开发确认来源和更新时机,分析人员确认计算与报表呈现。可以将字段卡片放在 Boardmix 画布中共同评论,但评论结论要回写到字段卡和变更记录,不能只留在聊天区。

四、变更时先判断影响面
如果“订单净收款”从含税改为不含税,先在关系图中找到收款日报、销售漏斗和财务对账,再决定迁移顺序。变更卡包含旧口径、新口径、生效日期、受影响报表和回滚方式;没有负责人确认时,字段状态保持“待评审”。
五、用三条规则检查字典是否可用
能解释:新成员只看字段卡就知道它代表什么。能追溯:从报表可以找到来源和计算规则。能维护:口径变化会触发影响清单和负责人通知。如果只能看到名称和类型,说明还没有形成可协作的数据字典。
六、处理三种常见冲突
同一中文名对应两个口径时,保留旧字段并重新命名,不覆盖历史定义;来源字段被下线时,先标记影响报表,再制定迁移;业务和财务对金额范围有分歧时,把争议写进决策记录,不能用“以最终结果为准”结束。这样,字典才是可持续维护的协作资产。

