feat(order-v2): admin 订单列表改造 changelog 追加 updateTime 排序 (PR #2916)

原 changelog (commit bf1788a) 漏了 updateTime 排序选项, 同文件追加:
- 关键变化总览: 列表排序补 "+ updateTime (最近更新)"
- 第 2 节排序枚举表: 加 updateTime 行 + 业务场景说明
- 前端建议段: 加"最近更新"下拉选项 + 与 createTime 区别提示
- 第 7 节测试建议: 加 updateTime DESC 验证 case
- 第 8 节关联: 加 PR #2916 + Issue #2915

Closes #2915
这个提交包含在:
yaosutu 2026-05-22 18:55:36 +08:00
父节点 bf1788ae5e
当前提交 c51c78512d

查看文件

@ -1,7 +1,7 @@
# feat(order-v2): /admin/order/list + /admin/order/{id} 综合改造(搜索 / 排序 / 详情行程 / 状态 tab
> **仓库**: HL (后端 hl-order-service-v2)
> **关联 PR/Issue**: PR #2903 / #2906 / #2909 / #2914Closes #2899 #2905 #2908 #2912
> **关联 PR/Issue**: PR #2903 / #2906 / #2909 / #2914 / #2916Closes #2899 #2905 #2908 #2912 #2915
> **日期**: 2026-05-22
> **影响范围**: 管理后台「订单管理」列表 + 详情
> **接收方**: mmg (前端)
@ -14,7 +14,7 @@
| 维度 | 改动 | 前端动作 |
|---|---|---|
| 搜索 keyword | 现支持 **完整 11 位手机号精确匹配**(加密列等值),姓名/订单号/产品名仍 LIKE | placeholder 加"完整手机号" |
| 列表排序 | 新增 `depositAmount`(订金金额)排序 | 排序下拉加"订金金额"选项 |
| 列表排序 | 新增 `depositAmount`(订金金额)+ `updateTime`(最近更新)排序 | 排序下拉加"订金金额"+"最近更新"选项 |
| 列表 tab 筛选 | 新增 `displayStatus` 参数,**原型 5 tab 必须用这个**status 是内部细粒度,对不上 tab | tab 切换的 status 参数改名为 `displayStatus` |
| 订单详情 | 新增 `itinerary` 字段(行程按天结构化,含景点 + 酒店) | 详情页"行程概览"段渲染 |
@ -59,11 +59,14 @@
| `departureDate` | desc / asc | 出发日期 |
| `totalPrice` | desc / asc | 订单金额 |
| `depositAmount` ⭐ | desc / asc | **订金金额(新增)** |
| `updateTime` ⭐ | desc / asc | **最近更新新增,PR #2916** — 业务场景:定制师/客服优先看"最近有动作"的订单 |
| 不传 / 未知值 | — | 兜底按 createTime DESC |
### 前端建议
排序下拉选项追加"订金金额(高→低)/(低→高)",业务场景是财务对账(找订金大但未付尾款的订单优先催)。
排序下拉选项追加:
- "订金金额(高→低)/(低→高)":财务对账场景(找订金大但未付尾款的订单优先催)
- "最近更新(新→旧)":定制师工作流场景(看哪些订单今天有动静)—— 注意这是 `update_time` 不是 `create_time`,能把"老订单今天有退款 / 改单"的情况顶到前面
---
@ -209,6 +212,7 @@ ItineraryHotelVO {
| 完整手机号搜 | 搜 `17600545225` | 精确命中(如有该号订单) |
| 部分号搜 | 搜 `176` | 不命中加密订单(只命中订单号/姓名/产品名含 "176" 的) |
| 订金排序 | sortField=depositAmount&sortOrder=desc | 单调递减 |
| 最近更新排序 | sortField=updateTime&sortOrder=desc | 与 createTime DESC 结果**不同**(老订单今天更新的会排到前面) |
| 待出行 tab | displayStatus=PENDING_DEPARTURE | 应命中(测试服 8 单) |
| 详情行程 | 打开任一已下单订单详情 | itinerary 非空数组 |
| 不传新参数 | 老接口调用方式 | 行为完全不变 |
@ -221,5 +225,6 @@ ItineraryHotelVO {
- PR #2906(搜索+排序)→ commit `689d47013`
- PR #2909(手机号精确匹配,修 #2906 假阳性)→ commit `fbf803b1b`
- PR #2914displayStatus 修待出行 tab→ commit `8be30a562c`
- Issue #2899 / #2905 / #2908 / #2912 已全部 closed
- PR #2916(排序补 updateTime→ commit `328691813c`
- Issue #2899 / #2905 / #2908 / #2912 / #2915 已全部 closed
- 负责人yst后端