评估 Jira 迁移数据完整性，需要先按对象分层确定范围，再为每层定义可复算的指标和统一口径，最后用抽样核对与定量结果交叉验证。本文给出一套从取数、计算到验收判定的方法，适用于 Jira 替换项目的迁移验收与切换决策，评估对象限定为迁移结果本身，不涉及目标平台功能优劣的比较。
要点总览（TL;DR）
- Jira 迁移数据完整性评估按六层对象展开：项目与配置、工作项与字段、附件、评论与历史、用户与权限、关联关系，每层单独计算、单独判定，不用单一总数代表整体。
- 每个指标都要固定分母、取数时点、时间窗和排除项；建议以源端记录数为分母，目标端多出的记录单列为多余记录，系统字段不可比时从分母中剔除并说明。
- 计算流程为确定范围、两端取数、按主键匹配、分层计算、分层抽样人工核对、汇总差异清单、判定七步；抽样与定量结果矛盾时以抽样发现为准追查原因。
- 状态、优先级等枚举字段按映射表转换产生的差异属于正常映射差异，源端有值而目标端无记录的属于真实丢失必须整改；完整性指标不保证业务可用性，需结合可用性抽样核对。
- 验收按层设定通过线与阻断项，结论分为通过、有条件通过、不通过，差异清单记录责任人、修复状态与复验结果，评估记录归档作为切换与回退依据。
评估目标：迁移完整性要回答哪几个问题
“数据完整”在迁移验收中是一个复合判断，把它拆成四个可回答的问题，才能对应到具体的取数动作和验收结论。
- 数据是否到齐：源端存在的项目、工作项、附件、评论、用户等对象，在目标端是否有对应记录，数量是否对得上。
- 取值是否一致：到齐的记录中，关键字段的值是否与源端一致，包括文本、选项、日期、人员等字段类型。
- 关系是否保留：工作项之间的父子层级、问题链接、跨项目关联、附件与评论的归属关系，在目标端是否仍然成立。
- 是否可用：迁移后的记录能否被正常打开、检索、流转，附件能否下载，历史记录能否查看。
这四个问题对应不同的证据类型：前三个主要靠两端导出数据比对，第四个需要抽样人工核对。评估结论的用途要在启动前明确：用于正式验收签字、用于切换前的放行决策，还是用于驱动问题整改。用途不同，通过标准的严格程度和阻断项设置也不同。例如用于切换放行时，核心工作项缺失通常应设为阻断项；用于整改跟踪时，则可以先记录全部差异再排优先级。
评估边界同样需要写清楚：本文方法只评价迁移结果的数据完整性，不评价目标平台的功能丰富度、性能表现或使用体验。这些属于选型评估的范畴，与迁移验收分开进行，避免把两类结论混在一张表里。
指标与范围：按对象分层定义完整性指标
用单一总数概括完整性容易掩盖局部问题，例如工作项总数一致但附件大量缺失。可行做法是按对象分六层，每层定义独立指标，分别计算、分别判定。
| 层级 | 指标 | 含义 | 单位 | 统计对象 |
|---|---|---|---|---|
| 项目与配置 | 配置项一致率 | 源端存在的问题类型、工作流、字段配置、权限配置在目标端有对应且关键属性一致的比例 | % | 配置项 |
| 工作项与字段 | 记录数一致率 | 源端工作项在目标端匹配成功的比例 | % | 工作项 |
| 工作项与字段 | 字段取值一致率 | 匹配成功的工作项中，关键字段取值与源端一致的比例 | % | 字段值 |
| 附件 | 附件可下载率 | 目标端附件可正常下载且文件大小、类型与源端一致的比例 | % | 附件 |
| 评论与历史 | 历史条数一致率 | 目标端评论数与变更历史条数与源端一致的工作项比例 | % | 工作项 |
| 用户与权限 | 用户映射率 | 源端活跃用户与用户组在目标端有对应账号且权限归属正确的比例 | % | 用户/用户组 |
| 关联关系 | 关联保留率 | 源端存在的关系（父子、链接、跨项目依赖）在目标端仍然成立的比例 | % | 关系 |
指标单位要固定下来：记录数类指标以“条”为统计对象，字段类指标以“字段值”为统计对象，附件以“个”为单位。同一指标在不同轮次评估中保持相同单位，结果才可对比。每层指标还需要标注关键字段清单，例如工作项层的“关键字段”通常包括标题、状态、负责人、优先级、截止日期和自定义必填字段，清单在评估启动前冻结，避免中途调整口径。
数据口径与证据：分母、时间窗和缺失值怎么定
口径决定结果能否复算。同一批数据，分母取源端还是目标端，结论可能相差几个百分点，因此口径必须在取数前书面固定。
取数时点与时间窗。源端和目标端各取一次全量快照，记录精确到分钟的取数时间。迁移期间如果源端仍有新增或修改，这部分增量数据要单独标记：要么在增量同步完成后再取一次目标端快照，要么在评估报告中声明“本次评估不含某时间点之后的增量”，并注明增量条数。两种做法都可以，关键是写清楚，否则两端数据不可比。
分母定义。建议统一以源端记录数为分母，因为源端是完整性的基准。目标端多出的记录（如迁移产生的重复项）单独统计为“多余记录数”，不进入一致率的分子，但在差异清单中列明。排除项要逐条登记：例如源端已归档且约定不迁移的项目、测试环境产生的临时数据、已删除但保留在回收站的对象。排除项清单需要双方确认后签字，不能事后追加。
缺失值与系统字段。源端为空的字段，目标端也为空视为一致；源端为空而目标端被填入默认值，记为取值偏差。系统自动生成的字段（创建时间、更新时间、记录编号）如果两端生成机制不同，应列为“不可比字段”，从字段取值一致率的分母中剔除并单独说明，不能直接算作不一致。
证据类型。每层指标至少保留三类证据：两端导出的比对文件（含字段清单和匹配主键）、抽样核对记录（样本编号、核对人、核对结论）、迁移日志与校验报告。证据文件按层级和取数时间命名归档，便于复验时追溯。
计算与评估步骤：从取数到出具结论
评估按七个步骤推进，每一步都有明确的产出物，前一步的产出是后一步的输入。
- 确定范围：列出纳入评估的项目清单、对象层级和关键字段清单，形成范围说明书。
- 两端取数：按统一的时间窗导出源端和目标端数据，记录取数时间和导出人。
- 按主键匹配：以工作项编号或迁移映射表为匹配键，建立源端与目标端的记录对应关系，匹配失败的记录直接进入差异清单。
- 计算各层指标：按分层公式逐项计算，保留分子、分母和中间结果。
- 抽样人工核对：按项目、字段类型、时间跨度分层抽样，每层样本量建议不少于30条，样本量不足时全量核对并注明。核对内容包括字段取值、附件打开、评论内容、关系跳转。
- 汇总差异清单：把定量比对和抽样发现的问题合并，按缺失、重复、取值偏差、关系断裂、附件不可用五类归并。
- 判定：对照分层通过标准，给出通过、有条件通过或不通过的结论。
核心公式如下，各层指标按同一结构展开：
- 记录数一致率 = 匹配成功的工作项数 ÷ 源端工作项数 × 100%
- 字段取值一致率 = 关键字段取值一致的字段值个数 ÷ 参与比对的字段值总数 × 100%
- 附件可下载率 = 可正常下载且校验一致的附件数 ÷ 源端附件数 × 100%
- 历史条数一致率 = 评论数与历史条数均一致的工作项数 ÷ 匹配成功的工作项数 × 100%
- 关联保留率 = 目标端仍然成立的关系数 ÷ 源端关系数 × 100%
抽样结果与定量结果出现矛盾时，以抽样发现为准追查原因。例如字段取值一致率显示98%，但抽样发现某类日期字段普遍偏移8小时，说明该字段存在系统性映射问题，应回到差异清单中按字段类型整体登记，而不是当作个别误差忽略。
例子：一个项目集的完整性评估演算
以下为演示情景，数字仅用于说明计算方法。
某次迁移涉及3个项目，源端工作项1200条、附件450个、评论3600条、工作项链接280条。约定排除已归档项目中的40条工作项，排除后源端基数为1160条。
| 层级 | 计算过程 | 结果 |
|---|---|---|
| 记录数一致率 | 匹配成功1148条 ÷ 1160条 | 98.97% |
| 字段取值一致率 | 参与比对字段值9280个，一致9132个 | 98.41% |
| 附件可下载率 | 可下载且校验一致441个 ÷ 450个 | 98.00% |
| 历史条数一致率 | 评论与历史条数均一致1122条 ÷ 1148条 | 97.74% |
| 关联保留率 | 关系仍成立271条 ÷ 280条 | 96.79% |
差异清单记录：12条工作项未匹配（其中8条为迁移中断，4条为编号映射缺失）；148个字段值不一致，集中在“优先级”字段的映射偏差；9个附件下载失败；26条工作项评论条数少于源端；9条链接关系断裂。抽样核对抽取120条工作项，发现3条评论内容截断、2条附件文件名乱码，这两类问题在定量指标中未体现，补入差异清单。
结论表述应分层给出：“工作项层记录数一致率98.97%，未达本项目设定的99.5%通过线，判定为有条件通过，条件是补齐12条缺失工作项并复验；附件层可下载率98.00%，9个失败附件需在切换前修复；关联关系层保留率96.79%，断裂的9条链接需逐条确认是否为源端已失效关系。”这样的表述保留了每层的判断依据，避免用“整体完整率98.5%”掩盖附件和关联层的具体问题。
解读与限制：哪些差异属于正常，哪些必须整改
指标结果需要结合映射规则解释，不能把所有不一致都当作数据丢失。状态、优先级、问题类型这类枚举字段，迁移时通常需要按映射表转换，源端“待办”映射为目标端“未开始”属于正常映射差异，应登记在口径说明中，不计入取值偏差。判断标准是：映射表中有明确对应关系的差异为正常；映射表中无对应、目标端被置空或填入默认值的，属于需要确认的偏差；源端有值而目标端完全无记录的，属于真实丢失，必须整改。
以下情形下结果不可比，需要在报告中单独声明：某层分母为零（例如本次迁移不含附件），该层指标不计算，不能记为100%；抽样样本量过小（如少于30条）时，抽样结论只作参考，不作为判定依据；增量数据未同步完成时，两端快照时间不一致，一致率结果仅代表快照时点状态。
完整性指标反映的是数据层面的对应关系，不能保证业务可用性。一条工作项字段全部一致，仍可能因为工作流配置错误而无法流转。因此定量指标必须与抽样人工核对结合，核对项中应包含“打开工作项并走一次状态流转”这类可用性检查。验收通过标准按层设定，不同层级可以有不同的严格程度：核心项目的工作项记录数一致率可以要求99.5%以上，历史评论条数一致率可以放宽到98%，具体数值由项目方在评估启动前确认，不存在通用达标线。
验收结论与整改闭环：怎么把评估落到切换决策
验收判定按层进行，每层设定通过线和阻断项。阻断项的设置方法是：影响核心业务连续性的差异设为阻断，例如核心项目的工作项缺失、负责人字段大面积丢失、权限配置错误导致用户无法访问；不影响业务连续性的差异设为整改项，例如历史评论条数少量缺失、非关键自定义字段取值偏差。阻断项未清零时，该层判定为不通过。
| 结论 | 适用条件 | 后续动作 |
|---|---|---|
| 通过 | 各层指标达到通过线，阻断项为零，差异清单中的整改项已登记并约定修复时间 | 进入切换准备，归档评估记录 |
| 有条件通过 | 阻断项为零，但部分层级指标低于通过线，差异集中在非核心项目或非关键字段 | 列出条件清单，明确修复责任人和复验时间，条件满足后放行 |
| 不通过 | 存在未清零的阻断项，或核心项目指标显著低于通过线 | 暂停切换，按差异清单整改后重新评估 |
差异清单是整改闭环的载体，每条差异记录对象类型、源端标识、目标端标识、差异分类、影响层级、责任人、修复状态和复验结果。修复完成后由原核对人复验，复验通过才关闭条目。评估记录（范围说明书、口径说明、比对文件、抽样记录、差异清单、判定表）统一归档，作为切换放行和必要时回退的依据。
在整改跟踪环节，可以把差异清单落到具体的工作项管理工具中执行。ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录的迁移，迁移范围也包括用户、用户组、系统配置以及问题数据的属性、附件和评论，评估中发现的差异可以按项目和工作项建立跟踪条目，指定责任人并记录复验状态，使差异清单与复验记录保持在同一套工作项和字段体系中，便于在切换决策前核对阻断项是否清零。
常见问题
迁移期间源端还在新增和修改数据，完整性评估应该怎么处理？
两种做法都可以，关键是写清楚。第一种是在增量同步完成后再取一次目标端快照，两端快照时间尽量对齐；第二种是在评估报告中声明本次评估不含某个时间点之后的增量，并注明增量条数。两种做法下，两端快照时间不一致时，一致率结果只代表快照时点状态，需要在报告中单独说明，不能与全量同步后的结果直接对比。
源端为空的字段，目标端被填了默认值，算不算不一致？
算取值偏差，需要登记。判定规则是：源端为空、目标端也为空，视为一致；源端为空、目标端被填入默认值，记为取值偏差；源端有值、目标端为空或完全无记录，属于真实丢失。系统自动生成的字段（创建时间、更新时间、记录编号）如果两端生成机制不同，应列为不可比字段，从字段取值一致率的分母中剔除并单独说明，不能直接算作不一致。
抽样核对发现的问题在定量指标里没有体现，应该以哪个为准？
以抽样发现为准追查原因，并把问题补入差异清单。定量指标按字段和记录批量计算，容易漏掉内容截断、文件名乱码这类局部问题；抽样能发现这类问题，但样本量有限。两者是交叉验证关系：定量结果给出整体比例，抽样结果用于确认比例背后的具体问题类型。抽样样本量建议每层不少于30条，样本不足时全量核对并注明，样本过小时的抽样结论只作参考，不作为判定依据。
某层分母为零时，该层指标怎么记录？
该层指标不计算，在报告中注明“本次迁移不涉及该层对象”，不能记为100%。例如本次迁移不含附件，附件可下载率就没有分母，记为100%会让人误以为附件层已通过验收。同理，分母很小的层级（如只有几条关联关系）计算出的比例波动很大，应同时列出分子分母的绝对数，供判定时参考。
评估结论用于切换放行时，阻断项应该怎么设？
按是否影响核心业务连续性来设。核心项目的工作项缺失、负责人字段大面积丢失、权限配置错误导致用户无法访问，这类差异设为阻断项，未清零时该层判定为不通过；历史评论条数少量缺失、非关键自定义字段取值偏差，设为整改项，登记责任人和修复时间即可。阻断项清单和通过线在评估启动前由项目方确认，评估过程中不临时追加，避免结论随口径变化。
