数据字典由谁维护和确认
建站合同里若只写功能清单,不写数据字典由谁维护、由谁确认,后期接口对不上、报表合计不一致时,双方容易各执一词。本文适用于需要对接业务系统、生成统计报表或跨页面复用字段的建站项目。签约前应把字段定义、单位、允许值、来源及责任人落到纸面,并约定变更时如何同步接口与报表。
一、数据字典至少写清五项
每个字段至少记录:字段名称、业务含义、数据类型与长度、单位、允许值范围、数据来源、责任人。例如“合同金额”要写明是含税还是不含税、币种、小数位;“交付日期”要写明是计划日期还是实际签收日期。允许值不能只写“按业务填写”,应列出枚举项或格式规则。
来源要具体到系统或岗位,例如“由ERP订单接口传入”或“由销售在后台手工录入”。责任人写岗位而非个人姓名,避免人员变动后无人认领。这些记录作为合同附件,标注版本号和日期,双方确认后作为开发和验收的共同依据。
二、维护与确认责任分开写
数据字典的日常维护通常由甲方业务负责人牵头,乙方负责技术可行性核对。合同中应写明:谁提出字段新增或修改、谁审核、谁最终确认、确认后多久内生效。可以约定甲方指定一名数据负责人,乙方指定一名技术接口人,双方书面确认后方可变更。
确认方式建议采用书面确认单或邮件回复,保留版本记录。若甲方内部多个部门对同一字段口径有分歧,应约定归口人,避免乙方收到互相矛盾的要求。没有明确归口且版本存在冲突时,将争议字段登记为待确认,由双方授权人员核对后决定适用版本,不自行按最近时间取舍。
三、变更要同步接口与报表
字段定义变更后,不能只改页面表单。合同中应要求变更时同步检查:接口字段映射、报表取数逻辑、历史数据兼容性、导出模板。例如“状态”字段新增一个枚举值,接口文档、筛选条件、统计报表的分组都要同步更新,否则会出现页面能选、报表却统计不到的情况。
建议在变更单中列明影响范围清单,由乙方填写、甲方确认。变更完成后,用一条测试数据走通录入、接口传输、报表汇总三个环节,保留核对记录。若历史数据无法自动兼容,应约定处理方式,例如标记为“未分类”并在报表中单独列示。
四、同名字段不等于同口径
不同系统里都叫“客户数”的字段,可能一个按签约主体计数,一个按联系人计数;都叫“金额”的字段,可能一个含运费、一个不含。签约前应把跨页面、跨系统复用的字段逐一比对,发现同名不同义时,在数据字典中加注区分,必要时改名或增加限定词。
核对方法可以是:列出所有报表和接口中用到的字段,与数据字典逐项对照,标记出名称相同但定义不同的项,由双方数据负责人确认取舍。字段量较少时,可用一张对照表加双方签字完成核对;字段量大或跨系统较多时,建议使用字段清单工具辅助比对,字段比对工作应在相应开发前核实,不要等到验收时才发现合计口径不同。
五、交付时核对字典与实现是否一致
验收阶段应把数据字典作为核对清单:随机抽取若干字段,检查页面录入限制、接口返回格式、报表统计结果是否与字典一致。发现不一致时,记录字段名、预期值、实际值和处理结果,作为遗留项登记,约定修复时间。
交付物中应包含最终版数据字典,标注与上线版本对应的日期。若后续由甲方自行维护,乙方应说明哪些字段可以后台调整、哪些需要改代码。没有写进字典的字段,不应视为已确认交付。
