From 22514b65090c46736d32d2b0f508572508e96864 Mon Sep 17 00:00:00 2001
From: wkc <978997012@qq.com>
Date: Sun, 8 Feb 2026 14:04:25 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0API=E6=96=87=E6=A1=A3?=
 =?UTF-8?q?,=E6=B7=BB=E5=8A=A0=E5=AF=BC=E5=85=A5=E4=BA=A4=E4=BA=92?=
 =?UTF-8?q?=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 doc/api/ccdi_purchase_transaction_api.md | 38 ++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/doc/api/ccdi_purchase_transaction_api.md b/doc/api/ccdi_purchase_transaction_api.md
index 93c6498..0f8d077 100644
--- a/doc/api/ccdi_purchase_transaction_api.md
+++ b/doc/api/ccdi_purchase_transaction_api.md
@@ -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 |
 
 ---