From a4fb47b2e3c7393f36df9ad46275f4684a85a525 Mon Sep 17 00:00:00 2001
From: lc <liuchang@1814.love>
Date: Tue, 11 Aug 2026 18:48:41 +0800
Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E6=B4=BE=E5=8D=95=E6=93=8D?=
 =?UTF-8?q?=E4=BD=9C=E6=97=A5=E5=BF=97=E5=BF=AB=E7=85=A7=E5=A5=91=E7=BA=A6?=
 =?UTF-8?q?=EF=BC=88#5862=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...œæ—¥å¿—补全æ“�作人与改派快照-修改接å�£-管ç�†å�Žå�°.md | 225 ++++++++++++++++++
 1 file changed, 225 insertions(+)
 create mode 100644 changelogs-v2/2026-08/11_5862_派��作日志补全�作人与改派快照-修改接�-管���.md

diff --git a/changelogs-v2/2026-08/11_5862_派��作日志补全�作人与改派快照-修改接�-管���.md b/changelogs-v2/2026-08/11_5862_派��作日志补全�作人与改派快照-修改接�-管���.md
new file mode 100644
index 0000000..07c9ad6
--- /dev/null
+++ b/changelogs-v2/2026-08/11_5862_派��作日志补全�作人与改派快照-修改接�-管���.md
@@ -0,0 +1,225 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5862"
+title: "派��作日志补全�作人��作时间与改派资�快照"
+consumer: "admin"
+author: "lc(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "not_required"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "PR #5869 已�入 dev-v3 并部署 TEST；真实登录� Gateway 验��作时间��作人�动作摘��历�改派�级契约。现有管�端�直接展示，无�端代��更。"
+updated_at: "2026-08-11"
+base: "dev-v3"
+---
+
+# 车务派�：�作日志补全�作人��作时间与改派资�快照
+
+> **�务**: hl-fleet-service（8087）
+> **PR**: #5869
+> **Issue**: #5862
+> **日期**: 2026-08-11
+> **影�范围**: 管�端车务看�订�详情和“查看日志�中的派��作记录
+
+---
+
+## ⚠� 关键�化
+
+- �作日志现在稳定返回 `time`�`operatorName`�`opTypeLabel` 和 `summary`，�作人按“�业微信姓� → 系统用户� → 系统�的顺�解�。
+- 改派日志新增结构化 `changeDetail`。新日志�存�作当时的新旧车牌��机姓�快照，���求调用方解� `detailJson` 中的 ID �查询当�车辆或�机档案。
+- 历�日志没有快照时��兼容：展示字段�许按 ID 查询当�档案，`dataCompleteness` 明确返回 `HISTORICAL_PARTIAL`，�得把当�档案值误认为�作时快照。
+
+## 一��更接�清�
+
+| # | 接� | 方法 | 路径 | �更类型 | 说明 |
+|---|---|---|---|---|---|
+| 1 | 派��作时间线 | GET | `/admin/fleet/orders/{orderId}/operation-log` | �应增强 | 日志行补全�作信�与结构化改派详情 |
+| 2 | 车务看�订�详情 | GET | `/admin/fleet/board/orders/{orderId}` | �应增强 | `operationLog.records[]` �步返回相�字段 |
+
+两个接�沿用原有路径�鉴�和分页契约，�新增请求字段。
+
+## 二�接�详情
+
+### 1. 派��作时间线 `GET /admin/fleet/orders/{orderId}/operation-log`
+
+**�应模型**: `Result<FleetOrderOperationLogRespVO>`
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|---|---|---|---|---|---|
+| orderId | Path | String | 是 | Long 字符串 | 订� ID |
+| page | Query | Integer | � | 默认 1 | 页� |
+| pageSize | Query | Integer | � | 默认 50，最大 200 | �页�数 |
+| sortBy | Query | String | � | `time,desc` / `time,asc` | 默认按�作时间倒� |
+| keyword | Query | String | � | 最长 32 字 | 按展示�的摘���作人等内容�索 |
+| startDate | Query | LocalDateTime | � | ISO 8601 | �作时间起点 |
+| endDate | Query | LocalDateTime | � | ISO 8601 | �作时间终点 |
+
+#### 日志行出�
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| id | String / null | 日志 ID；��里程碑记录�为 null |
+| time | String | �作时间，格� `yyyy-MM-dd HH:mm:ss` |
+| opType | String | �作类型英文枚举 |
+| opTypeLabel | String | �直接展示的中文动作�称 |
+| summary | String | �端生�的�作摘�，改派时包���资�和生效日 |
+| operatorName | String | �业微信姓�优先，无�业微信姓�时使用系统用户�；自动任务为“系统� |
+| effectiveDate | String / null | 生效日期，格� `yyyy-MM-dd` |
+| detailJson | String / null | 兼容�留的原始明细 JSON，�建议�端�自行解� ID |
+| changeDetail | Object / null | 改派结构化详情；�改派动作返回 null |
+
+#### `changeDetail` 字段
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| changeDimensions | String[] | �更维度：`VEHICLE`�`DRIVER`�`VEHICLE_FEE` |
+| previousVehicleId / newVehicleId | String / null | 原车�新车 ID |
+| previousVehiclePlateSnapshot / newVehiclePlateSnapshot | String / null | �作当时的原车牌�新车牌快照；历�无快照时为 null |
+| previousVehiclePlate / newVehiclePlate | String / null | 展示值；优先使用快照，历�数��按 ID �级查询当�档案 |
+| previousDriverId / newDriverId | String / null | 原�机�新�机 ID |
+| previousDriverNameSnapshot / newDriverNameSnapshot | String / null | �作当时的原�机�新�机姓�快照；历�无快照时为 null |
+| previousDriverName / newDriverName | String / null | 展示值；优先使用快照，历�数��按 ID �级查询当�档案 |
+| effectiveDate / endDate | String / null | 本次�更的生效日和结�日 |
+| previousUsedDays | Integer / null | 生效日�原资�在�一槽�已使用的有效�务日数；历�未知为 null |
+| affectedServiceDates | String[] | 本次实际�更的�务日期，支��连续日期集� |
+| affectedDays | Integer / null | 本次实际�更�务日数；历�未知为 null |
+| reason | String / null | �更原因 |
+| dataCompleteness | String | `COMPLETE` 或 `HISTORICAL_PARTIAL` |
+
+#### 完整快照�应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "records": [
+      {
+        "id": "2086386125831561218",
+        "time": "2026-08-11 15:05:14",
+        "opType": "change_completed",
+        "opTypeLabel": "修改派�完�",
+        "summary": "lc 修改派�完�：蒙A-E2E99王信 → 蒙A-E2E01�尔�，生效日 2026-08-23",
+        "operatorName": "lc",
+        "effectiveDate": "2026-08-23",
+        "detailJson": "{...}",
+        "changeDetail": {
+          "changeDimensions": ["VEHICLE", "DRIVER"],
+          "previousVehicleId": "2086000000000000001",
+          "previousVehiclePlateSnapshot": "è’™A-E2E99",
+          "previousVehiclePlate": "è’™A-E2E99",
+          "previousDriverId": "2086000000000000002",
+          "previousDriverNameSnapshot": "王信",
+          "previousDriverName": "王信",
+          "newVehicleId": "2086000000000000003",
+          "newVehiclePlateSnapshot": "è’™A-E2E01",
+          "newVehiclePlate": "è’™A-E2E01",
+          "newDriverId": "2086000000000000004",
+          "newDriverNameSnapshot": "�尔�",
+          "newDriverName": "�尔�",
+          "effectiveDate": "2026-08-23",
+          "endDate": "2026-08-25",
+          "previousUsedDays": 2,
+          "affectedServiceDates": ["2026-08-23", "2026-08-24", "2026-08-25"],
+          "affectedDays": 3,
+          "reason": "调整车辆与�机",
+          "dataCompleteness": "COMPLETE"
+        }
+      }
+    ],
+    "total": 1,
+    "page": 1,
+    "pageSize": 50
+  },
+  "success": true
+}
+```
+
+#### 历�日志�级示例
+
+```json
+{
+  "previousVehiclePlateSnapshot": null,
+  "previousVehiclePlate": "è’™A-E2E99",
+  "previousDriverNameSnapshot": null,
+  "previousDriverName": "王信",
+  "newVehiclePlateSnapshot": null,
+  "newVehiclePlate": "è’™A-E2E01",
+  "newDriverNameSnapshot": null,
+  "newDriverName": "�尔�",
+  "previousUsedDays": null,
+  "affectedServiceDates": [],
+  "affectedDays": null,
+  "dataCompleteness": "HISTORICAL_PARTIAL"
+}
+```
+
+### 2. 车务看�订�详情 `GET /admin/fleet/board/orders/{orderId}`
+
+订�详情原有 `operationLog.records[]` �用上述日志行模型。本次�步增加并补全 `time`�`opTypeLabel`�`summary`�`operatorName` 和 `changeDetail`，字段�义�历��级规则与独立�作时间线接�一致。
+
+## 三�修改��对比
+
+### 字段级对比
+
+| 字段 | 修改� | 修改� |
+|---|---|---|
+| time | 部分�作记录展示字段�完整 | ���展示记录返回标准�作时间 |
+| operatorName | �能�有泛化角色�或缺失 | �业微信姓�优先，系统用户�兜底，自动任务显示“系统� |
+| summary / opTypeLabel | 动作信��完整或需�调用方拼装 | 返回中文动作�称和�直接展示的完整摘� |
+| detailJson | 调用方需解�车辆��机 ID，且查询结果会�当�档案�化影� | 兼容�留，��作为稳定展示契约 |
+| changeDetail | 无 | 返回新旧车辆��机�使用天数�影�日期�完整性标记 |
+| 车牌与�机姓� | �能展示当�档案值，无法�明�作当时�称 | 新日志�存�作时快照；历�日志明确标记�级状� |
+
+### 行为级对比
+
+| 场景 | 修改� | 修改� |
+|---|---|---|
+| �作人展示 | �能无法识别具体人员 | �微姓�优先，无�微姓�时显示系统用户� |
+| �车或��机 | 仅凭 ID 无法稳定还原��资� | 直接返回�作当时的新旧车牌与�机姓�快照 |
+| 历�无快照 | 容易把当�档案误当作历�事实 | ��级展示，但通过 `HISTORICAL_PARTIAL` 明确说明�完整 |
+| 车辆费用�独�化 | �能被误写��车或��机 | `changeDimensions` �独标记 `VEHICLE_FEE`，动作摘�按实际维度生� |
+
+## 四�契约约�与兼容边界
+
+- 调用方应优先读�结构化 `changeDetail`；`detailJson` 仅为兼容字段，���适�作为长期展示数��。
+- `*Snapshot` 是�作时事实；�带 `Snapshot` 的车牌��机展示字段�能是历�数�按 ID 查询当�档案�的�级值。
+- �有本次�作应�存的车牌和�机姓�快照��全时，`dataCompleteness` �返回 `COMPLETE`；存�日志�会伪造快照。
+- 仅�更车辆�仅�更�机��时�更车辆与�机�仅�更车辆费用，�以 `changeDimensions` 的实际值为准。
+- ID 按字符串返回，调用方�得转�为 JavaScript Number。
+- 本次�改�接�路径�请求�数����分页�排�和统一 `Result` �应结构。
+- 快照仅包�车牌和�机姓�，�新增手机���件�或其他�感信�。
+
+## 五��端影�
+
+`frontend_status=not_required`。现有管�端已��以直接展示�作时间��作人和�端摘�，本次 TEST 页�已看到“原车牌/原�机 → 新车牌/新�机�的改派结果，无需�步修改�端代�。其他调用方如�解� `detailJson`，应�步改为优先消费 `changeDetail`。
+
+## 六�验�与测试��
+
+- PR #5869 已�入 `dev-v3`，�并�交：`2d9c6ba4f8af1ad997b8b6e3ba7d215b9754ae66`；TEST 的 Fleet �务�实例�康。
+- 使用真实登录身份� TEST Gateway 调用 `GET /admin/fleet/orders/{orderId}/operation-log` 返回 200。订� `26-3420` 的 10 �记录�具有�空�作时间�动作��作人和摘�。
+- TEST 管�端订� `26-6436` 的日志页�直接展示 `蒙A-E2E99/王信 → 蒙A-E2E01/�尔�`�动作�生效日��作人和时间。
+- �一订� 3 �存�改派记录�返回 `HISTORICAL_PARTIAL`，且 `changeDetail` 快照�展示值�使用天数和�影�日期等契约字段完整存在，历�无快照字段�� null。
+- #5862 定�自动化测试 620 项通过；Fleet 扩大测试 3604 项通过�0 失败�0 错误�7 跳过；固定端� MySQL 集�测试 11/11 通过。
+- 为��通知�派�和审计副作用，TEST 验收未�交新的改派�作；新写日志 `COMPLETE` 快照路径由自动化测试覆盖，测试业务数�状�未改�。
+- 工�验收标准 14/14 已勾选，验收记录已写入，Issue #5862 已关闭。
+
+## 七��影�范围
+
+- �新增或修改数�库结构。
+- �修改管�端��程��H5 或其他�端代�。
+- �改�派�状�机�派�确认��机通知��险�结算和车辆费用计算规则。
+- �回填或改写历�日志；历�记录���读�级展示。
+
+## 关�
+
+- Issue: #5862
+- PR: #5869
+- �端�并�交: `2d9c6ba4f8af1ad997b8b6e3ba7d215b9754ae66`
+- �系人: @lc