Files
ccdi/docs/plans/frontend/2026-04-22-base-staff-dual-sheet-import-frontend-implementation.md

39 lines
1.8 KiB
Markdown
Raw Normal View History

2026-04-24 13:29:13 +08:00
# 员工信息维护双 Sheet 导入前端实施计划
## 目标
- 将员工信息维护页面的两个导入按钮合并为一个。
- 统一使用双 Sheet 模板上传,并根据后端返回的 `staffTaskId``assetTaskId` 分别沿用原有轮询与失败记录能力。
- 保留员工失败记录与员工资产失败记录两个独立查看入口。
- 两个失败记录弹窗都需要展示失败来源 Sheet、Excel 行号和失败原因。
## 实施内容
- 页面入口调整
- 删除“导入资产信息”按钮,仅保留一个“导入”按钮。
- 删除独立员工资产上传弹窗,保留一个统一上传弹窗。
- 上传交互调整
- 去掉“是否更新已经存在的员工数据”复选框。
- 模板提示调整为双 Sheet 说明,明确支持只填一个或同时填写两个 Sheet。
- 下载模板文件名统一为“员工信息维护导入模板”。
- 任务处理调整
- 上传成功后解析 `staffTaskId``assetTaskId`
- 有员工任务 ID 时,启动原员工导入轮询。
- 有资产任务 ID 时,启动原资产导入轮询。
- 未返回的任务类型不清空对应历史失败记录状态。
- 失败记录展示调整
- 员工失败记录弹窗增加 `Sheet``Excel行号` 列。
- 员工资产失败记录弹窗增加 `Sheet``Excel行号` 列。
- API 调整
- `ruoyi-ui/src/api/ccdiBaseStaff.js` 去掉 `updateSupport` 参数,保持单文件上传定义。
## 验证
- `source ~/.nvm/nvm.sh && nvm use 14.21.3 >/dev/null && cd ruoyi-ui && npm run build:prod`
- 页面联调覆盖:
- 只导员工 Sheet
- 只导资产 Sheet
- 双 Sheet 同时导入
- 两类失败记录入口分别展示
## 影响范围
- `ruoyi-ui/src/views/ccdiBaseStaff/index.vue`
- `ruoyi-ui/src/api/ccdiBaseStaff.js`