完成招聘双Sheet导入改造

docs/reports/implementation/2026-04-23-staff-recruitment-dual-sheet-import-implementation.md

@@ -0,0 +1,84 @@
+# 招聘信息管理双 Sheet 导入实施记录
+
+## 文档信息
+
+- 保存路径：`docs/reports/implementation/2026-04-23-staff-recruitment-dual-sheet-import-implementation.md`
+- 实施日期：2026-04-23
+- 关联范围：招聘信息管理前后端
+
+## 本次修改内容
+
+### 后端
+
+1. 将招聘导入控制器收口为单一模板下载接口与单一导入入口：
+   - 模板改为 `招聘信息` + `历史工作经历` 双 Sheet；
+   - 移除独立 `workImportTemplate`、`importWorkData` 入口。
+2. 调整 `ICcdiStaffRecruitmentService`、`ICcdiStaffRecruitmentImportService` 签名，统一为双 Sheet 单任务提交。
+3. 在 `CcdiStaffRecruitmentServiceImpl` 中统一初始化 Redis 任务状态，任务总数按 `recruitmentList.size() + workList.size()` 统计。
+4. 重写 `CcdiStaffRecruitmentImportServiceImpl` 导入编排：
+   - 主 Sheet 先校验并落库；
+   - 工作经历 Sheet 按 `recruitId` 分组校验；
+   - 工作经历既支持匹配“本次主 Sheet 成功数据”，也支持匹配数据库已有招聘主信息；
+   - 若数据库已存在该招聘记录的历史工作经历，则整组失败，不做覆盖。
+5. 为 `RecruitmentImportFailureVO` 补充 `sheetName`、`sheetRowNum` 字段，失败记录可直接定位到具体 Sheet 和 Excel 行号。
+6. 新增/补充招聘导入回归测试：
+   - `CcdiStaffRecruitmentDualImportContractTest`
+   - `CcdiStaffRecruitmentImportServiceImplTest`
+   - `EasyExcelUtilTemplateTest`
+
+### 前端
+
+1. 招聘信息管理页工具栏只保留一个“导入”按钮，删除独立“导入工作经历”入口。
+2. 上传弹窗文案统一为双 Sheet 模式，模板说明明确为“招聘信息 + 历史工作经历”。
+3. 页面本地状态收口为单任务轮询：
+   - 只保存一个 `currentTaskId`；
+   - 删除按导入类型分流的状态与提示文案。
+4. 失败弹窗统一展示：
+   - `失败Sheet`
+   - `失败行号`
+   - `失败原因`
+   - 以及招聘编号/项目/岗位/候选人/工作单位等辅助字段。
+5. 新增前端静态契约测试：
+   - `staff-recruitment-import-toolbar.test.js`
+   - `staff-recruitment-import-state.test.js`
+   - `staff-recruitment-import-failure-dialog.test.js`
+
+## 影响范围
+
+- 后端：招聘导入模板下载、导入提交、异步导入编排、失败记录返回。
+- 前端：招聘信息管理页导入入口、上传弹窗、导入轮询、失败弹窗。
+- 测试：招聘导入后端定向测试、前端静态契约测试、真实页面 Playwright 验证。
+- 文档：新增本实施记录。
+
+## 验证情况
+
+1. 后端定向测试通过：
+   - 命令：
+     `mvn -pl ccdi-info-collection -am -Dtest=CcdiStaffRecruitmentDualImportContractTest,CcdiStaffRecruitmentImportServiceImplTest,EasyExcelUtilTemplateTest -Dsurefire.failIfNoSpecifiedTests=false test`
+   - 结果：7 个测试全部通过。
+2. 后端编译通过：
+   - 命令：
+     `mvn -pl ccdi-info-collection,ruoyi-admin -am -DskipTests compile`
+   - 结果：`BUILD SUCCESS`。
+3. 前端静态契约测试通过：
+   - 命令：
+     `source ~/.nvm/nvm.sh && nvm use 14.21.3 >/dev/null && node ruoyi-ui/tests/unit/staff-recruitment-import-toolbar.test.js && node ruoyi-ui/tests/unit/staff-recruitment-import-state.test.js && node ruoyi-ui/tests/unit/staff-recruitment-import-failure-dialog.test.js`
+   - 结果：3 个脚本全部通过。
+4. 前端生产构建通过：
+   - 命令：
+     `source ~/.nvm/nvm.sh && nvm use 14.21.3 >/dev/null && cd ruoyi-ui && npm run build:prod`
+   - 结果：构建成功，仅存在原有体积告警，无新增构建错误。
+5. 真实页面 Playwright 验证通过：
+   - 从真实登录页进入 `/maintain/staffRecruitment`；
+   - 在真实导入弹窗中下载双 Sheet 模板；
+   - 使用真实模板生成并上传 `只导招聘信息 Sheet` 样本，成功新增 `RC202604230901`；
+   - 使用真实模板生成并上传 `只导历史工作经历 Sheet` 样本，`RC202604230901` 从 `0段` 变为 `1段`；
+   - 使用真实模板生成并上传 `双 Sheet 同时导入` 样本，成功新增 `RC202604230902` 且直接显示 `1段`；
+   - 再次上传 `RC202604230902` 的工作经历样本，页面出现失败按钮；
+   - 打开失败弹窗后，确认展示了 `失败Sheet / 失败行号 / 失败原因`，并看到错误文案：
+     `招聘记录编号[RC202604230902]已存在历史工作经历，不允许重复导入`。
+6. 测试数据与缓存清理完成：
+   - 通过后端删除接口清理 `RC202604230901`、`RC202604230902`；
+   - 再次查询两条测试招聘名称，返回 `total=0`；
+   - 浏览器侧 `localStorage.staff_recruitment_import_last_task` 已清空；
+   - 已关闭本轮 Playwright 浏览器、前端 `8080` dev server 和后端 `62318` 进程。