docs: 更新API文档,添加导入交互说明
- 详细的前端交互流程 - 状态持久化说明 - 与员工信息导入的对比 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -739,11 +739,49 @@ source sql/ccdi_purchase_transaction_menu.sql;
|
||||
|
||||
---
|
||||
|
||||
## 导入功能交互说明
|
||||
|
||||
### 前端交互流程
|
||||
|
||||
1. **上传文件**
|
||||
- 用户点击"导入"按钮
|
||||
- 选择Excel文件
|
||||
- 点击"确定"上传
|
||||
- **导入对话框立即关闭**
|
||||
|
||||
2. **后台处理**
|
||||
- 右上角显示通知:"导入任务已提交,正在后台处理中,处理完成后将通知您"
|
||||
- 系统每2秒轮询一次导入状态
|
||||
|
||||
3. **导入完成**
|
||||
- 全部成功:显示绿色通知"导入完成!全部成功!共导入N条数据"
|
||||
- 部分失败:显示橙色通知"导入完成!成功N条,失败M条"
|
||||
- 如果有失败记录,操作栏显示"查看导入失败记录"按钮
|
||||
|
||||
4. **查看失败记录**
|
||||
- 点击"查看导入失败记录"按钮
|
||||
- 打开对话框显示分页的失败记录
|
||||
- 包含字段:采购事项ID、项目名称、标的物名称、失败原因
|
||||
- 支持清除历史记录
|
||||
|
||||
### 状态持久化
|
||||
|
||||
- 导入状态保存在localStorage中
|
||||
- 刷新页面后仍可查看上次导入结果
|
||||
- 状态保留7天,过期自动清除
|
||||
|
||||
### 与员工信息导入的对比
|
||||
|
||||
采购交易导入完全复用了员工信息导入的逻辑,两者的交互方式完全一致。
|
||||
|
||||
---
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 说明 | 作者 |
|
||||
|------|------|------|------|
|
||||
| 1.0.0 | 2026-02-06 | 初始版本,采购交易信息管理接口 | ruoyi |
|
||||
| 1.1.0 | 2026-02-08 | 添加导入功能交互说明 | ruoyi |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user