feat: admin 订单管理出发日期筛选 (PR #1872 / Issue #1865)

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 也无此筛选）