docs: 更新API文档,添加导入交互说明

- 详细的前端交互流程
- 状态持久化说明
- 与员工信息导入的对比

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
wkc
2026-02-08 14:04:25 +08:00
parent 591e8b9ebb
commit 22514b6509

View File

@@ -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 |
---