评估 Jira 迁移数据完整性，核心判断是“应迁尽迁且内容可比”：该迁的对象都进入目标系统，迁过去的内容在字段值、状态和关联关系上仍可对照。本文按对象分层给出分母口径、三类校验证据、可复算公式和验收判定方法，并说明完整率达标后仍需检查的风险。迁移到 ONES 时，迁移后的工作项、字段与遗留缺失项也可以在同一套口径下核对和跟踪。
要点总览（TL;DR）
- 完整性评估先按对象分层：项目与版本、问题与子任务、评论与附件、状态与历史、用户与权限、自定义字段，每层单独确定分母和时间窗，避免总数掩盖局部缺失。
- 记录数完整率=迁移后条数÷迁移前条数×100%，关键字段匹配率=匹配条数÷抽样条数×100%；分母为零时单独标注，不计为100%。
- 总量核对、抽样比对、字段级校验三类证据交叉使用：总量看条数，抽样看内容，字段级校验看状态、经办人、时间与关联关系是否等价。
- 验收判定组合多项指标与差异等级，未迁和迁错原则上切换前处理，字段丢失按影响决定回迁或补录，格式变化可登记为已知差异。
- 完整率达标仍需检查字段错位、关联断裂和抽样代表性；遗留缺失项要登记责任人、处理方式与关闭条件。
评估目标：迁移完整性要回答哪几个问题
完整性评估服务于一个具体决策：迁移后的数据是否足以支撑团队在目标系统恢复研发协作，哪些缺口需要在切换前补齐。它评估的是数据可比性，迁移工具的吞吐量、单条处理耗时属于性能范畴，另行评估。
一份可用的评估目标清单通常包含三类问题。第一类是范围问题：计划迁移的项目、问题、评论、附件、状态历史、用户与权限、自定义字段，是否都有明确的迁移清单和排除清单。第二类是等价问题：迁移后的记录在关键字段上是否与迁移前一致，状态流转、经办人、时间戳、问题关联是否保持原有含义。第三类是解释问题：出现的缺失能否逐条说明原因，属于计划内不迁、映射无对应值，还是迁移遗漏。
评估结论的用途要在开始前写明。用于切换决策时，结论需要给出“可切换、有条件切换、暂缓切换”的判断及依据；用于遗留问题跟踪时，结论需要落到缺失项清单、责任人和关闭条件。两种用途对证据颗粒度的要求不同，前者更关注关键对象层是否达标，后者更关注逐条差异的归属。
还要区分记录数量完整与内容语义完整。问题条数一致，可能同时存在状态被重置、评论附件挂在错误问题上、自定义字段值落入默认值的情况。数量核对只能证明“有这么多条”，语义完整需要字段级比对来证明“每条还是原来那条”。
指标与范围：按对象分层确定分母
完整性指标必须有明确分母，否则总数相等会掩盖某一项目或某一时间段的集中缺失。建议按对象分层建立范围表，每层单独确定分母来源、时间窗和单位，排除项与不迁项在同一张表中显式登记。
| 对象层 | 分母来源 | 时间窗与单位 | 需登记的排除项 |
|---|---|---|---|
| 项目与版本 | 迁移前项目清单、版本列表快照 | 冻结时点的全部项目，单位为个 | 已归档不迁项目、测试项目 |
| 问题与子任务 | 迁移前按项目导出的问题总数，含子任务 | 按项目分别统计，单位为条 | 明确不迁的问题类型 |
| 评论与附件 | 迁移前评论条数、附件文件数 | 与问题同一时间窗，单位为条、个 | 超过大小限制的附件、系统自动评论 |
| 状态与历史 | 迁移前状态流转记录数、当前状态分布 | 按问题统计历史条目，单位为条 | 不保留的中间状态记录 |
| 用户与权限 | 迁移前用户数、用户组数、项目角色成员数 | 冻结时点的有效账号，单位为人、个 | 离职停用账号、外部协作者 |
| 自定义字段 | 迁移前字段清单及有值记录数 | 按字段分别统计，单位为条 | 无对应映射的字段 |
分母的取数时点要统一。推荐在正式迁移前冻结一份基线快照，记录导出时间、筛选条件和导出人。迁移期间原系统若仍有新增数据，应单独标记为增量窗口，避免把迁移后新增的记录算成缺失或重复。分母为零的对象层要单独说明，例如某项目没有附件，该层完整率不参与计算，也不记为 100%。
排除项需要写明理由和影响。计划内不迁的归档项目、无映射目标的废弃字段、超出附件大小限制的文件，都应进入范围表的排除列，并注明由谁确认。排除项不进入分母，但要在报告中列出，便于验收方判断范围是否合理。
数据口径与证据：三类可核验的比对来源
迁移前后的数据要能对齐，前提是取数口径一致。迁移前基线从原系统按项目、问题类型、创建时间等条件导出，冻结后不再变动；迁移后从目标系统按对应的项目、工作项类型和字段导出。两边需要一份字段映射表，说明 Jira 的字段、状态、问题类型分别对应目标系统的哪个对象，哪些字段合并、拆分或不再保留。
三类证据各有覆盖范围，交叉使用才能支撑结论。总量核对覆盖全部对象层，回答“条数对不对”；抽样比对覆盖问题、评论、附件等内容对象，回答“内容像不像”；字段级校验聚焦状态、经办人、时间、关联关系等关键字段，回答“语义对不对”。只做总量核对，无法发现字段错位；只做抽样，无法排除抽样之外的集中缺失。
| 证据类型 | 适用对象层 | 主要作用 | 局限 |
|---|---|---|---|
| 总量核对 | 全部对象层 | 发现整批未迁、重复迁移 | 不能证明内容等价 |
| 抽样比对 | 问题、评论、附件、历史 | 逐字段发现迁错、丢失、格式变化 | 依赖抽样代表性 |
| 字段级校验 | 状态、经办人、时间、关联关系、自定义字段 | 验证关键语义是否保持 | 需先完成字段映射 |
缺失值、空值和默认值要分别记录。原系统中字段为空，迁移后仍为空，属于一致；原系统有值、迁移后为空，属于字段丢失；原系统为空、迁移后出现默认值，属于语义变化，需要判断是否可接受。三类情况在比对表中用不同标记区分，避免把默认值填充误判为迁移成功。
在迁移到 ONES 的场景中，ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，并包括用户、用户组、问题类型、工作流、字段配置和权限配置等系统配置，问题数据涵盖属性、属性值和评论。这些范围可以作为建立对象分层和字段映射表的起点，具体项目的校验口径仍以实际迁移评估和双方确认的范围为准。
计算与评估步骤：从总量到字段级逐层校验
评估按“总量核对—抽样比对—字段级校验—差异归类”的顺序推进，每一步的输出作为下一步的输入。所有比率保留两位小数，分母和单位在报表中同时列出。
第一步，总量核对。按对象层分别计算记录数完整率：
记录数完整率 = 迁移后条数 ÷ 迁移前条数 × 100%
输入是基线快照条数和目标系统导出条数，输出是每层的完整率及差额。差额为正说明存在重复迁移或增量数据混入，差额为负说明存在未迁记录，两种情况都要定位到具体项目或时间段。
第二步，抽样比对。按项目和创建时间分层抽样，样本覆盖活跃项目、历史项目、含附件问题、长评论串等不同类型。逐字段比对后，把差异归入未迁、迁错、字段丢失、格式变化四类，记录问题编号、字段名、原值和迁移后值。
第三步，字段级校验。对状态、经办人、创建与解决时间、问题关联关系等关键字段计算匹配率：
关键字段匹配率 = 匹配条数 ÷ 抽样条数 × 100%
每个关键字段单独计算，不合并成一个总分，因为状态错位和经办人错位对业务的影响不同。
第四步，异常处理。分母为零时，该层标注“无此对象”，不参与汇总，也不计为 100%。对象在目标系统中不存在时，记为未迁并进入差异清单。字段映射无对应值时，先查映射表确认是否属于计划内不迁，属于计划内的记入排除项，不属于的记为字段丢失。
| 步骤 | 输入 | 输出 | 异常处理 |
|---|---|---|---|
| 总量核对 | 基线条数、迁移后条数 | 各层完整率与差额 | 差额定位到项目或时间段 |
| 抽样比对 | 分层样本、字段映射表 | 差异清单与差异类型 | 样本不足时扩大抽样并标注限制 |
| 字段级校验 | 关键字段清单、抽样结果 | 各字段匹配率 | 映射无对应值按排除项或丢失分别记录 |
| 差异归类 | 差异清单 | 未迁、迁错、丢失、格式变化四类汇总 | 逐条指定回迁或人工补录 |
例子：一次问题与评论迁移的完整性核算
以下为演示情景，数字用于说明计算方法，不代表任何真实项目结果。某次迁移前基线快照记录：问题 12,000 条（含子任务 1,500 条），评论 36,000 条，附件 4,800 个。迁移后目标系统导出：问题 11,880 条，评论 35,640 条，附件 4,752 个。
按公式计算：问题完整率 = 11,880 ÷ 12,000 × 100% = 99.00%；评论完整率 = 35,640 ÷ 36,000 × 100% = 99.00%；附件完整率 = 4,752 ÷ 4,800 × 100% = 99.00%。三层差额分别为 120 条、360 条、48 个，需要定位到具体项目。
定位后发现，差额集中在两个已归档项目，共 118 条问题、354 条评论、47 个附件，属于范围表中登记的排除项，应从分母中剔除后重算。剔除后问题完整率为 (11,880) ÷ (12,000 − 118) × 100% ≈ 99.98%，仍有 2 条问题和 6 条评论、1 个附件未找到对应记录，进入差异清单。
抽样 300 条问题做字段比对，状态匹配 291 条，匹配率 97.00%；经办人匹配 297 条，匹配率 99.00%；创建时间匹配 300 条，匹配率 100.00%。差异归类为：未迁 2 条，迁错 3 条（状态落入默认值），字段丢失 4 条（经办人为空），格式变化 3 条（评论中的富文本样式丢失）。
示例结论可表述为：剔除计划内排除项后，问题、评论、附件三层记录数完整率均高于 99.9%，状态匹配率 97.00% 低于其他关键字段，需对 3 条状态迁错记录回迁修正；4 条经办人丢失记录由项目管理员人工补录；格式变化不影响内容可读性，登记为已知差异。该表述同时给出比率、差异数量和处置方式，便于验收方复核。
解读与限制：完整率达标不等于迁移成功
完整率高只能说明数量层面接近一致，不能单独作为切换依据。常见风险是条数齐全但关键字段错位：状态全部落入初始状态、经办人被统一改为迁移账号、问题关联关系断裂。这类问题在总量核对中不可见，需要字段级校验和抽样比对来暴露。
抽样代表性不足会让结论失真。如果样本集中在近期活跃项目，历史项目的字段丢失可能完全不被发现；如果分母口径在迁移前后不一致，例如迁移前含子任务、迁移后不含，完整率就失去可比性。报告中应写明抽样分层依据、样本量和分母口径，出现口径调整时同步重算并标注。
验收判定建议组合多项指标与差异等级，而非设一条通用达标线。可以按对象层设定不同的关注级别：问题、评论、附件等核心内容层要求记录数完整率和关键字段匹配率达到项目约定值；用户与权限层重点核对账号和角色成员是否可用；自定义字段层按字段重要性分级。差异按未迁、迁错、字段丢失、格式变化分级，未迁和迁错原则上在切换前处理，字段丢失按影响范围决定回迁或补录，格式变化可登记为已知差异。
遗留缺失项要有登记和关闭机制。每条记录包含问题编号、差异类型、影响范围、责任人、处理方式和关闭条件，处理完成后由验收方复核关闭。在 ONES 中，迁移后的工作项、字段和状态可以在项目内直接核对，遗留缺失项可以作为独立工作项登记、指派和跟踪关闭，使评估结论与后续处理落在同一套工作项体系中。ONES 方案将数据完整、业务连续和系统稳定作为迁移目标，并建议在正式迁移前确认数据范围、功能匹配和系统适配；这些目标需要通过上述分层校验和验收判定逐项落实，方案表述本身不构成具体项目的完整性结论。
常见问题
迁移前基线快照应该在什么时点冻结，迁移期间原系统还有新增数据怎么办？
基线快照建议在正式迁移开始前冻结，记录导出时间、筛选条件、导出人和导出范围，冻结后不再变动，作为所有分母的唯一来源。迁移期间原系统若仍有新增或修改，应单独划出增量窗口，按同一口径记录条数和时间范围，与基线分开统计。评估时先算基线部分的完整率，再单独说明增量数据的处理方式，避免把迁移后新增记录算成缺失或重复。若增量规模较大，需要重新确认迁移批次和切换窗口，而不是简单并入原分母。
字段映射没有对应值时，应该算缺失还是算计划内不迁？
判断依据是范围表里是否提前登记。迁移前确认字段映射关系时，对无对应目标的字段要写明处理方式：合并到某个字段、保留为文本、或明确不迁。已登记为不迁的，从分母中剔除并列入排除项，报告中注明确认人；未登记却在比对中发现无对应值的，按字段丢失处理，进入差异清单。两种情况对验收结论的影响不同，前者属于范围约定，后者属于迁移缺口，不能混在一起统计。
抽样比对抽多少条、怎么分层才算有代表性？
样本量没有通用标准，取决于对象总量和差异容忍度。分层维度建议至少覆盖项目类型（活跃项目、历史项目、已归档项目）、问题类型、是否含附件、评论长度等，确保每类都有样本。样本量过小时，应在报告中写明抽样方法和覆盖范围，并把结论限定在已抽到的对象上。若抽样中发现集中性差异，例如某项目状态全部落入默认值，应扩大该层抽样或改为全量核对，而不是用原样本比例推算整体。
完整率达到多少可以切换，是否需要设一条统一达标线？
不建议设一条适用于所有项目的通用达标线。更可操作的做法是按对象层设定关注级别：问题、评论、附件等核心内容层，要求记录数完整率和关键字段匹配率达到项目约定的目标值；用户与权限层重点核对账号和角色成员是否可用；自定义字段按业务重要性分级。差异按未迁、迁错、字段丢失、格式变化分级，未迁和迁错原则上切换前处理完毕，字段丢失按影响范围决定回迁或补录。达标线由项目干系人在迁移前确认，并写入验收标准。
迁移后发现问题数据缺失，回迁和人工补录怎么选？
选择依据是缺失规模和关联影响。单条或少量记录缺失，且原系统数据仍可访问时，人工补录成本较低，补录后需重新核对该记录的关键字段和关联关系。整批缺失或涉及状态历史、附件等结构化内容时，回迁更稳妥，回迁后要重新执行该对象层的总量核对和抽样比对。无论哪种方式，都应在遗留缺失项清单中记录问题编号、差异类型、处理方式、责任人和关闭条件，处理完成后由验收方复核关闭。
