From 84ff6db6b6bd936a3c07077d156bc69bae5cf5b5 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Fri, 8 May 2026 13:55:29 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20admin=20=E8=AE=A2=E5=8D=95=E7=AE=A1?=
 =?UTF-8?q?=E7=90=86=E5=87=BA=E5=8F=91=E6=97=A5=E6=9C=9F=E7=AD=9B=E9=80=89?=
 =?UTF-8?q?=20(PR=20#1872=20/=20Issue=20#1865)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...ix_order_v2_admin_departure_date_filter.md | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 changelogs/2026-05/08_fix_order_v2_admin_departure_date_filter.md

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