评估Jira迁移数据完整性，需要准备三类可核验的证据：源端与目标端同口径的数据清单（对象、字段、数量、附件与关联关系）、按统一规则计算的核对结果（记录数、字段值、关联链、附件校验值），以及差异说明与处置记录。判断完整性要同时看分子分母、时间窗和缺失值处理，单看“迁移成功”提示或一个记录数不足以支撑结论。
要点总览（TL;DR）
- 评估Jira迁移数据完整性，需要三类可核验证据：源端与目标端同口径的数据清单、按统一规则计算的核对结果、差异说明与处置记录。
- 核心指标包括记录数一致率、字段值一致率、关联关系完整率、附件完整率、历史与评论覆盖率、用户映射成功率，每个指标都要写明分子、分母、单位和统计时间窗。
- 评估前先冻结源端快照并记录截止时间，按对象类型分别统计应迁数与实到数，差异按未迁、转换丢失、重复、映射失败归因并闭环复测。
- 分母为零时指标记为不适用，不同对象类型和不同批次的一致率不宜直接横向比较，通过标准由业务方按关键对象与关键字段约定。
- 单次评估结果只代表当次快照，报告需留存取数脚本或查询语句，复测时使用同一口径才能判断修复是否生效。
评估目标：完整性要回答哪几个问题
完整性评估先要界定评什么。Jira迁移涉及的对象不止工作项本身，还包括承载业务语义的字段、状态流转与历史、评论、附件、工作项之间的关联关系，以及用户和权限映射。评估范围应逐项列出这些对象，并说明本次迁移覆盖哪些项目、哪些时间段的数据。
在此基础上，把“数据完整”拆成三类可分别验证的目标：
- 数量完整：源端应迁的记录在目标端都有对应记录，没有整条丢失或意外重复。
- 内容完整：记录内部的字段值、状态、历史、评论、附件内容与源端一致，转换规则没有造成语义丢失。
- 关系完整：工作项之间的关联、父子层级、附件与工作项的归属、用户与权限的对应关系在目标端正确重建。
三类目标对应不同的证据和指标，不能互相替代。数量对得上但字段大面积错位，属于内容不完整；字段都对但关联链断裂，属于关系不完整。评估结论只针对本次迁移范围与时间窗，不能外推为对系统整体数据质量的判断。
指标与范围：用哪些指标衡量完整性
每个指标都要写清分子、分母、单位和统计时间窗，保证他人能按同样口径复算。下表给出常用指标的定义框架，具体取值由本次迁移范围决定。
| 指标 | 计算方式 | 分子 | 分母 | 单位 |
|---|---|---|---|---|
| 记录数一致率 | 目标端有效记录数÷源端应迁记录数 | 目标端有效记录数 | 源端应迁记录数 | 百分比 |
| 字段值一致率 | 比对一致的字段值数÷比对字段值总数 | 一致字段值数 | 抽样或全量比对的字段值总数 | 百分比 |
| 关联关系完整率 | 目标端成功重建的关联数÷源端关联总数 | 成功重建关联数 | 源端关联总数 | 百分比 |
| 附件完整率 | 校验通过的附件数÷源端附件总数 | 校验通过附件数 | 源端附件总数 | 百分比 |
| 历史与评论覆盖率 | 目标端可查到的历史条目或评论数÷源端对应总数 | 目标端可查条目数 | 源端条目总数 | 百分比 |
| 用户映射成功率 | 成功映射的用户数÷源端需映射用户数 | 成功映射用户数 | 源端需映射用户数 | 百分比 |
口径上有几处必须提前约定。统计截止点应取源端快照冻结的时刻，目标端数据也按同一截止点统计，避免迁移过程中新增数据干扰比对。排除项要写明，例如已删除、已归档、明确不迁的测试数据，排除后分母相应调整，并在报告中说明排除依据和数量。附件校验值可用文件哈希或大小加内容抽样，采用哪种方式需在指标定义中注明。
数据口径与证据：需要准备哪些源端和目标端材料
指标能否算出来，取决于材料是否齐全。评估前应按证据清单逐项落实来源和责任人，避免到出报告时才发现某类数据没有导出。
| 证据项 | 来源 | 用途 |
|---|---|---|
| 源端对象与字段清单 | Jira导出或管理后台查询 | 确定应迁对象类型、字段范围和分母口径 |
| 源端记录数统计 | 按项目、问题类型、时间窗分组查询 | 作为记录数一致率的分母 |
| 附件清单与大小 | 源端附件导出 | 作为附件完整率分母，支持逐项核对 |
| 关联关系导出 | 源端问题链接、父子关系查询 | 作为关联关系完整率分母 |
| 目标端对应清单与查询结果 | 目标系统查询或导出 | 提供各指标的分子数据 |
| 字段映射表与转换规则 | 迁移方案文档 | 解释字段值差异是转换设计还是丢失 |
| 迁移日志与批次记录 | 迁移执行记录 | 定位失败、跳过条目，支撑差异归因 |
| 失败与跳过条目清单 | 迁移日志整理 | 逐条核对是否补迁或确认放弃 |
| 抽样比对记录与差异明细 | 比对脚本输出 | 支撑字段值一致率并保留可复核依据 |
| 用户与权限映射对照表 | 源端用户清单与目标端账号 | 计算用户映射成功率，核对权限归属 |
每类证据要能回答“证明什么”。源端清单证明分母是多少，目标端查询证明实际到了多少，映射表证明差异属于设计内转换还是意外丢失，迁移日志证明哪些条目未进入目标端。缺少任何一类，相应指标就只能标注为待核实，不能默认通过。
计算与评估步骤：从取数到出结论怎么走
评估流程要保证结果可复算、可追溯，建议按以下顺序执行：
- 冻结源端快照并记录截止时间。在迁移开始前或约定时点锁定源端数据，记录快照时间和查询条件，避免边迁边变导致分母漂移。
- 按对象类型分别统计应迁数与实到数。工作项、评论、附件、关联关系、用户分别统计，不用一个总数掩盖某类对象的缺失。
- 全量比对计数，字段与关联按分层抽样或全量比对。记录数适合全量核对；字段值量大时可按问题类型、项目分层抽样，抽样规则和样本量写入报告。
- 附件按数量与校验值比对。先核对数量，再对抽样或全量附件做哈希或内容校验，确认文件可打开且内容一致。
- 汇总差异并按类型归因。把差异分为未迁、转换丢失、重复、映射失败等类别，每类给出条目数和示例。
- 形成评估报告并留存取数脚本或查询语句。报告附上查询条件、脚本版本和执行时间，便于复核和复测。
差异归因是评估的关键产出。同样是60条缺失，归档未迁属于范围约定内，状态映射失败属于需要修复的问题，两者处置方式不同。归因完成后，未闭环的差异要进入处置清单，明确责任人和复测时间。
例子：一次工作项迁移的完整性核算
以下为演示情景，用于说明公式如何代入，数字不代表任何真实项目。
某次迁移源端有10,000条工作项，目标端有效记录9,940条，记录数一致率为9,940÷10,000＝99.4%。差异60条经核对，其中42条属于归档数据未纳入本次迁移范围，18条因状态映射失败未落库。前者是范围约定，后者需要修复后补迁。
字段比对抽取1,000条工作项、每条8个字段，共8,000个字段值，其中7,960个一致，字段值一致率为7,960÷8,000＝99.5%。不一致的40个值集中在自定义字段的选项映射上，需对照映射表确认是转换设计还是丢失。
附件共2,300个，校验通过2,286个，附件完整率为2,286÷2,300＝99.4%。未通过的14个需检查是传输失败还是源端文件本身损坏。
如果源端某类对象没有附件，附件完整率的分母为零，该指标应记为“不适用”，并说明原因，不能记为0%或100%。同理，某项目没有跨项目关联时，关联关系完整率对该项目不适用。
迁移完成后，工作项、字段值、附件和关联关系需要在目标系统中承接核对与差异跟踪。ONES的Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，也支持迁移用户、用户组、问题属性与属性值、评论等信息，迁移后的核对可以围绕这些对象展开；具体可迁移项以实际迁移评估为准。
解读与限制：结果怎么读、哪些情况不可比
一致率高不代表业务可用。记录数和字段值都接近100%，仍可能关键字段（如负责人、优先级、截止日期）存在系统性错位，或关联链在关键路径上断裂。因此除总体指标外，应对核心业务对象和关键字段做定向抽查，确认迁移后团队能按原流程继续工作。
以下情形会导致结果不可比，解读时需要单独说明：
- 不同对象类型的一致率不能直接横向比较，工作项数量大、附件数量小，同样的差异条数对应不同比例。
- 不同迁移批次的时间窗和源端状态不同，批次间一致率不宜直接对比。
- 分母为零时指标不适用，不能参与平均或汇总。
- 源端数据本身缺失、迁移中途源端发生变更，会使分母或比对基准失真。
通过标准应由业务方按关键对象和关键字段约定，例如核心项目的工作项记录数一致率、关键字段一致率和附件完整率分别达到什么水平才算验收通过，而不是套用统一达标线。差异必须闭环处置并复测，单次评估结果只代表当次快照；复测时应使用同一口径和同一取数脚本，才能判断修复是否生效。
常见问题
源端数据在迁移过程中还在变化，完整性评估的分母怎么定？
建议在迁移开始前或约定时点冻结源端快照，记录快照时间和查询条件，所有分母都基于这个快照统计。目标端也按同一截止点取数，迁移期间新增或修改的数据单独记录，不计入本次比对。如果无法完全冻结，至少要在报告中说明源端变更的时间段和影响范围，并把受影响的指标标注为待复核。
字段值一致率用全量比对还是抽样比对，抽样结果能代表整体吗？
记录数适合全量核对，字段值量大时可按问题类型、项目分层抽样。抽样要写清抽样规则、样本量和置信考虑，样本应覆盖主要问题类型和自定义字段。抽样结果只能说明样本范围内的一致情况，对未抽中的字段不能直接推断为一致；关键字段（如负责人、优先级、截止日期）建议全量或定向核对，避免总体指标掩盖系统性错位。
迁移日志显示“成功”，还需要单独做完整性核对吗？
需要。迁移日志的“成功”通常表示任务执行完成，不等于每条记录、每个字段值、每个附件都按预期落库。完整性核对要独立取数：源端清单证明分母，目标端查询证明实到数，映射表解释差异属于设计内转换还是意外丢失。日志的作用是定位失败和跳过条目，支撑差异归因，不能替代指标计算。
差异条目处置后，复测要注意什么？
复测应使用与首次评估相同的口径、相同的取数脚本和相同的统计截止规则，只针对已处置的差异条目及其关联对象重新核对，同时确认修复没有引入新的重复或错位。复测结果与首次结果并列记录，说明修复前后的变化。如果源端快照已变化，需要重新说明分母口径，不能把两次结果直接相减当作修复效果。
迁移后想在目标系统里继续跟踪差异和核对结果，可以怎么承接？
可以把差异条目、责任人和复测时间作为工作项纳入目标系统管理，与迁移后的工作项、字段值和关联关系放在同一套对象体系里核对。ONES的Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，也支持迁移用户、用户组、问题属性与属性值、评论等信息，迁移后的核对可以围绕这些对象展开；具体可迁移项以实际迁移评估为准。
