做数据治理整体计划时,平台选型和预算通常讨论得多,文档清单容易被放到最后。到了验收,问题常常出在这里:标准写在汇报材料里,系统里没有对应配置;口径在会议上确认过,找不到签字记录;运维交接只有几页说明,接手的团队还得重新问一遍。
数据治理整体计划的技术文档,通常包括治理决策、标准规则、架构模型、实施配置、运营验收五类。项目范围不同,文档数量可以增减,每一类都要有能支撑执行和验收的文件。下面按项目阶段拆开这份清单,说明每份文档写什么、由谁维护、验收看什么证据,最后给出一套小团队也能用的最小文档集。
如果还在确认治理目标和范围,可以先看数据治理,再回到文档清单。
一、数据治理整体计划的技术文档包括哪五类
先看一张总表。它按文档用途分类,因为同一份文件经常跨部门使用。
| 文档类别 | 典型文档 | 回答什么问题 | 常用维护人 |
|---|---|---|---|
| 治理决策类 | 治理章程、组织与职责矩阵、制度与流程、路线图与年度计划 | 谁决策、谁负责、先做什么 | 数据治理牵头部门 |
| 标准规则类 | 数据标准、数据字典、指标口径、质量规则、分类分级清单、权限矩阵、生命周期策略 | 按什么规则做,做到什么程度算合格 | 数据 Owner、数据管家 |
| 架构模型类 | 数据架构、数据资产目录、逻辑与物理模型、Mapping 表、集成与接口设计、元数据与血缘方案 | 数据在哪、怎么流转、字段怎么对应 | 数据架构师 |
| 实施配置类 | 平台配置说明、ETL 脚本与作业说明、调度依赖、接口文档、测试用例与报告 | 规则是否真的在系统里运行 | 实施与开发团队 |
| 运营验收类 | 验收报告、运维手册、培训材料、问题台账、运营月报、变更记录 | 上线后谁接手、问题怎么闭环 | 运营团队、项目办 |
这里说的技术文档,既包括架构、模型、接口这类技术设计文件,也包括标准、规则、验收记录这类支撑治理运行的文件。只准备设计文档,项目能评审,运行起来仍然会缺依据。
GB/T 34960.5-2018《信息技术服务 治理 第5部分:数据治理规范》从顶层设计、治理环境、治理域和治理过程四个方面提出要求,可以用来检查文档有没有漏项。顶层设计可以对照治理章程、组织职责和路线图;治理域覆盖数据标准、数据质量、数据安全等管理内容;治理过程可以对照调研、设计、实施、验收和运营记录。DAMA-DMBOK 把数据管理分为 11 个知识域,其中数据架构、数据建模与设计、数据安全、元数据管理、数据质量管理,可以直接用来检查专项文档是否齐全。
框架给的是覆盖范围,具体文档名称和数量要按项目范围定。 华为云的公开服务说明里,数据治理相关交付件包括需求分析报告、数据资产目录、数据标准、业务指标设计、Mapping 表、逻辑模型设计、实施方案、配置说明、ETL 脚本、验收用例和验收报告。这些名称可以作为对照,不能当成所有项目的强制标准。
二、立项与调研阶段:范围、现状和责任先写成文件
这一阶段的文档决定项目边界。范围写得模糊,后面的标准、模型和验收都会返工。
1. 项目范围说明与验收标准
至少写清六件事:治理对象是哪些系统和数据域;包含哪些标准、指标、表或主题库;交付物到什么颗粒度;企业和供应商各自负责什么;哪些工作不包含;验收用什么证据。
范围尽量写到可计数、可抽样。例如把“统一核心指标口径”写成“完成 30 个核心指标的业务定义、计算逻辑、统计范围、数据来源和责任人确认,并抽检 10 个指标从源表追到报表”。越接近可验证的动作,验收时越不容易产生分歧。
2. 现状调研与数据盘点报告
内容包括系统清单、数据源、表与字段规模、数据量、更新频率、权限现状和典型质量问题。质量问题要附数据证据,例如重复率、缺失率、口径冲突的样例。只有访谈结论的报告,很难支撑后续优先级判断。
3. 成熟度评估报告
常用 DCMM 作为评估框架。现行版本是 GB/T 36073-2025,也就是 DCMM 2.0,2025 年 12 月 31 日发布,2026 年 7 月 1 日实施,按能力域、能力项和五个成熟度等级评分。报告要写明评估范围、评分依据、主要差距和改进优先级。如果项目沿用旧版模型,注明版本差异,避免和现行标准混用。
4. 治理章程、职责矩阵与路线图
治理章程写目标、决策权、组织设置、议事规则和争议升级路径;职责矩阵写清谁决策、谁执行、谁提供意见、谁接收结果;路线图写分批推进顺序、依赖和里程碑。三者可以合并成一份文件,但决策人和责任岗位要落到具体的人。
阶段出口很明确:范围说明和章程通过评审,责任人有名有岗,再进入设计阶段。
三、方案设计阶段:让标准落到字段和模型
设计阶段最容易写成概念汇报。能进入实施的文档,通常都能回答一个问题:这条规则落在哪张表、哪个字段、由谁确认。
1. 数据标准与数据字典
字段级标准至少包含业务名称、业务定义、数据类型与格式、值域、来源系统、责任部门、使用场景和变更流程。指标口径还要补充计算公式、分子分母、统计范围、时间窗口、数据来源、责任人和版本。
只有命名规范,标准还没有写完。 评审时随机抽几个核心字段,看能不能查到定义、值域和责任人,基本能判断这份文档能不能用。
2. 数据架构与数据资产目录
数据架构说明分层、主题域、数据分布和流转关系。数据资产目录把业务对象、逻辑实体和属性组织起来,常见做法是按主题域分组、主题域、业务对象、逻辑实体、属性五级展开。目录要能搜索、能申请、能追到责任人,否则只是一个静态清单。
3. 逻辑模型、物理模型与 Mapping 表
逻辑模型描述实体、属性和关系,物理模型对应具体存储结构和分区。Mapping 表写清源系统、源表、源字段到目标模型字段的转换规则、过滤条件和责任人。同名不同义、同义不同名、编码冲突,通常在这一步集中暴露,也最适合在这一步解决。
4. 质量规则、分类分级与权限矩阵
质量规则写检核对象、质量维度、阈值、检核频率、告警方式、处理人和修复时限。分类分级清单写数据类别、级别、判定依据、责任人和管控要求。权限矩阵写角色、数据范围、操作类型、审批人和权限回收机制。
制度文件和标准文件可以分开管理。制度回答必须做什么、由谁考核,标准回答具体字段怎么定义、怎么取值。两份文件要能互相引用,避免同一规则出现两个版本。
阶段出口是业务确认口径并留下评审记录,设计文档通过评审,标准能关联到模型字段。
四、实施阶段:配置、脚本和接口文档要能对上系统
实施阶段的文档,作用是把设计意图变成可复核的运行记录。文档和配置对不上,验收时很难解释。
- 平台部署与配置说明:环境、版本、参数、账号与权限、备份和回滚方式。
- 数据集成与作业文档:数据源、抽取方式、调度频率、依赖关系、异常处理;ETL 脚本或代码要有版本号和用途说明。
- 元数据与血缘配置说明:采集范围、字段级血缘覆盖、更新频率,以及怎么做影响分析。
- 数据服务接口文档:消费方、入参、返回字段、鉴权方式、刷新频率、服务级别约定、版本和权限边界。
- 质量作业与告警配置:规则编号、调度时间、告警接收人、处置流程和升级路径。
这一阶段有一条硬要求:文档与配置同源。 验收时抽查配置导出、脚本、作业日志和接口调用记录。只交文档不交配置,规则还没有开始运行。
五、测试验收与移交:用记录证明文档、数据和系统一致
1. 测试与数据核对
测试计划、测试用例和功能、性能、安全测试报告要能互相对应,具体范围可对照数据治理测试与验收。数据核对报告选两三个核心场景,从源表追到指标,再追到报表或接口,写清抽样比例、差异数量、原因和修复结果。
2. 验收报告
验收报告列出交付件清单、验收标准、逐项结果、遗留问题和签字人,并引用测试报告与核对记录。只写“功能正常”“运行稳定”,无法证明文档、数据和系统一致。
3. 培训与交接
培训材料、培训记录、运维手册、账号与权限清单、配置清单、问题台账和未完成事项,都要在移交时交付。交接完成的判断标准是,企业接收人在没有原团队驻场时能处理日常问题。
六、运营阶段:文档跟着变更走
治理进入日常运行后,可结合数据治理与治理项目的区别明确文档用途;文档的主要作用是留下决策和变更的痕迹。
- 运营记录:质量月报、问题台账、SLA 记录、数据服务调用量和使用部门。
- 变更记录:标准、口径、模型、权限和接口的变更申请、审批、生效日期和影响范围。
- 版本管理:文档编号、版本号、生效日期、审批人和失效处理。同一概念只保留一个有效定义。
- 年度复盘:根据问题和业务变化更新路线图与优先级。
判断文档体系是否可用,可以看它能不能支撑三个动作:新人按文档接手工作,审计人员能追溯到规则和审批,改一个字段前能查到影响哪些报表和接口。
七、首个项目或小团队,最小文档集怎么裁
文档数量按范围、风险和项目周期定。首个项目可以合并文件,也可以先覆盖核心域,但不建议省掉能支撑执行和追责的内容。
| 文档 | 可以怎么合并 | 不能省的内容 |
|---|---|---|
| 治理章程与职责矩阵 | 与立项文件合并 | 决策人、责任岗位、升级路径 |
| 范围说明与验收标准 | 与实施方案合并 | 范围、交付物颗粒度、验收证据 |
| 系统与数据资产清单 | 与调研报告合并 | 系统、表、字段、责任人 |
| 核心数据标准与指标口径 | 合并为一份标准手册 | 定义、值域、公式、责任人 |
| 质量规则清单 | 放入标准手册附录 | 检核对象、阈值、处理人 |
| 分类分级与权限矩阵 | 与安全规范合并 | 级别、角色、审批、回收机制 |
| Mapping 表与接口说明 | 与模型设计合并 | 源字段、目标字段、转换规则 |
| 验收报告与运维交接清单 | 与项目总结合并 | 测试证据、遗留问题、接收人 |
还有五类内容不建议省:核心指标口径、权限矩阵、Mapping 表、测试证据和交接清单。判断一份文档该不该保留,可以问三个问题:缺了它,规则还能执行吗,问题还能追责吗,系统还能接手吗。三个答案都是能,才可以合并或删除。
八、文档写了不少却落不下去,问题通常在哪
- 文档与系统两张皮。 设计文档写完就归档,系统配置和脚本另有一套。修正方式是把配置导出、作业记录和接口调用记录纳入验收,文档版本跟着系统版本更新。
- 标准只有命名规范。 补业务定义、值域、责任人和变更流程,先从核心字段和核心指标开始。
- 口径没有业务签字。 每个指标指定责任人,评审记录留档;有争议时按章程里的升级路径处理。
- 资产目录只到主题域。 核心链路补到字段级血缘,至少覆盖关键指标从源表到报表的路径。
- 文档没有版本和生效日期。 建文档台账,写清责任人、审批人和复审周期,失效文件及时标注。
- 运营记录缺失。 把质量月报、问题台账和变更记录放进例会和考核,文档才会随着治理运行更新。
九、AI 与 Agent 项目要补哪些文档
Agent 使用数据时,治理对象从表、字段和报表,扩展到指标语义、知识文档、权限和评测。原有文档清单仍然适用,另外要补五类内容。
- 语义层文档:指标字典、语义模型、实体关系、映射规则和口径变更流程。
- 知识文档规范:知识分类、入库规范、版本记录、失效规则和单一事实来源约定。
- 权限与审计文档:Agent 可访问的数据与知识范围、权限矩阵、调用日志和审计记录。
- 评测文档:评测集、评分标准、评测报告、回归机制、错误处理和升级流程。
- 接口文档:Agent 可调用的数据服务清单、参数、返回字段、SLA 和权限边界。
ThinkingAI 的企业级知识库采用 Schema 优先模式,先把原始知识结构化为实体图谱,再通过统一接口提供检索和查询;以单一事实来源保证同一概念只有一处定义,通过变更集让知识更新可追溯、可对比、可回滚。Agentic Engine 支持私有化部署和多 Agent 协作。对数据主权和权限控制有要求的企业,可以把这些机制纳入文档规范和权限方案的评估。ThinkingAI 已服务全球超 1500 家企业,接入产品超 8000 款。
常见问题解答
数据治理整体计划一定要有治理章程吗?
建议有。章程明确决策权、组织设置和争议升级路径。项目规模小,可以用立项文件承载,但决策人、责任岗位和争议处理方式要写清,不能只留在会议纪要里。
技术文档和管理制度需要分开吗?
可以分开管理,内容要能对应。制度写要求、责任和考核,技术文档写字段、模型、接口和配置。同一规则在两处出现时,标明发布版本和互相引用的条款,避免执行时各取一份。
数据标准要写到多细?
核心字段和核心指标写到可执行粒度,包括定义、值域、计算公式、来源、责任人和版本。长尾字段可以先登记清单,随使用逐步补齐。判断标准是业务能理解、技术能执行、审计能复核。
没有数据治理平台,文档还有用吗?
有用。标准、口径、质量规则和 Mapping 可以先在文档中定下来,平台上线后再配置。没有平台时,至少要有责任人和评审记录,否则文档很难持续更新。
文档由谁写、谁维护?
按内容分工。治理章程和制度由牵头部门写,标准和口径由数据 Owner 确认、数据管家维护,模型和接口由架构与开发团队写,验收和运营记录由项目办与运营团队维护。每份文档只设一个责任人。
数据治理文档多久更新一次?
标准、口径和权限在变更时更新,质量规则和资产目录按季度检查,路线图和优先级按年度复盘。更新要走审批并标注生效日期,临时通知不算版本变更。
参考资料
- 全国标准信息公共服务平台:GB/T 34960.5-2018《信息技术服务 治理 第5部分:数据治理规范》,2018 年 6 月 7 日发布,2019 年 1 月 1 日实施。https://openstd.samr.gov.cn/bzgk/std/newGbInfo?hcno=F3B2108863A2292F5AF0FA645CEE047F
- 中国标准在线服务网:GB/T 36073-2025《数据管理能力成熟度评估模型》,2025 年 12 月 31 日发布,2026 年 7 月 1 日实施。https://main.spc.net.cn/zonghe/22559f9c7bf9eac6a3927223fe33ce20.html
- 华为云:数据要素集成与实施服务,含服务流程与服务交付件。
- DAMA International:DAMA-DMBOK Framework,11 个核心知识领域。https://www.damadmbok.org/dmbok-framework






