diff --git a/changelogs/2026-05/22_feat_admin_order_list_detail_overhaul.md b/changelogs/2026-05/22_feat_admin_order_list_detail_overhaul.md index 67c590b..9c1c9fc 100644 --- a/changelogs/2026-05/22_feat_admin_order_list_detail_overhaul.md +++ b/changelogs/2026-05/22_feat_admin_order_list_detail_overhaul.md @@ -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 / #2914(Closes #2899 #2905 #2908 #2912) +> **关联 PR/Issue**: PR #2903 / #2906 / #2909 / #2914 / #2916(Closes #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 #2914(displayStatus 修待出行 tab)→ commit `8be30a562c` -- Issue #2899 / #2905 / #2908 / #2912 已全部 closed +- PR #2916(排序补 updateTime)→ commit `328691813c` +- Issue #2899 / #2905 / #2908 / #2912 / #2915 已全部 closed - 负责人:yst(后端)