changelog #5750：派单操作时间线接口（查看日志按钮数据源）

changelogs-v2/2026-08/09_5750_派单操作时间线接口-新增接口-管理后台.md

@@ -0,0 +1,79 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5750"
+title: "派单操作时间线接口：订单卡片「查看日志」数据源"
+consumer: "admin"
+author: "wx"
+change_type: "新增接口"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "后端完成：PR #5762 合并 dev-v3（5e00a58db）并部署 TEST，网关验证 11/11。前端待办：派单看板订单卡片底部加「查看日志」按钮 → 时间线弹窗（模仿房务订单操作日志 Tab）渲染本接口数据。"
+updated_at: "2026-08-09"
+base: "dev-v3"
+generated: "2026-08-09T18:10:00+08:00"
+---
+
+## 新增接口
+
+`GET /admin/fleet/orders/{orderId}/operation-log`
+
+查询该订单全部派单操作时间线（数据源 `fleet_assignment_operation_log`），按 create_time 倒序分页（默认 pageSize=50，上限 200）。
+
+### 请求参数（query）
+
+| 参数 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| page | int | 否 | 页码，默认 1 |
+| pageSize | int | 否 | 每页条数，默认 50，上限 200 |
+| sortBy | string | 否 | `time,desc`（默认）/ `time,asc` 升序看完整时间线 |
+| keyword | string | 否 | 模糊搜索（summary/操作人），≤32 字 |
+| startDate / endDate | string | 否 | 时间区间过滤（ISO 8601，如 `2026-08-01T00:00:00`） |
+
+### 返回体
+
+```json
+{
+  "code": 0,
+  "data": {
+    "records": [
+      {
+        "id": "2086386125831561218",
+        "time": "2026-08-09 17:36:30",
+        "opType": "change_completed",
+        "opTypeLabel": "修改派单完成",
+        "summary": "王骁 修改派单完成：蒙A-E2E99宝音德力格尔 → 蒙A-K1999其木格，生效日 2026-08-23",
+        "operatorName": "王骁",
+        "effectiveDate": "2026-08-23",
+        "detailJson": "{\"previousVehicleId\":\"...\",\"newVehicleId\":\"...\"}"
+      }
+    ],
+    "total": 25,
+    "page": 1,
+    "pageSize": 50
+  }
+}
+```
+
+### 字段说明
+
+- `id` / `time`：日志 ID / 操作时间
+- `opType`：操作类型英文枚举（cancel_requested / cancel_completed / cancel_restored / cancel_failed / cancel_evidence_recorded / driver_notification_recorded / insurance_refund_pending / insurance_refund_succeeded / insurance_refund_failed / change_requested / change_completed / change_failed / slot_added / slot_removed / hold_notification / assignment_created / confirmed / driver_confirmed）
+- `opTypeLabel`：中文标签（直接渲染）
+- `summary`：**后端拼好的可读摘要**（操作人 + 动作 + 前后资源对比，如改派「旧车牌旧司机 → 新车牌新司机，生效日 x」、失败带原因、保险退保带明细统计），前端直接展示
+- `operatorName`：操作人——**企业微信名优先，无企微名显示用户名**；系统/自动动作（如保险退保定时任务）为「系统」
+- `effectiveDate`：生效日（按天改派/取消等），无则 null
+- `detailJson`：明细 JSON 字符串（前后值/原因等），前端按需展示或忽略
+
+### 权限
+
+网关 `/admin/fleet/**` 统一鉴权，车务/管理员可见。
+
+## 验证证据
+
+- 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 一致