docs(changelog): 车务派单看板日期范围只按当年取数、跨年输入被忽略(前端优化)
changelog-filename-gate / validate (push) Failing after 2s

这个提交包含在:
wx
2026-09-24 17:33:28 +08:00
父节点 d9926ebb8f
当前提交 43cebd84f6
@@ -0,0 +1,43 @@
---
schema: "hl-changelog/v2"
ticket: "frontend"
title: "车务派单看板的日期范围只按「当前年份」取数,跨年日期输入被静默忽略"
consumer: "admin"
author: "wx(GIT)"
change_type: "前端优化"
backend_status: "not_required"
gateway_status: "not_required"
frontend_status: "pending"
frontend_owner: "mmg"
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "浏览器实测(测试服 web.test.1814.love,2026-09-24 17:2x,车务管理员角色):派单看板 /fleet/board 的「日期范围」两个输入框显示为 MM-DD(默认 01-01 ~ 09-24),首次加载发出的请求是 /admin/fleet/board/orders?startDate=2026-01-01&endDate=2026-09-24(年份=当前年)。向输入框键入完整跨年日期(2027-01-01 / 2027-03-31)后:输入框文本确实变成新值,但再次点「搜索」**没有发出任何新请求**(board/orders 调用数保持 1),组件模型仍是旧区间。⇒ 2027 年出团的团期在本看板上无法通过日期筛选调出(同类数据在「团期配车」/fleet/group-dispatch 页可按 2027 日期筛出)。本条只提交互与可发现性:若产品定位就是「当年作业看板」,请在界面上标明或直接禁掉跨年输入;本月测试数据与明年真实排期多为 2027 年出团,看板够不着。"
updated_at: "2026-09-24"
base: "dev-v3"
---
# 车务派单看板 · 日期范围跨年不可达(输入被静默忽略)
> **端**: 管理后台 | **页面**: 车务管理 → 派单看板 `/fleet/board` | **Issue**: 无(交互/可发现性,需前端确认定位后处理)
---
## 一、现象(浏览器实测)
1. 打开派单看板(车务管理员角色),「日期范围」两个输入框显示 `01-01` 与 `09-24`(无年份);
2. 首屏请求为 `/admin/fleet/board/orders?startDate=2026-01-01&endDate=2026-09-24&page=1&pageSize=20` —— **年份取当前年**;
3. 在输入框键入完整日期 `2027-01-01` / `2027-03-31`:输入框文本**确实变成**新值,但再点「搜索」**没有发出任何新请求**(同一路径的调用数保持为 1),组件模型仍是旧区间;
4. 结果:**2027 年出团的团期在派单看板上无法调出**。对照组:团期配车页 `/fleet/group-dispatch` 可以用 `departDateFrom/To=2027-*` 正常筛出 2027 年团期(实测列出 `Q202703102102983574083006466` 等)。
## 二、判断边界
- **不是后端缺陷**:接口按传入的 `startDate/endDate` 正常过滤,本条的输入框没把跨年区间传出去。
- **可能是有意为之**(派单看板是「近期待派车」作业台,按当年取数是合理定位);因此本条目**不要求改成跨年可选**,只要求二者之一:
1. 若定位就是当年 —— 在界面上标明(如占位文案写「本年度」),并对跨年输入给出反馈,**不要接受后又静默丢弃**;
2. 若需要跨年 —— 让日期范围选择器带上年份并把区间如实传给接口。
## 三、影响范围
- **仅交互与可发现性**:`/fleet/board` 的日期范围控件与提示文案。
- **零影响**:`/admin/fleet/board/orders`、`/board/summary` 的入参与过滤语义;团期配车、矩阵派单、车队对账等其它页面。