From e5590457018747feff0adad3feec31dad9dd84f1 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 6 Jul 2026 22:29:58 +0800
Subject: [PATCH] docs: add fleet protocol price changelog

---
 ...﹀姟娲捐溅鍗忚浠峰揩鐓т笌瀵硅处鍙栦环鍙ｅ緞-绠＄悊鍚庡彴.md | 106 ++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 changelogs-v2/2026-07/33_4797_杞﹀姟娲捐溅鍗忚浠峰揩鐓т笌瀵硅处鍙栦环鍙ｅ緞-绠＄悊鍚庡彴.md

diff --git a/changelogs-v2/2026-07/33_4797_杞﹀姟娲捐溅鍗忚浠峰揩鐓т笌瀵硅处鍙栦环鍙ｅ緞-绠＄悊鍚庡彴.md b/changelogs-v2/2026-07/33_4797_杞﹀姟娲捐溅鍗忚浠峰揩鐓т笌瀵硅处鍙栦环鍙ｅ緞-绠＄悊鍚庡彴.md
new file mode 100644
index 0000000..35d4c76
--- /dev/null
+++ b/changelogs-v2/2026-07/33_4797_杞﹀姟娲捐溅鍗忚浠峰揩鐓т笌瀵硅处鍙栦环鍙ｅ緞-绠＄悊鍚庡彴.md
@@ -0,0 +1,106 @@
+# 33 路 杞﹀姟娲捐溅鍗忚浠峰揩鐓т笌瀵硅处鍙栦环鍙ｅ緞锛圛ssue #4797锛�
+
+鏃ユ湡锛�2026-07-06  
+褰卞搷绔細绠＄悊鍚庡彴杞﹀姟妯″潡  
+鍚庣鐗堟湰锛歚dev-v3` 宸插悎骞�/閮ㄧ讲鍚庣殑 fleet 鎺ュ彛  
+
+## 鍙樻洿缁撹
+
+娲捐溅鏃舵柊澧�/鏄庣‘ `protocolPrice` 鍗忚浠锋棩鍗曚环蹇収锛屽崟浣嶏細鍏�/杞﹀ぉ銆傚墠绔湪娲捐溅寮圭獥鏈夋槑纭崗璁环鏃朵紶鍏ワ紱涓嶄紶鏃跺悗绔細鎸夋墍閫夎溅杈嗚溅鍨� + 鐢ㄨ溅寮�濮嬫棩浠庝环鏍兼棩鍘嗗厹搴曘�備繚瀛樺悗鍐欏叆 `fleet_assignment.protocol_price`锛屽悗缁湅鏉裤�佺煩闃点�佸綋澶╄鍗曞拰鍐呴儴鏌ヨ鍧囧洖鏄捐蹇収銆�
+
+瀵硅处 prep 鐢熸垚鏃朵紭鍏堜娇鐢ㄦ淳鍗曞揩鐓э紱鍘嗗彶娲惧崟蹇収涓虹┖鏃舵墠鍥為��浠锋牸鏃ュ巻銆傚揩鐓т负绌轰笖浠锋牸鏃ュ巻涔熺己浠锋椂锛屼粛杩斿洖 `605607`銆�
+
+## 1. 鍒涘缓娲惧崟
+
+`POST /admin/fleet/assignments`
+
+璇锋眰鏂板/鏄庣‘瀛楁锛�
+
+| 瀛楁 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
+|---|---|---|---|
+| `protocolPrice` | string | 鍚� | 鍗忚浠锋棩鍗曚环锛屽厓/杞﹀ぉ锛岄噾棰濆瓧绗︿覆銆備笉鑳藉皬浜� 0銆倈
+
+璇锋眰绀轰緥锛�
+
+```json
+{
+  "orderId": "1934567890123456789",
+  "orderNo": "26-0503",
+  "requirementId": "1934567890123456790",
+  "fleetItemIndex": 0,
+  "vehicleId": "1934567890123456701",
+  "driverId": "1934567890123456702",
+  "startDate": "2026-05-06",
+  "endDate": "2026-05-11",
+  "pickupAt": "hailar",
+  "dropoffAt": "hailar",
+  "headcount": 6,
+  "protocolPrice": "1300.00",
+  "holdMode": 1,
+  "fromEntry": "from-board",
+  "skipCityJunctionException": false,
+  "strictSeats": false,
+  "requestId": "fleet-assign-20260706-001"
+}
+```
+
+鍝嶅簲绀轰緥锛�
+
+```json
+{
+  "code": 200,
+  "data": {
+    "id": "2073746962003144705",
+    "assignmentStatus": "holding",
+    "protocolPrice": "1300.00",
+    "holdSentAt": "2026-05-04T09:00:00+08:00"
+  },
+  "message": "宸查攣瀹氭帓杞�(holding),寰呭徃鏈哄洖鎵�"
+}
+```
+
+## 2. 鍥炴樉鎺ュ彛
+
+浠ヤ笅鎺ュ彛閮戒細鍥炴樉 `protocolPrice`锛�
+
+| 鎺ュ彛 | 瀛楁璺緞 |
+|---|---|
+| `GET /admin/fleet/board/orders/{orderId}` | `data.currentAssignment.protocolPrice` |
+| `GET /admin/fleet/matrix/grid` | `data.vehicles[].assignments[].protocolPrice` |
+| `GET /admin/fleet/matrix/day-orders` | `data[].assignments[].protocolPrice` |
+| `GET /internal/fleet/assignment-by-order` | `data.currentAssignment.protocolPrice`銆乣data.history[].protocolPrice` |
+
+鐭╅樀绀轰緥锛�
+
+```json
+{
+  "id": "2073746962003144705",
+  "orderId": "1934567890123456789",
+  "customerName": "寮犲厛鐢熶竴瀹�",
+  "headcountLabel": "2澶�1灏�",
+  "startDay": 6,
+  "endDay": 11,
+  "vehicleCategory": "suv",
+  "categoryLabel": "SUV",
+  "requiredSource": "order_product",
+  "assignmentStatus": "assigned",
+  "protocolPrice": "1300.00",
+  "productName": "鑽夊師娌欐紶绮惧崕6鏃�"
+}
+```
+
+## 3. 瀵硅处鍙ｅ緞
+
+瀵硅处鎺ュ彛鏈韩涓嶆柊澧炲瓧娈碉紝浣� `GET /admin/fleet/reconciliation/cars` 涓殑閲戦宸茬粡鎸� prep 蹇収鑱氬悎銆�
+
+鍙栦环浼樺厛绾э細
+
+1. `fleet_assignment.protocol_price`
+2. 鍘嗗彶绌哄揩鐓у洖閫� `fleet_pricing_calendar.day_price`
+3. 涓よ�呴兘娌℃湁鏃讹紝鐢熸垚 prep 鎶� `605607`
+
+鍓嶇娉ㄦ剰锛�
+
+- 灞曠ず鍘嗗彶娲惧崟鏃讹紝鐩存帴灞曠ず鎺ュ彛杩斿洖鐨� `protocolPrice`锛屼笉瑕佺敤褰撳墠浠锋牸鏃ュ巻瑕嗙洊銆�
+- `protocolPrice=null` 鏄悎娉曞巻鍙�/缂轰环鐘舵�侊紝涓嶄唬琛ㄦ帴鍙ｅけ璐ャ��
+- 璐熸暟鍗忚浠蜂細璧板弬鏁版牎楠屽け璐ワ紝鍓嶇杈撳叆妗嗗簲闄愬埗涓洪潪璐熼噾棰濄��