diff --git a/changelogs/2026-05/08_fix_order_v2_admin_departure_date_filter.md b/changelogs/2026-05/08_fix_order_v2_admin_departure_date_filter.md new file mode 100644 index 0000000..814fdf3 --- /dev/null +++ b/changelogs/2026-05/08_fix_order_v2_admin_departure_date_filter.md @@ -0,0 +1,43 @@ +# fix(order-v2): admin 订单管理「出发日期」筛选后端补齐 + +- **PR**: [#1872](https://git.1814.love:8443/wx/HL/pulls/1872) +- **Issue**: [#1865](https://git.1814.love:8443/wx/HL/issues/1865) +- **服务**: hl-order-service-v2 +- **端**: admin +- **影响**: 非破坏性,仅新增两个可选 query 参数 + +## 现象(修复前) + +管理后台「订单管理」列表页筛选「出发日期」无效,前端传值后端忽略。 + +## 根因 + +`OrderPageReqVO` 缺 `departureDateStart/End` 字段,前端传参直接被框架丢弃;Service/Mapper 也未处理 `departureDate` 范围筛选。 + +## 接口变化 + +`GET /admin/order/list` + +新增两个**可选** query 参数(全部省略 = 不筛选,行为与修复前一致): + +| 参数 | 类型 | 格式 | 示例 | 说明 | +|------|------|------|------|------| +| `departureDateStart` | `LocalDate` | `yyyy-MM-dd` | `2026-05-08` | 出发日期起(闭区间) | +| `departureDateEnd` | `LocalDate` | `yyyy-MM-dd` | `2026-05-08` | 出发日期止(闭区间) | + +筛选语义: +- 双值传入 → `WHERE departure_date BETWEEN ? AND ?`(同日 OK) +- 仅起 → `WHERE departure_date >= ?` +- 仅止 → `WHERE departure_date <= ?` +- 全空 → 不附加该条件 + +## 前端配合 + +- mmg 侧无破坏性改动;如已有日期范围控件直接 bind 到 `departureDateStart` / `departureDateEnd` 即可 +- 前端日期控件传 `yyyy-MM-dd` 字符串(不带时分秒) + +## 不动项 + +- `createTimeStart` / `createTimeEnd`(下单时间)筛选行为不变 +- 其他 productType 通用,不限定小蒙马 +- mp 端 / designer 端订单列表本期不动(独立 mapper 方法,前端 UI 也无此筛选)