Files
ccdi/docs/plans/frontend/2026-04-22-base-staff-dual-sheet-import-frontend-implementation.md
2026-04-24 13:29:13 +08:00

1.8 KiB

员工信息维护双 Sheet 导入前端实施计划

目标

  • 将员工信息维护页面的两个导入按钮合并为一个。
  • 统一使用双 Sheet 模板上传,并根据后端返回的 staffTaskIdassetTaskId 分别沿用原有轮询与失败记录能力。
  • 保留员工失败记录与员工资产失败记录两个独立查看入口。
  • 两个失败记录弹窗都需要展示失败来源 Sheet、Excel 行号和失败原因。

实施内容

  • 页面入口调整
    • 删除“导入资产信息”按钮,仅保留一个“导入”按钮。
    • 删除独立员工资产上传弹窗,保留一个统一上传弹窗。
  • 上传交互调整
    • 去掉“是否更新已经存在的员工数据”复选框。
    • 模板提示调整为双 Sheet 说明,明确支持只填一个或同时填写两个 Sheet。
    • 下载模板文件名统一为“员工信息维护导入模板”。
  • 任务处理调整
    • 上传成功后解析 staffTaskIdassetTaskId
    • 有员工任务 ID 时,启动原员工导入轮询。
    • 有资产任务 ID 时,启动原资产导入轮询。
    • 未返回的任务类型不清空对应历史失败记录状态。
  • 失败记录展示调整
    • 员工失败记录弹窗增加 SheetExcel行号 列。
    • 员工资产失败记录弹窗增加 SheetExcel行号 列。
  • 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