# 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` 启停时间、操作人和备注。
- 保存试点期首批新单编号、审批截图与付款批次号。

## 9. R18-R22 项目与合同最小导入映射
| 现有表格 | hyb-oa 对象 | 建议最小列 |
| --- | --- | --- |
| 项目台账 | `Project` | `project_no,name,client_name,owner_employee_no,status,target_end_at,is_confidential` |
| 项目成员表 | `ProjectMember` | `project_no,employee_no,role` |
| 里程碑表 | `ProjectMilestone` | `project_no,title,status,due_date,sort_order` |
| 风险表 | `ProjectRisk` | `project_no,title,detail,level,status,owner_employee_no` |
| 合同登记表 | `ContractRegistry` | `contract_no,project_no,counterparty_name,summary,confidentiality_level,archive_location,offline_archive_no,status` |

### 9.1 导入原则
- 优先导入“仍在使用的活动项目”，不追求一次性搬空历史。
- 项目资料正文不导入，`hyb-oa` 只保留资料目录、链接和归档位置。
- 对于涉密合同，CSV 里也只放元数据，不放正文摘要和附件路径明细。