changelog-filename-gate / validate (push) Failing after 1s

详情

2026-07-28 09:50:32 +08:00

5.2 KiB

原始文件 永久链接 Blame 文件历史

schema, ticket, title, consumer, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base

schema	ticket	title	consumer	change_type	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	target_release	verified_at	status_note	updated_at	base
hl-changelog/v2	5307	最终不用车稳定槽看板状态与筛选	admin	修改接口	deployed	verified	not_required					后端 PR #5309 已合并并部署测试环境；既有字段的稳定槽聚合与状态筛选语义已修正，前端无需新增字段或改造	2026-07-28	dev-v3

Fleet：最终不用车稳定槽看板状态与筛选

服务：hl-fleet-service Issue：#5307 影响页面：管理后台车务看板、配车矩阵、未派窗口及当天清单 兼容性：接口路径、方法、请求参数和响应字段均不变化；仅修正既有状态、代表资源、统计和筛选语义

问题与目标

逐日最终方案允许同一稳定车辆槽位部分日期实际用车、其他日期明确不用车。此前最终不用车切片仍以基础状态 unassigned 持久化，会覆盖同槽真实已派切片，导致看板误显示待派、代表车辆/司机为空，并使状态筛选和矩阵统计出现幽灵待派。

本次统一识别 dispatchPlanFinalized=1,dailyVehicleUsed=0 的最终不用车事实。该事实不占车辆/司机、不投保、不计费，也不能重新开放普通派车动作。

变更接口

车务看板 `/admin/fleet/board/orders`

同一稳定槽存在实际用车日和最终不用车日时，槽位状态、代表车辆和代表司机来自真实用车切片；稳定槽日期范围仍覆盖全部当前有效服务日。
全日期均最终不用车时，仅在看板只读聚合中归入“最终方案已完成”的既有 assigned 分面；数据库业务状态仍保持 unassigned，不会伪造派车、取消或完结事件。
全日期最终不用车记录固定关闭 canAssign、canRejectRequirement、availableActionCodes 和紧急徽章，不开放重复派车或需求驳回。
assignmentProgress 按权威稳定槽守恒：混合槽和全最终不用车槽不再计入 unassignedSlots。
status/statuses 先取得基础态候选超集，输出前再按最终稳定槽状态复筛；assigned 与 unassigned 互斥筛选不再返回同一需求。
大候选游标扫描会在 5,000 安全上限前排除普通待派，只保留可能聚合为最终方案完成的 final-unused 候选。

配车矩阵 `/admin/fleet/matrix/*`

最终不用车切片不进入车辆甘特条、顶部待派统计、月份统计、未派窗口、当天待派清单、并行派车或衔接计算。
混合槽仍展示所有真实用车车辆段及实际司机，不由无车切片覆盖。
全日期最终不用车不会产生幽灵待派；详情接口原有 dailyVehiclePlan[].planState=NOT_USED 事实保持不变。
普通未最终化 unassigned、holding/assigned/completed、人工加急五键统计、Long ID 字符串和手机号脱敏均保持原语义。

前端处理

无需新增字段或修改请求。继续直接消费后端现有：

assignmentStatus、assignmentStatusLabel
canAssign、canRejectRequirement、availableActionCodes
assignmentProgress.finalizedByFleet
assignmentSlots[]
矩阵 statusCounts 与 effectiveStatusCounts
详情 dailyVehiclePlan[].planState

不要根据基础 unassigned、车辆为空或司机为空自行覆盖后端返回的稳定槽状态和操作权限。

不影响范围

不修改派单五态数据库状态机。
不修改逐日方案写入、车辆/司机占用、费用、保险、对账或完成回调。
不新增 Feign、数据库查询或逐订单 N+1。
不修改 hl-ui；本次为既有字段语义纠正，前端状态为 not_required。

验证证据

后端 PR wx/HL#5309 已 squash 合并至 dev-v3，合并提交 ca23f64fc。
hl-fleet-service 已滚动部署测试环境，8087/8187 双实例健康。
定向核心：395 tests，0 failures，0 errors；Reviewer 上限回归 BoardOrderServiceTest 59 tests 通过。
Fleet reactor verify：2487 tests，0 failures，0 errors，1 skipped；Spotless 629 Java files clean。
独立 Reviewer 首轮发现 assigned 候选超集可能提前触发 5,000 上限；修复并补充“5,000 普通待派 + 1 最终不用车”游标测试后，终审无 P0–P2。
真实测试网关只读验证：矩阵精确状态筛选仅返回请求状态、五键统计守恒；看板 assigned/unassigned 返回状态与筛选一致且需求集合互斥；已完成最终方案未进入 unassigned；Long ID 仍为字符串、手机号保持脱敏，全程无业务写入。
测试环境 API 未暴露内部 final-unused 标记且当前样本未确认存在合法混合槽，因此未伪报真实网关正例；混合槽和全 final-unused 正例由 Service 定向测试覆盖。
网关证据：D:/work2/HL-v3/.tmp/5307-gateway.json，SHA-256 699363c3a06b0d40205ea477c2a0a67daadc2e1718d08ba1102733e66cf2d505。
OpenAPI 与 Spring Cloud Contract：not_required，因为 Controller、DTO/VO/BO、Feign、shared Java、枚举及错误码形状均未变化。

当前状态：后端已部署、网关已验证，前端无需改造。

关联：#5307、#5292、#5301。

5.2 KiB 原始文件 永久链接 Blame 文件历史 Unescape Escape