hyb-oa/docs/migration-mapping.md

hyb-oa 试点迁移映射清单（R12-lite）

1. 迁移边界

• 本轮只支持 人工导出 / dry-run 核对 / 人工导入主数据。
• 历史业务单据采取 旧 OA 只读归档 策略，不导入到 hyb-oa 继续流转。
• 新系统只接 切换后新建单据。
• 未完结旧单需在切换前由业务人工清空或冻结。

2. 主数据映射

旧 OA 对象	hyb-oa 对象	关键字段	备注
员工	Employee	employee_no、name、email、department_id	dry-run 文件头至少包含 employee_no,name,department_name
部门	Department	name、parent_id、manager_id	dry-run 文件头至少包含 name
预算	Budget / BudgetPool	code、name、department_id、legal_entity_id、cost_center_id	dry-run 文件头至少包含 code,name
法体 / 成本中心 / 供应商 / 费用类型	既有主数据表	编码、名称、启停用状态	建议优先沿用现有编码体系

3. 业务域映射

旧 OA 域	hyb-oa 域	切换策略
报销	reimbursements	切换后新单进入 hyb-oa；旧单仅旧 OA 只读查询
请假	leave-requests	切换后新单进入 hyb-oa；旧单不迁移流程状态
采购申请	purchase-requests	切换后新单进入 hyb-oa；PO/合同历史仅保留编号映射
差旅申请 / 支付	travel-requests / payment-batches	切换后新单进入 hyb-oa；历史订单不重放支付状态
资产台账	assets	可按主数据导入当前资产卡片，历史流转日志保留在旧 OA
门户入口	portal	先切 Portal，再逐域切业务入口

4. 状态映射原则

• draft / reviewing / approved / rejected / cancelled / paid 等状态只做 对照说明，不做历史单据业务态导入。
• 旧 OA 审批中的单据，不在切换后继续迁移到 hyb-oa 跑剩余流程。
• 所有状态核对用于审计与人工校验，不用于自动回放。

5. 编号与附件原则

• 编号：旧 OA 历史编号保留在旧系统；hyb-oa 新单继续使用自身编号规则。
• 附件：历史附件仅做映射清单，不搬运到 hyb-oa 继续流转。
• 如需保留锚点，可在迁移台账中记录“旧编号 / 旧附件路径 / 新系统实体 ID（如有）”对照表。

6. dry-run 文件要求

runType	必需列
employees	employee_no,name,department_name
departments	name
budgets	code,name
masterdata_validation	type,code

7. 切换与回退

1. 导出旧 OA 主数据 CSV。
2. 在 hyb-oa 执行 dry-run，确认 dry_run_ok。
3. 公告旧 OA 新单停用时间。
4. 打开目标 CutoverScope。
5. 试点期观测 Portal、待办、预算预校验、支付批次与消息链路。
6. 如需回退，关闭 CutoverScope 并恢复旧入口。

8. 审计留痕

• 保存 dry-run 记录 ID、上传文件名、差异摘要。
• 保存 CutoverScope 启停时间、操作人和备注。
• 保存试点期首批新单编号、审批截图与付款批次号。