验证Jira历史记录迁移完整性，需要把“完整”拆成可核对的计数与可抽查的内容两层：先确定迁移范围，再以源端导出快照为基准，按对象类型计算记录数一致率、字段值一致率和链路完整率，最后用分层抽样做人工比对并对差异逐条归因。验收标准应在迁移前书面约定，迁移后只做核对；时区、用户映射和源端在迁移窗口内仍在变更，都会影响结果的可比性。
要点总览（TL;DR）
- 完整性验证要拆成两层：按对象类型做计数比对，按字段与变更链路做内容抽查，两层结论合并使用。
- 分母统一取自迁移前冻结的源端导出快照，并记录导出时间点；时区、用户映射、状态与字段值映射需在比对前对齐。
- 核心指标有三类：记录数一致率、字段值一致率、链路完整率，每类都要写明分子、分母、单位与时间窗。
- 抽样按项目、工作项类型、时间跨度分层，差异逐条归因到映射缺失、格式转换、截断、源端缺失、脚本缺陷等类别。
- 一致率高只说明迁移保真，不证明业务流程在新系统中运行正确；差异未清零时结论应标注为有条件通过。
验证目标：把“历史完整”拆成可判定的验收项
“能打开、能看到”只能说明数据已经落到新系统，不能说明历史记录完整。完整性验证要回答三个层次的问题，每层给出可判定的通过表述，验收时逐层核对。
| 层次 | 要回答的问题 | 通过表述示例 |
|---|---|---|
| 结构完整 | 应迁移的工作项、评论、附件、关联关系是否都在目标端存在 | 各对象类型的目标端计数与源端快照计数一致，缺失对象已列入差异清单 |
| 内容完整 | 字段值、正文、附件内容是否与源端一致 | 参与比对的字段值一致率达到约定阈值，不一致项均有归因 |
| 链路完整 | 字段变更历史、状态流转记录能否按时间顺序还原 | 抽查工作项的历史条目可完整还原，断点或缺失已记录并说明原因 |
这三层目标以及每层的通过条件，应在迁移实施前写入验收方案，迁移完成后只做核对，避免事后根据结果调整标准。完整性验证与业务正确性验证要分开：前者判断数据是否保真，后者判断新系统中的工作流、权限和报表是否符合团队实际使用要求，两者结论不能互相替代。
指标与范围：迁移对象清单与分母定义
计算一致率之前，先确定哪些对象纳入统计、每个对象的计数从哪里取。分母统一取自迁移前冻结的源端导出快照，并记录快照的导出时间点，目标端计数在同一时间窗内统计。
| 对象类型 | 源端计数口径 | 单位 | 备注 |
|---|---|---|---|
| 工作项 | 快照中指定项目与工作项类型的条目数 | 个 | 需明确是否含子任务 |
| 字段变更历史 | 快照中工作项字段变更记录条数 | 条 | 按字段逐项统计 |
| 状态流转记录 | 快照中状态变更记录条数 | 次 | 含流转前后状态与时间 |
| 评论 | 快照中评论条数 | 条 | 含作者与创建时间 |
| 附件 | 快照中附件文件数 | 个 | 另核对文件大小与可下载性 |
| 关联与子任务 | 快照中关联关系条数 | 条 | 区分关联类型 |
| 工时与工作日志 | 快照中工作日志条数 | 条 | 含工时值与记录人 |
范围边界要写清楚：覆盖哪些项目、时间窗从何时到何时、包含哪些工作项类型、是否包含已删除或归档数据。已删除或归档数据是否迁移，取决于迁移方案的事先约定；若不在范围内，应在口径说明中标注，不计入分母。每类对象的计数单位不同，汇总时按对象类型分别报告，不做跨类型加总。
数据口径与证据：源端快照、导出方式与可比性处理
源端基准建议采用迁移前冻结的导出快照或只读副本，记录导出时间点、导出范围和导出方式。目标端数据在迁移完成后、业务恢复写入前统计，避免新产生的数据混入比对。若迁移窗口内源端仍在变更，应设定截断时间点，截断之后产生的变更标记为不可比，不纳入本次一致性计算。
以下口径项需要在比对前逐项对齐，并在口径说明中列明：
- 时区：源端与目标端的时间显示与存储时区是否一致，历史记录时间是否发生偏移。
- 用户与账号映射：源端账号到目标端账号的映射表，处理同名、离职、系统账号等情况。
- 状态与字段值映射：状态名称、选项值、优先级等枚举值的映射表，映射后的值参与比对。
- 富文本与附件存储：正文格式转换规则、附件存储位置与命名规则，判断内容一致时以转换后的呈现为准。
证据留存包括：源端导出文件及其校验值、目标端导出文件、比对脚本输出、差异明细表和比对日志。这些材料应随验收报告归档，便于后续复算和争议追溯。口径未对齐的部分，在结论中单独说明，不与已对齐部分混算。
计算与评估步骤：从计数比对到抽样核对
验证按五个步骤推进，前两步覆盖全量，后三步聚焦内容与链路。
步骤一：按对象类型做总量比对。记录数一致率＝目标端条数÷源端条数×100%。逐类对象分别计算，结果以表格呈现，同时列出绝对差值，便于判断缺失规模。
步骤二：关键字段逐条比对。字段值一致率＝一致条数÷参与比对条数×100%。参与比对条数的取法要事先约定：可以只比对源端非空字段，也可以全字段比对，两种口径结果不可混用。比对范围建议覆盖标题、状态、经办人、优先级、截止日期等关键字段。
步骤三：变更历史链路核对。链路完整率＝历史条目可完整还原的工作项数÷抽查工作项数×100%。“完整还原”的判定条件需事先定义，例如字段变更与状态流转按时间顺序连续、无缺失节点、变更人与变更时间可对应。
步骤四：分层抽样人工比对。按项目、工作项类型、时间跨度分层，每层抽取约定数量的工作项，逐条核对字段值、评论正文、附件和历史记录，记录抽样量与差异明细。抽样量应能覆盖各层，避免只抽近期数据。
步骤五：差异归因与处置。将差异归入映射缺失、格式转换、截断、源端缺失、脚本缺陷等类别，逐条给出处置结论：修复后复验、确认可接受、或列入遗留差异清单。
某类对象在范围内无数据时，标注“不适用”，不计入总体一致率，避免分母为零导致指标失真，也避免用零分母拉高整体结论。
例子：一个可复算的抽样核对过程
以下为方法演示，数字仅用于说明计算过程，不作为通用达标线。
假设某项目在约定时间窗内共有工作项200个，源端快照计数为200，目标端迁移后计数为198，则记录数一致率为198÷200×100%＝99%。差异2个工作项经核查为源端已删除但快照仍保留，归入“源端缺失”类别，列入差异清单。
在剩余198个工作项中，抽取40个核对关键字段，每个工作项核对5个字段，参与比对条数为200条，其中196条一致，字段值一致率为196÷200×100%＝98%。不一致的4条中，3条为优先级枚举值映射缺失，1条为富文本中的表格格式转换后内容错位。
链路核对抽取20个工作项，其中18个的历史条目可按时间顺序完整还原，链路完整率为18÷20×100%＝90%。差异之一为某工作项缺少一次状态流转记录，定位到源端该记录时间为迁移截断点之后，标记为不可比；另一差异为字段变更历史中变更人显示为空，归因于用户映射表缺少该离职账号，处置结论为补充映射后复验。
上述结果合并判断：结构层存在2个已归因差异，内容层一致率98%且差异均有归因，链路层存在1条不可比记录和1条待复验记录。验收结论应如实反映这些遗留项，而不是仅凭单一一致率下结论。
解读与限制：结果怎么读、哪些情况不能下结论
一致率高说明迁移保真度好，不能证明业务流程在新系统中运行正确。工作流配置、权限规则、报表口径是否适配，属于业务正确性验证的范围，需要单独设计核对项。把迁移一致率当作业务验收的全部依据，会掩盖流程层面的问题。
以下情况需要限定结论范围：抽样覆盖不足，未覆盖某些项目或时间跨度较长的历史数据；口径未对齐，例如时区或用户映射存在未处理差异；源端数据本身缺失，导致目标端无法补齐。出现这些情况时，结论应写明“在已核对范围内一致”，并列出未覆盖部分。
差异未清零时，验收报告应附遗留差异清单，逐条记录差异描述、影响范围、责任人、处置方式和关闭条件。关闭条件可以是修复后复验通过、业务方书面确认可接受、或源端数据确认无法提供。清单未关闭前，完整性结论标注为“有条件通过”。
整体验收结论由结构、内容、链路三层指标合并判断，任何一层存在未归因差异，都不宜给出“完整”的结论。指标是判断依据，结论表述要与核对范围和差异状态一致。
在迁移方案落地时，ONES的Jira迁移覆盖项目、工作项、状态、字段、流程、附件和历史记录，迁移问题数据包括属性和属性值、附件、评论等信息，可作为上述核对流程的对象基础；迁移前确认数据范围、功能匹配与系统适配，与本文“先约定验收口径、再核对”的做法一致。具体迁移粒度与校验输出形式，以实际迁移评估和服务方案为准。
常见问题
迁移窗口内源端仍在产生新数据，完整性比对还能做吗？
可以做，但需要先设定截断时间点。以截断时刻冻结的源端快照作为基准，截断之后产生的变更标记为不可比，不纳入一致性计算。目标端数据建议在迁移完成后、业务恢复写入前统计，避免新数据混入比对。若无法设定统一截断点，应在结论中写明“在已核对范围内一致”，并列出未覆盖的时间段。
某类对象在范围内没有数据，一致率怎么算？
分母为零时该对象类型标注“不适用”，不计入总体一致率。跨对象类型不做加总，按类型分别报告结果。这样处理可以避免零分母拉高或拉低整体结论，也便于验收时逐类核对。
字段值一致率的参与比对条数应该怎么取？
常见两种口径：只比对源端非空字段，或全字段比对。两种口径的分母不同，结果不可混用，需要在验收方案中事先约定并写明。比对范围建议覆盖标题、状态、经办人、优先级、截止日期等关键字段，枚举值按映射表转换后再比对。
差异没有清零，验收结论应该怎么写？
验收报告应附遗留差异清单，逐条记录差异描述、影响范围、责任人、处置方式和关闭条件。关闭条件可以是修复后复验通过、业务方书面确认可接受、或源端数据确认无法提供。清单未关闭前，完整性结论标注为“有条件通过”，并说明未覆盖或未归因的部分。
迁移前需要提前约定哪些内容，迁移后才发现标准不合适怎么办？
迁移前应书面约定三层验收目标及每层通过表述、对象清单与分母来源、字段比对口径、抽样方案和差异归因类别。迁移后只做核对，不根据结果调整标准。若实施中发现口径确实不适用，应记录调整原因和影响范围，并对调整前后的结果分别说明，避免直接替换原标准。
