调整开票待办业务场景和后续任务

This commit is contained in:
jsowell
2026-07-17 16:03:54 +08:00
parent 4720194fe7
commit c416bdacc9
2 changed files with 54 additions and 27 deletions

View File

@@ -55,14 +55,18 @@
## 5. 首期业务范围
### 5.1 开票待办
### 5.1 首期开票待办
首期优先实现截图中的开票场景:
首期建设以下两个真实业务场景:
| 待办类型 | 触发条件 | 处理页面 | 完成条件 |
| --- | --- | --- | --- |
| 平台采购开票 | 平台审核拒绝或要求补充材料 | 发票详情/开票申请页 | 用户重新提交或平台关闭任务 |
| 司机开票申请 | 收到司机开票申请 | 发票申请处理页 | 审核通过、驳回或关闭 |
| 待办类型 | 接收人 | 触发条件 | 处理页面 | 完成条件 |
| --- | --- | --- | --- | --- |
| 充电订单开票申请 | 对应运营商管理员 | 用户完成充电后提交订单开票申请 | 发票申请处理页 | 运营商完成开票、驳回或关闭申请 |
| 运营商提现向平台开票 | 对应运营商管理员 | 运营商提现成功,提现状态变为 `已提现` | 财务详情/提现开票处理页 | 运营商提交发票号码及凭证后自动完成,或平台管理员关闭任务 |
首期接收人按运营商管理员角色解析,不向该运营商部门下所有普通用户广播。当前系统创建运营商时使用 `role_id = 3` 创建运营商管理员,实施时需要在测试库确认该角色的 `role_key`,并将角色配置化。
提现向平台开票按“一笔成功提现对应一条待办”实现。首期新增提现开票信息记录,至少保存发票状态、发票号码、凭证地址、提交人和提交时间;后续如平台允许合并多笔提现开具一张发票,再扩展为批量关联模型。
### 5.2 预留业务类型
@@ -74,7 +78,7 @@
| 清分异常 | 清分失败、分账配置错误或账单待处理 |
| 订单异常 | 订单退款、结算或支付异常需要人工介入 |
首期只实现开票待办,其他类型只完成通用模型和扩展接口,不要求全部接入。
首期只实现上述两个开票待办,其他类型只完成通用模型和扩展接口,不要求全部接入。
## 6. 业务流程
@@ -268,7 +272,7 @@ TodoTaskService.countUnread(Long userId);
```java
todoTaskService.createTask(TodoTaskCreateCommand.builder()
.taskType("INVOICE_REVIEW")
.title("司机开票申请")
.title("充电订单开票申请")
.summary("有新的开票申请需要处理")
.businessType("INVOICE_APPLY")
.businessId(invoiceId.toString())
@@ -329,8 +333,8 @@ todoTaskService.createTask(TodoTaskCreateCommand.builder()
### 首期业务
- 平台采购开票待办可以正常生成、展示、跳转和完成。
- 司机开票申请待办可以正常生成、展示、跳转和完成。
- 用户充电订单开票申请待办可以按运营商管理员生成、展示、跳转和完成。
- 运营商提现成功后可以生成“向平台开票”待办,并在提交发票信息后完成。
- 原有 `sys_notice` 公告功能不受影响。
## 14. 实施拆分
@@ -344,10 +348,11 @@ todoTaskService.createTask(TodoTaskCreateCommand.builder()
### 第二期:开票接入
- 接入平台采购开票事件
- 接入司机开票申请事件
- 配置业务路由和完成条件
- 增加接口和页面联调测试
- 将充电订单开票待办接收人收敛为运营商管理员
- 接入提现成功事件,创建运营商向平台开票待办
- 新增提现开票信息表、提交发票信息接口和处理页面
- 配置两个业务场景的路由和完成条件
- 增加接口、事务和页面联调测试。
### 第三期:平台业务扩展