feat(P25-1/P25-5/P26-1/P26-3/P24-1/P29-4): 落地内部OA够用版后端与试运行能力

关联 Issue: P25-1, P25-2, P25-3, P25-4, P25-5, P26-1, P26-3, P24-1, P24-2, P29-1, P29-2, P29-3, P29-4
2026-03-21 18:03:20 +08:00
@@ -0,0 +1,56 @@
+# 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` 启停时间、操作人和备注。
+- 保存试点期首批新单编号、审批截图与付款批次号。