94 lines
3.3 KiB
Markdown
94 lines
3.3 KiB
Markdown
# 完单申请功能实现总结
|
||
|
||
## 功能概述
|
||
|
||
在补齐支付单时，用户可以选择是否申请完成订单。如果勾选了完单申请，审核人员在进行支付审核时可以看到该申请信息。
|
||
|
||
## 数据库修改
|
||
|
||
### 新增字段（zyt_tcm_prescription_order表）
|
||
|
||
```sql
|
||
-- 执行 add_completion_request_field.sql
|
||
ALTER TABLE `zyt_tcm_prescription_order`
|
||
ADD COLUMN `completion_request` tinyint(1) unsigned NOT NULL DEFAULT 0 COMMENT '完单申请：0=未申请，1=已申请' AFTER `payment_slip_audit_remark`,
|
||
ADD COLUMN `completion_request_time` int(11) unsigned NOT NULL DEFAULT 0 COMMENT '完单申请时间' AFTER `completion_request`,
|
||
ADD COLUMN `completion_request_by` int(11) unsigned NOT NULL DEFAULT 0 COMMENT '完单申请人ID' AFTER `completion_request_time`,
|
||
ADD COLUMN `completion_request_by_name` varchar(64) NOT NULL DEFAULT '' COMMENT '完单申请人姓名' AFTER `completion_request_by`;
|
||
```
|
||
|
||
## 前端修改
|
||
|
||
### 1. 补齐支付单对话框（order_list.vue）
|
||
|
||
- 添加"完单申请"单选项（不申请/申请完成订单）
|
||
- 添加提示文字说明
|
||
- 表单数据中添加 `completion_request` 字段（默认值0）
|
||
|
||
### 2. 提交逻辑
|
||
|
||
- 手动创建支付单时，将 `completion_request` 字段传递给后端
|
||
- 关联已有支付单时，同样传递 `completion_request` 字段
|
||
|
||
### 3. 审核对话框
|
||
|
||
- 如果订单有完单申请（`completion_request=1`），显示警告提示框
|
||
- 显示申请人姓名和申请时间
|
||
- 审核人员可以清楚看到该订单已申请完成
|
||
|
||
## 后端修改
|
||
|
||
### 1. 新增支付单接口（addPayOrder）
|
||
|
||
**文件**: `server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php`
|
||
|
||
- 接收 `completion_request` 参数
|
||
- 如果值为1，记录完单申请信息：
|
||
- `completion_request = 1`
|
||
- `completion_request_time = 当前时间戳`
|
||
- `completion_request_by = 操作人ID`
|
||
- `completion_request_by_name = 操作人姓名`
|
||
- 操作日志中记录"并申请完成订单"
|
||
|
||
### 2. 关联支付单接口（linkPayOrder）
|
||
|
||
**文件**: `server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php`
|
||
|
||
- 接收 `completion_request` 参数
|
||
- 如果值为1，记录完单申请信息（同上）
|
||
- 操作日志中记录"并申请完成订单"
|
||
|
||
## 使用流程
|
||
|
||
1. **补齐支付单**
|
||
- 用户在"已发货"状态下点击"新增支付单"
|
||
- 选择手动创建或关联已有支付单
|
||
- 勾选"申请完成订单"选项
|
||
- 提交后，订单记录完单申请信息
|
||
|
||
2. **支付审核**
|
||
- 审核人员点击"支付审核"
|
||
- 如果该订单有完单申请，对话框顶部显示黄色警告框
|
||
- 显示申请人和申请时间
|
||
- 审核人员可以根据完单申请决定是否通过
|
||
|
||
3. **完成订单**
|
||
- 支付审核通过后，订单状态变为"已发货"
|
||
- 满足完成条件（已发货+支付审核通过）时，可以点击"完成订单"
|
||
|
||
## 注意事项
|
||
|
||
1. 完单申请只是一个提示信息，不会自动完成订单
|
||
2. 审核人员仍需手动点击"完成订单"按钮
|
||
3. 完单申请信息在订单详情中可见
|
||
4. 操作日志会记录完单申请的操作
|
||
|
||
## 测试要点
|
||
|
||
- [ ] 手动创建支付单时勾选完单申请
|
||
- [ ] 关联已有支付单时勾选完单申请
|
||
- [ ] 审核对话框正确显示完单申请信息
|
||
- [ ] 申请人姓名和时间正确显示
|
||
- [ ] 操作日志正确记录
|
||
- [ ] 不勾选完单申请时，审核对话框不显示提示
|