研发迁移数据盘点按“定范围—列对象—抽字段—记质量—标依赖—出清单”六步推进：先锁定源系统、目标系统和本次迁移的对象边界，再按项目、工作项、附件、评论、用户与权限逐类清点数量，抽取关键字段并记录类型、长度、必填与含义差异，标注空值、重复、超长和格式异常，最后形成带责任人和核对结论的盘点清单。这份清单是字段映射和试迁移的直接输入，盘点不清就进入映射，返工成本会落在后续每个阶段。
要点总览（TL;DR）
- 盘点按“定范围—列对象—抽字段—记质量—标依赖—出清单”六步推进，每步都留下可复核的记录，范围说明表是第一步的产出。
- 盘点前先落实只读或导出权限、源系统字段字典与状态定义、每类对象的业务确认人，并统一盘点模板与命名规则。
- 逐对象清点数量与数据量，抽取字段的类型、长度、必填和枚举，同时标记空值、重复、超长、格式异常与孤立数据。
- 同名字段含义不同、同义不同名、枚举与状态字典差异、必填选填差异，在盘点阶段就记入差异标注表和待确认问题清单。
- 数量核验用总量比对加抽样复核，清单经迁移负责人和业务确认人确认后冻结版本；关键对象数量对不上或权限资料缺失时应暂停，未确认前不进入映射。
盘点范围怎么定：源系统、目标系统与对象边界
盘点的第一件事是把范围写下来并让相关方确认，避免盘点对象随着迁移推进不断扩张。范围说明至少包含四项：源系统与目标系统的名称和版本、导出方式、纳入盘点的对象类别、时间范围，以及明确排除的内容。
源系统和目标系统要写到可识别的粒度。例如源系统是 Jira 的哪个版本、通过管理后台导出还是数据库只读账号抽取；目标系统是 ONES Project 还是 ONES Wiki，对应承接哪类数据。导出方式决定了后续能否拿到完整的字段和附件，需要在范围阶段就确认，而不是盘点中途才发现某类数据导不出来。
对象类别按迁移内容逐项列出。研发工具迁移常见的对象包括项目、工作项、状态与工作流配置、字段配置、附件、评论、用户与用户组、权限配置，知识库场景还包括空间、页面、附件和权限结构。ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，Confluence 迁移覆盖空间、页面、附件和权限结构，可以把这些类别作为范围表的对照项，逐条标记本次是否纳入。
时间范围要写清起止日期，并单独说明历史归档数据是否纳入。归档数据往往数量大、字段缺失多，是否迁移会显著影响盘点工作量和后续批次划分。排除项同样要写，并注明归属哪个阶段或由谁另行处理，例如工作流与插件行为的迁移不在数据盘点内，应转交对应阶段。
| 范围要素 | 记录内容 | 确认人 |
|---|---|---|
| 源系统 | 名称、版本、导出方式、只读账号 | 系统管理员 |
| 目标系统 | 名称、承接模块、目标空间或项目 | 迁移负责人 |
| 对象类别 | 项目、工作项、附件、评论、用户与权限等，逐项标记纳入或排除 | 业务确认人 |
| 时间范围 | 起止日期、是否含归档数据 | 业务确认人 |
| 排除项 | 排除内容及归属阶段 | 迁移负责人 |
盘点前要准备哪些输入和权限
盘点依赖三类输入：能读到数据的账号权限、能解释字段含义的资料、能对歧义做判断的业务确认人。三者缺一项，盘点就会在某个对象上停住。
权限方面，优先申请只读或导出权限，避免使用管理员账号直接操作生产数据。需要明确的事项包括：账号由谁开通、有效期多长、可访问哪些项目空间、附件能否批量下载、导出是否有条数或频率限制。把这些写进输入与依赖清单，标注到位状态，未到位的项目在盘点记录中注明阻塞原因。
资料方面，需要拿到源系统的字段字典、状态定义、自定义字段说明和权限模型说明。字段字典要能回答每个字段的类型、长度、是否必填、默认值和枚举取值；状态定义要能说明状态与工作流的对应关系。这些资料通常由源系统的管理员提供，缺失时只能靠界面逐项查看，效率低且容易漏项。
人员方面，每类对象指定一名业务确认人，负责确认字段含义、枚举取值、归档范围和排除项。确认事项要具体到可回答的问题，例如“这个自定义字段在业务上表示什么”“这个状态是否仍在使用”，避免笼统地请业务方“看一下数据”。
最后统一盘点模板和命名规则。模板至少包含对象类别、记录数量、数据量、字段清单、质量问题、依赖关系、责任人和核对结论；命名规则统一到“系统_对象_日期_版本”，便于后续比对和交接。
按对象逐类清点：数量、字段与质量记录方法
逐类清点是盘点的核心操作，目标是把每类对象的规模、结构和质量问题变成可复核的记录。建议按对象类别逐个推进，每类完成后再进入下一类，避免多类数据混在一起难以核对。
第一步统计数量和数据量。记录数量用记录条数，数据量用附件总大小、页面正文总量等可测量口径，两者分开记录。数量用于判断迁移批次和顺序，数据量用于评估传输和存储开销。统计时同时记录统计口径，例如“工作项数量含已关闭项、不含归档项目”，保证不同人复核时得到同一结果。
第二步抽取关键字段。每类对象列出参与迁移的字段，逐个记录字段名、类型、长度、是否必填、默认值和枚举取值。字段较多时可按“标识类、状态类、人员类、时间类、附件类”分组，保证覆盖完整。自定义字段单独成表，因为它们的含义差异最大，也最需要业务确认。
第三步标记质量问题。对每个字段统计空值比例，标记重复记录、超长文本、格式异常（如日期格式不统一、多值字段用分隔符混写）和孤立数据（如附件找不到对应工作项、评论找不到所属记录）。质量标记要写到字段和记录两个层级，字段级说明问题类型，记录级给出可抽查的样例编号。
第四步记录对象间引用关系。工作项属于哪个项目、附件挂在哪个工作项、评论属于哪条记录、用户与权限如何关联，这些关系决定迁移顺序，也决定孤立数据能否被识别。引用关系用“源对象—目标对象—关联字段”的格式记录，便于映射阶段直接使用。
| 记录项 | 填写内容 | 用途 |
|---|---|---|
| 对象类别 | 项目、工作项、附件、评论、用户与权限等 | 划分盘点单元 |
| 记录数量 | 条数及统计口径 | 批次划分与总量比对 |
| 数据量 | 附件大小、正文总量等 | 评估传输与存储 |
| 字段清单 | 字段名、类型、长度、必填、默认值、枚举 | 字段映射输入 |
| 质量问题 | 空值比例、重复、超长、格式异常、孤立数据 | 清洗与映射依据 |
| 引用关系 | 源对象、目标对象、关联字段 | 确定迁移顺序 |
同名字段含义不同怎么记录：映射前的差异标注
字段含义差异在盘点阶段就要显性化，留到映射阶段再处理，会让映射讨论反复回到“这个字段到底是什么意思”。差异标注表按字段逐条记录，每条给出源字段、目标字段、差异类型、影响和待确认人。
差异分四类记录。同名不同义：源系统和目标系统都有“优先级”字段，但取值集合和业务含义不同，需要记录两边的枚举值并标注对应关系待定。同义不同名：源系统的“经办人”对应目标系统的“负责人”，记录对应关系即可。枚举值与状态字典差异：状态名称相同但流转位置不同，或枚举值数量不一致，需要列出完整取值对照。必填与选填差异：源系统选填、目标系统必填的字段，要标记为迁移时必须补值的字段。
每条差异标注都要落到“待确认问题清单”，写明问题、影响的对象和字段、建议处理方式和确认人。歧义字段在确认前不进入映射结论，避免把猜测写进映射表。ONES 的 Jira 迁移包含字段配置和权限配置的迁移，字段级对应关系仍需结合实施评估确认，盘点阶段的差异标注正是这项评估的输入。
| 差异类型 | 记录方式 | 示例 |
|---|---|---|
| 同名不同义 | 列出两边枚举值与业务含义，标注对应关系待定 | “优先级”取值集合不一致 |
| 同义不同名 | 记录源字段与目标字段的对应关系 | “经办人”对应“负责人” |
| 枚举与状态字典差异 | 给出完整取值对照表 | 状态名称相同、流转位置不同 |
| 必填与选填差异 | 标记迁移时需补值的字段 | 源系统选填、目标系统必填 |
盘点结果怎么核验并形成可用清单
盘点记录完成后要经过核验才能成为可用清单。核验解决两个问题：数量是否对得上，字段和质量的记录是否可信。
数量核验用总量比对加抽样复核。总量比对是把盘点记录的数量与源系统导出或统计结果逐类对照，差异超过约定阈值时回到该类对象重新清点，并记录差异原因。抽样复核按对象类别抽取一定比例的记录，逐条核对字段值、附件和引用关系是否与记录一致，抽样比例和抽查编号写进核对记录，保证复核过程可追溯。
一致性检查关注导出数据与盘点记录是否同源同版本。导出时间、导出账号、导出范围要记录在案，盘点期间源系统若有新增数据，需注明截止时点，避免用不同时点的数据互相比较。
清单确认由迁移负责人和各类对象的业务确认人共同完成。确认内容包括范围说明、逐对象盘点记录、字段差异标注表和待确认问题清单。确认方式采用签字或系统内审批记录，确认后的清单冻结版本，后续变更走变更记录，不直接覆盖原清单。未确认的清单可以继续补充，但不作为映射阶段的正式输入。
盘点阶段何时暂停或回退
盘点过程中出现以下情况时，应暂停推进而不是带着问题进入映射。
- 关键对象数量无法核对：某类对象的总量比对差异持续存在且找不到原因，说明导出范围或统计口径有问题，需先解决口径再继续。
- 权限或字段说明缺失导致无法判断：拿不到字段字典、状态定义或附件导出权限，相关对象的字段和质量记录无法完成，应暂停该类对象并升级处理。
- 范围反复变更：对象类别或时间范围被多次调整，已完成的盘点记录失去可比性，应回退到范围确认环节，重新冻结范围后再盘点。
- 歧义字段集中在核心对象：工作项等核心对象存在大量待确认字段，说明业务规则尚未对齐，应先完成确认再进入映射。
暂停和回退都要留下记录：暂停原因、影响的对象、责任人和恢复条件。盘点结论未确认前，不启动字段映射和试迁移，这条约定应写进迁移计划，作为阶段准入条件。
盘点清单在ONES中如何承接后续映射
盘点清单需要被持续跟踪，才能保证差异和待确认问题在映射阶段被逐条关闭。在 ONES 中，可以把范围说明、逐对象盘点记录和字段差异标注表沉淀为 Wiki 文档，按对象类别分节，保留版本和确认记录；把待确认问题转为工作项，逐条指派业务确认人，设置截止时间和状态，映射阶段直接引用这些工作项的结论。
交接时，盘点清单文档标注确认状态和冻结版本，待确认问题工作项按对象和字段归类，映射负责人从工作项列表获取未关闭问题，关闭后再更新映射表。ONES 的 Jira 迁移覆盖项目、工作项、状态、字段、流程、附件和历史记录，Confluence 迁移覆盖空间、页面、附件和权限结构，盘点清单中的对象类别可以与这些迁移范围逐项对应，确认哪些类别进入本次迁移、哪些另行处理。
这样，盘点结论、差异确认和映射输入之间形成可跟踪的交接状态：文档记录结论，工作项跟踪未决问题，映射阶段以关闭状态作为进入下一阶段的条件。
常见问题
盘点时发现源系统某类数据导不出来，应该怎么处理？
先把情况记录到输入与依赖清单，写明对象类别、导出受限的原因、影响范围和责任人，再判断这类数据是否属于本次迁移范围。如果属于范围且无法导出，该类对象的数量与字段记录无法完成，按暂停条件处理，升级给系统管理员或迁移负责人协调替代导出方式。不要用界面逐条查看的方式估算数量，估算结果无法支撑后续的总量比对。
历史归档数据要不要纳入盘点？
取决于迁移范围是否包含归档数据。纳入时，盘点要单独统计归档对象的数量和字段缺失情况，因为归档数据往往字段不全、附件路径异常，会明显增加清洗工作量，也影响批次划分。不纳入时，在范围说明表的排除项中写明，并注明由谁在哪个阶段另行处理。两种选择都要在盘点开始前确认，中途改变会让已完成的记录失去可比性。
自定义字段太多，盘点时怎么避免漏项？
以源系统字段字典为准逐项列出，不依赖界面浏览。把自定义字段单独成表，按“标识类、状态类、人员类、时间类、附件类”分组，每个字段记录类型、长度、是否必填、默认值和枚举取值。字段字典缺失时，先向源系统管理员申请，再开始该类对象的字段抽取。自定义字段的含义差异最大，建议同步标注待业务确认的问题，避免在映射阶段才发现歧义。
盘点清单确认后，源系统又有新增数据怎么办？
盘点记录要注明数据截止时点，确认后的清单冻结版本，后续变化走变更记录，不直接覆盖原清单。新增数据如果落在迁移范围内，按变更流程补充盘点并更新数量与字段记录；如果只是截止时点之后的日常新增，在试迁移和正式切换阶段按增量处理。关键是保证总量比对和抽样复核使用同一时点的数据，避免不同时点的数字互相比较。
盘点结论由谁签字确认，确认哪些内容？
由迁移负责人和各类对象的业务确认人共同确认。确认内容包括范围说明、逐对象盘点记录、字段差异标注表和待确认问题清单。确认方式可以是签字或系统内审批记录，确认后清单冻结版本。未确认的清单可以继续补充，但不作为字段映射和试迁移的正式输入，这条约定建议写进迁移计划的阶段准入条件。
