From 289fa89a709f9f9930bc139b177fac1d18b69a4c Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 10 Aug 2026 10:18:48 +0800 Subject: [PATCH] =?UTF-8?q?chore(changelog):=20#5770=20=E6=97=B6=E9=97=B4?= =?UTF-8?q?=E7=BA=BF=E8=AF=BB=E4=BE=A7=E5=90=88=E6=88=904=E7=B1=BB?= =?UTF-8?q?=E9=87=8C=E7=A8=8B=E7=A2=91+keyword/=E7=94=9F=E6=95=88=E6=97=A5?= =?UTF-8?q?=E4=BF=AE=E5=A4=8D=20=C2=B7=20#5777=20discount=E6=B8=85?= =?UTF-8?q?=E5=8D=95=E8=BD=A6=E5=8A=A1=E6=94=BE=E8=A1=8C(0810=20=E5=AE=A1?= =?UTF-8?q?=E6=9F=A5=E6=89=AB=E5=B0=BE)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...750_派单操作时间线接口-新增接口-管理后台.md | 18 +++++++++++++++++- ...订单详情与打印行程单误拦修复-修改接口-管理后台.md | 6 ++++++ 2 files changed, 23 insertions(+), 1 deletion(-) diff --git a/changelogs-v2/2026-08/09_5750_派单操作时间线接口-新增接口-管理后台.md b/changelogs-v2/2026-08/09_5750_派单操作时间线接口-新增接口-管理后台.md index aa53dde..bd37db6 100644 --- a/changelogs-v2/2026-08/09_5750_派单操作时间线接口-新增接口-管理后台.md +++ b/changelogs-v2/2026-08/09_5750_派单操作时间线接口-新增接口-管理后台.md @@ -13,7 +13,7 @@ frontend_ref: "a9a48643" target_release: "" verified_at: "" status_note: "已实现。board.js 新增 getFleetOrderOperationLog；resolveBoardRowActions 全状态分支加「查看日志」（卡片图标按钮+悬浮提示、表格入「更多」）；新建 OperationLogModal 时间线弹窗（分页/keyword/时间区间/升降序，opTypeLabel/summary 直渲）。frontend_ref=a9a48643（BoardCardView 卡片入口由并发提交 7ec70cc0 承载）。" -updated_at: "2026-08-09" +updated_at: "2026-08-10" base: "dev-v3" generated: "2026-08-09T18:10:00+08:00" --- @@ -77,3 +77,19 @@ generated: "2026-08-09T18:10:00+08:00" - hl-fleet-service verify 3319/0F/0E + FleetRedLineArchTest 12/12 + spotless 通过；定向测试 7/7 - TEST 网关实证（订单 26-6436，探针 `tools/probe_5750_operation_log.py` 11/11 PASS）：字段齐全、opTypeLabel 中文、summary 含前后资源对比、系统动作显示「系统」、分页/升序/翻页正常、total 与 DB 一致 + +--- + +## 后端修复补充 (#5770，2026-08-10，PR #5775) + +首版只给 `assignment_created / hold_notification / confirmed / driver_confirmed` 四类补了枚举中文标签，但**没有写入点**——时间线永远缺「新建派单/HOLD 通知/司机确认/确认执行」这四类里程碑行。本次读侧合成补齐，前端**无需改动**，同一接口现返回更完整的时间线。 + +### 行为变化（同接口，返回项更全） +1. **新增 4 类里程碑合成行**：读接口时从 `fleet_assignment` 的 `create_time / hold_sent_at / driver_confirmed_at / confirmed_at` 合成 `assignment_created`(新建派单)/`hold_notification`(HOLD 通知)/`driver_confirmed`(司机确认)/`confirmed`(确认执行) 行，与落表行按时间合并、去重后返回。 + - 合成行 `id=null`（无 `fleet_assignment_operation_log` 主键，前端可据此区分合成 vs 真实行，与房务 #4246 同约定）。 + - 司机确认行 `operatorName` = 司机姓名（非管理员）；其余里程碑走操作人解析。 +2. **keyword 现按前端所见字段过滤**：此前只搜库里恒为「车务/系统」的原始 actor_name 与写侧动作词，按操作人真名/车牌/司机名搜必空；现改为对**渲染后**的 operatorName/summary/opTypeLabel/detailJson 过滤，可搜到展示的操作人真名、车牌、司机名。 +3. **`effectiveDate`「生效日」修复**：改派 summary 的生效日此前因写侧 Hutool 把 LocalDate 序列化成 epoch 毫秒、读侧解析失败而**永不渲染**；现写侧改 ISO 明文、读侧兼容 epoch 毫秒/ISO 两形态，存量数据也能正确显示。 + +### TEST 实证（2026-08-10） +`GET /admin/fleet/orders/2086341233369616386/operation-log` 返回 4 条合成行：新建派单(系统) / 司机确认(巴雅尔) / HOLD 通知(米明光) / 新建派单(系统)，中文标签、操作人三路解析、时间倒序正确。 diff --git a/changelogs-v2/2026-08/09_5751_车务管理员查看订单详情与打印行程单误拦修复-修改接口-管理后台.md b/changelogs-v2/2026-08/09_5751_车务管理员查看订单详情与打印行程单误拦修复-修改接口-管理后台.md index 5ea2767..9a32bc8 100644 --- a/changelogs-v2/2026-08/09_5751_车务管理员查看订单详情与打印行程单误拦修复-修改接口-管理后台.md +++ b/changelogs-v2/2026-08/09_5751_车务管理员查看订单详情与打印行程单误拦修复-修改接口-管理后台.md @@ -62,3 +62,9 @@ generated: "2026-08-09T18:50:00+08:00" ## 前端配合 无需配合。前端调用链不变，角色权限由后端守卫恢复；车务管理员账号（当前角色 VEHICLE_MANAGER）的订单详情/行程单功能自然恢复。 + +--- + +## 后续补充 (#5777 审查扫尾，2026-08-10) + +审查发现同族读端点漏切一个：**优惠/附加费清单** `GET /v3/admin/order/{orderId}/discount-surcharge/list`（`DiscountService.listDiscountSurcharge`）此前仍走 `assertOrderAccessible`，车务管理员打开订单详情「优惠」Tab 会复现 581008。本次守卫切到读侧 `assertOrderReadable`，与支付流水/发票等读端点同口径：VEHICLE_MANAGER 可读，房务/组长 581045、非本单定制师 581008 不变。定向用例 DiscountServiceAccessGuardTest 16 绿，已部署 TEST。前端无需配合。