评估研发数据迁移映射表的覆盖范围，核心是回答三个问题：应迁移的数据对象是否都列入了清单、映射表是否逐项给出了目标落点与转换规则、缺口分布在哪里。评估前需要先冻结源系统盘点清单作为分母，再按实体、字段、用户身份、附件、链接五类对象分别计算覆盖率。本文给出一套可复算的口径、判定证据和分步流程，适用于迁移准备阶段的映射表评审。
要点总览（TL;DR）
- 覆盖范围评估先冻结源系统盘点清单作为分母，再按实体、字段、用户身份、附件、链接五类对象分别计算覆盖率，公式为已明确映射对象数÷应迁移对象总数×100%。
- 一条映射记录要同时给出源对象、源字段、目标对象、目标字段、转换规则和缺失异常处理，才算已覆盖；有落点缺规则的计入部分覆盖，不并入分子。
- 评估按五步推进：冻结分母基线、拆分映射表逐条比对、按类型计算覆盖率、对未覆盖项分类归因、形成缺口清单并指定责任人。
- 覆盖率只反映映射表登记完整度，不代表数据已正确转换；不同对象类型不可相加平均，需与迁移验证结果配合使用。
评估目标：覆盖范围要回答哪几个问题
覆盖范围评估的对象是迁移数据内容本身，即源系统中需要带到目标系统的记录、字段、账号、文件和引用关系。评估要回答的问题可以归为三类：哪些数据需要迁移、映射表是否为每类数据给出了目标位置和转换规则、未覆盖的部分集中在哪些对象类型上。这三个问题对应评估的三项产出：迁移对象清单、逐条映射的覆盖判定、按类型汇总的缺口清单。
需要明确边界。工作流、插件、自动化规则等配置行为的迁移，属于工作流与扩展能力迁移的评估范畴，其判定依据是配置项能否在目标系统重建，与数据映射表的覆盖统计口径不同。迁移执行后的数据正确性核验、抽样比对和切换条件确认，属于迁移验证与切换管理，覆盖范围评估不替代这些环节。把两类工作混在一起，容易让覆盖率数字承担它无法承担的结论。
评估结论的用途有三项。第一，指导补全映射表：缺口清单直接对应待补充的映射行和待确认的转换规则。第二，支持分批迁移决策：按对象类型的覆盖率和缺口风险，决定哪些数据先迁、哪些等规则确认后再迁。第三，作为切换条件的输入之一：覆盖率未达到约定水平的对象类型，不进入切换范围。评估结论应形成书面记录，注明盘点基线的时间点和映射表版本，便于后续复算。
指标与范围：五类对象与覆盖率公式
研发数据迁移涉及的对象差异较大，用单一数字概括会掩盖结构性问题，因此按五类对象分别统计。下表给出分类、典型内容和统计单位。
| 对象类型 | 典型内容 | 统计单位 |
|---|---|---|
| 实体 | 工作项、需求、缺陷、测试用例、迭代、版本等 | 条数 |
| 字段 | 实体上的属性项，含自定义字段 | 字段项 |
| 用户身份 | 账号、用户组及其归属关系 | 账号数 |
| 附件 | 文件、图片等随记录上传的内容 | 文件数 |
| 链接 | 工作项关联、页面互链、外部引用 | 引用条数 |
覆盖率按对象类型分别计算，公式为：覆盖率 = 已明确映射对象数 ÷ 应迁移对象总数 × 100%。分子是映射表中同时给出目标落点和转换规则的对象数，分母是源系统盘点清单中该类对象的总数。分母必须来自源系统导出或盘点结果，不能用映射表的行数代替。用映射表行数作分母，遗漏的对象不会出现在分母里，覆盖率会虚高，这正是覆盖评估要防范的问题。
缺失值处理遵循一条规则：映射表未提及的对象一律计入未覆盖，不默认视为不需要迁移。确有对象不参与迁移的，需在缺口清单中单独标注原因，例如历史归档数据保留在原系统、测试环境数据不迁移，并注明确认人和确认时间。这类对象从分母中剔除时要有书面依据，剔除动作本身也应可追溯。
用户身份一项通常用匹配率表述：已确认匹配依据且目标账号明确的账号数 ÷ 应迁移账号总数。附件和链接的覆盖率计算方式与实体一致，但分子判定更依赖规则完整性，下一节展开。
数据口径与证据：映射表要记录哪些字段才算覆盖
一条映射记录被判为已覆盖，需要同时具备源侧信息、目标侧信息、转换规则和异常处理四部分内容。只填写源字段名或只写目标字段名，都不足以支撑迁移执行，也不应计入已覆盖分子。最小字段要求如下：
- 源对象与源字段：明确来自哪个系统、哪类实体、哪个属性项，自定义字段需保留原始标识。
- 目标对象与目标字段：明确落到目标系统的哪类工作项、哪个字段，字段类型不一致时说明处理方式。
- 转换规则：枚举值如何对应、日期与人员字段如何解析、多值字段如何拆分或合并、富文本如何保留格式。
- 缺失或异常处理：源值为空时目标字段填什么、值无法识别时进入哪个人工处理队列、由谁处理。
用户身份的映射需要额外记录账号匹配依据，常见依据包括邮箱、工号或登录名，并说明多个依据冲突时以哪个为准。无法匹配的账号要有明确处置：创建新账号、归并到指定账号、或标记为不迁移并保留原记录。附件映射需记录存储位置、命名规则和访问权限的对应关系，权限继承自所属记录还是单独配置，应在映射表中写明。链接映射需记录引用解析方式，例如按源系统记录编号解析还是按标题匹配，以及失效链接的处理方式，是保留文本、标注失效还是丢弃。
覆盖判定需要证据支撑，建议随映射表一并归档三类材料：映射表版本号与更新时间、盘点清单的导出时间和导出范围、映射表评审记录。评审记录应包含参与角色和确认结论，便于在覆盖率结果出现争议时回溯判定依据。
计算与评估步骤：从盘点清单到覆盖率结果
以下五步流程保证不同人按同一口径复算，每一步都有明确产物。
第一步，冻结分母基线。从源系统按对象类型导出清单，记录导出时间、导出条件和总条数。导出后基线不再随源系统变化而调整，后续新增数据在下一轮评估中处理。基线文件应包含对象唯一标识，便于逐条比对。
第二步，拆分映射表并逐条比对。把映射表按五类对象拆开，用对象唯一标识与基线比对，为每个对象标记状态：已覆盖、部分覆盖、未覆盖。部分覆盖指有目标落点但缺转换规则或缺异常处理，这类记录单独计数，不并入已覆盖分子。
第三步，按类型计算覆盖率。分别计算五类对象的覆盖率，同时列出部分覆盖项数量和占比。实体覆盖率反映记录级登记完整度，字段覆盖率反映属性级规则完整度，两者差距大通常说明字段级规则尚未梳理清楚。
第四步，对未覆盖项分类归因。归因分为三类：遗漏，即应迁移但映射表未登记；暂不迁移，即有明确决策和确认人；需人工处理，即规则无法自动确定、需逐条判断。三类缺口的处理路径不同，遗漏补映射行，暂不迁移补决策记录，需人工处理排入处理队列。
第五步，形成缺口清单并指定责任。缺口清单建议包含：对象类型、对象标识或范围、缺口描述、归因分类、补全责任人、复核时点。清单确认后进入映射表修订，修订完成触发下一轮覆盖率计算，形成闭环。
在映射表与缺口清单需要多人协作维护时，可以把映射表作为文档纳入 ONES Wiki 管理版本与评审记录，把缺口项登记为 ONES Project 中的工作项，按对象类型分组、指定负责人和复核日期，使补全进度与覆盖率复算结果对应到同一批记录。ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、附件和历史记录等对象，Confluence 迁移覆盖空间、页面、附件和权限结构，可作为梳理迁移对象清单时的参照范围；映射表的具体字段规范与覆盖率统计仍需按本文口径自行建立。
例子：一个工作项迁移的覆盖率计算
假设某团队从源系统迁移到目标系统，盘点基线为：工作项 1200 条、字段 40 项、账号 150 个、附件 800 个、链接 600 条。映射表评审后的统计如下表。
| 对象类型 | 应迁移总数（分母） | 已覆盖（分子） | 部分覆盖 | 未覆盖 | 覆盖率 |
|---|---|---|---|---|---|
| 工作项 | 1200 条 | 1140 条 | — | 60 条 | 95.0% |
| 字段 | 40 项 | 34 项 | 4 项 | 2 项 | 85.0% |
| 账号 | 150 个 | 138 个 | — | 12 个 | 92.0% |
| 附件 | 800 个 | 720 个 | — | 80 个 | 90.0% |
| 链接 | 600 条 | 510 条 | — | 90 条 | 85.0% |
字段一项的部分覆盖示例：某自定义单选字段已指定目标字段，但枚举值对应关系尚未确认，该字段计入部分覆盖，不计入已覆盖分子。若把它算作已覆盖，字段覆盖率会显示为 95%，掩盖了规则缺口。账号的 12 个未覆盖账号中，8 个因邮箱与工号均无法匹配需人工确认，4 个属于离职人员账号，经确认不迁移并记录决策依据，后者从分母中剔除后匹配率按 138 ÷ 146 计算。
附件的 80 个未覆盖文件中，有 30 个因源存储位置尚未确认列为待定，不能直接归入不需要迁移。待定项在缺口清单中单独标记，确认后再决定是补映射还是剔除分母。链接的 90 条未覆盖引用中，多数指向已删除的源记录，需在映射表中补充失效链接处理规则后重新统计。
解读与限制：覆盖率数字能说明什么、不能说明什么
覆盖率说明的是映射表对迁移对象的登记完整度，即应迁移的对象中有多少已经在映射表中获得明确落点和规则。它不说明数据是否已正确转换，也不说明目标系统中的数据质量。覆盖率 95% 的工作项，仍可能在转换后出现状态错位或人员归属错误，这类问题要靠迁移验证环节的抽样比对发现。
分母为零或某类对象在本次迁移中不存在时，该项标注为不适用并说明原因，不写成 100%。例如本次迁移不涉及附件，附件覆盖率记为不适用，避免在汇总时制造完整度假象。不同对象类型的覆盖率不可直接相加或求平均，实体按条数、字段按字段项、账号按账号数统计，单位不同，平均后的数字没有业务含义，应分类型呈现。
覆盖率较高但部分覆盖项较多时，仍需按风险排序处理。部分覆盖意味着规则未定，迁移执行时容易产生人工判断，风险集中在这类字段和链接上。建议把部分覆盖项按影响范围排序，影响核心业务字段的先补规则。覆盖率需与迁移验证结果配合使用，单指标不能作为验收结论；切换决策应同时参考覆盖率、部分覆盖项处理进度和验证抽样结果。
常见问题
映射表里没有提到的对象，能不能默认视为不需要迁移？
不能。映射表未提及的对象一律计入未覆盖，这是覆盖评估的基本口径。确有对象不参与迁移的，要在缺口清单中单独标注原因，例如历史归档数据保留在原系统、测试环境数据不迁移，并写明确认人和确认时间。这类对象从分母中剔除时需要有书面依据，剔除动作本身也应可追溯，否则覆盖率会因分母缩小而虚高。
部分覆盖和未覆盖在缺口处理上有什么区别？
部分覆盖指映射表已给出目标落点，但转换规则或异常处理尚未确定；未覆盖指映射表根本没有登记该对象。两者处理路径不同：部分覆盖需要补齐规则，通常由熟悉源字段含义的业务人员确认枚举对应、日期解析、多值拆分等细节；未覆盖要先判断是遗漏还是暂不迁移，遗漏的补映射行，暂不迁移的补决策记录。部分覆盖项集中出现时，往往说明字段级规则梳理还没完成，应优先处理影响核心业务字段的部分。
源系统在评估期间还在产生新数据，分母怎么处理？
建议在评估开始时按对象类型导出清单并冻结为分母基线，记录导出时间、导出条件和总条数，后续新增数据在下一轮评估中处理。这样同一轮评估内不同人复算能得到相同结果。如果迁移窗口较长，可以约定按固定周期重新冻结基线并重算覆盖率，每轮结果都注明基线时间点，避免把不同时点的数字直接比较。
账号匹配率算出来偏低，应该先补映射还是先确认业务规则？
先看未匹配账号的构成。若多数是离职人员或外部协作账号，应先确认这些账号是否需要迁移，形成决策记录后从分母中剔除；若多数是在职员工但邮箱、工号等匹配依据冲突，则要先确定以哪个依据为准，再补映射。匹配依据的优先级规则确定之前，补映射容易反复返工。无法自动匹配的账号应进入人工处理队列，指定处理人，而不是在映射表中留空。
覆盖率达标后，能否直接进入切换？
覆盖率达标只说明映射表登记完整，切换决策还需要参考部分覆盖项的处理进度和迁移验证的抽样结果。建议把三项放在一起看：各类型覆盖率是否达到约定水平、部分覆盖项是否已按风险排序处理完毕、验证抽样中关键字段和人员归属是否正确。三项都满足再进入切换，单看覆盖率容易漏掉转换错误类问题。
