hl-api-changelog/changelogs/2026-03/2026-03-23_todo_cascade_fix.md

79 行
2.5 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 待办显示修复 + 定制师列表 + 尾款默认值
**日期**: 2026-03-23 16:35
**影响服务**: hl-order-service, hl-user-service
**已部署**: 测试服务器 ✅
---
## 1. 行程编辑确认不再触发全面重置BUG修复
**问题**: 确认房型升级等行程编辑时,错误触发了全面级联重置(退保险、作废合同、清除配房配车、重置所有待办),导致待办显示不对。
**修复后行为**:
- **房型升级/行程编辑确认** → 只回退到待配房,保留保险和合同,保留已有配房配车数据
- **出行人变更** → 退保险+作废合同,重置到待配保险
- **出发日期变更** → 全面重置(退保+作废+清房车+清住宿)
**前端无需改动**,待办接口返回数据自动正确。
---
## 2. 更换定制师列表:只展示有企微的定制师
**接口**: `GET /admin/order/todo/customizer-list`
**变更**: 现在只返回绑定了企业微信的定制师(过滤掉没有企微的管理员账号)。
**前端需改**: 下拉列表展示请用 `wechatName` 字段(企微姓名),不要用 `adminId`
### 返回字段
| 字段 | 类型 | 说明 |
|------|------|------|
| adminId | Long | 管理员ID提交时传这个 |
| username | String | 用户名 |
| avatarUrl | String | 头像 |
| **wechatName** | **String** | **企微姓名(下拉展示用这个)** |
| wechatUserid | String | 企微用户ID |
### 下拉展示建议
```
侯玉凤(定制师)
米明光(定制师)
...
```
`wechatName` 展示,选中后提交 `adminId`
---
## 3. 尾款支付方式默认线下转账
**变更**: 新创建的订单 `balancePayMethod` 默认值改为 `OFFLINE`(线下转账)。
**前端影响**:
- "设置尾款支付方式"弹窗可以改为只在需要切换为在线支付时才弹出
- 或者直接按 `balancePayMethod` 字段回显当前值,默认已经是"线下转账"
---
## 4. 申请修改(解锁)功能确认
后端已实现,接口如下:
### 管理员申请解锁
- **接口**: `POST /admin/order/{orderId}/request-unlock`
- **请求体**: `{ "reason": "解锁原因" }`
- **效果**: 发送通知给C端用户,等待用户确认
### C端用户同意解锁
- **接口**: `POST /internal/mp/order/{orderId}/approve-unlock`(小程序端调用)
- **效果**: 订单解锁,管理员可重新编辑
### 前端需要做
1. 点击"提交申请"调用 `request-unlock` 接口
2. 小程序端收到通知后展示确认弹窗,用户同意后调用 `approve-unlock`
3. 管理员端刷新后可以继续编辑