From 2b069a2d374370e45945a195751b5c7857a4366b Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sun, 9 Aug 2026 10:32:53 +0800 Subject: [PATCH] =?UTF-8?q?docs(fleet):=20=E6=94=B9=E6=B4=BE=E5=9B=9E?= =?UTF-8?q?=E6=98=BE=E7=BC=BA=E9=99=B7=E8=A1=A5=E5=85=85=E6=8E=A5=E5=8F=A3?= =?UTF-8?q?=E5=9C=B0=E5=9D=80/=E5=8F=82=E6=95=B0/=E5=93=8D=E5=BA=94?= =?UTF-8?q?=E8=AF=A6=E6=83=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...¾é€‰å®Œè½¦å¸æœºæ§½ä½åˆ—ä¸å›žæ˜¾-å‰ç«¯ç¼ºé™·-管ç†åŽå°.md | 87 +++++++++++++++---- 1 file changed, 71 insertions(+), 16 deletions(-) diff --git a/changelogs-v2/2026-08/08_frontend_æ”¹æ´¾é€‰å®Œè½¦å¸æœºæ§½ä½åˆ—ä¸å›žæ˜¾-å‰ç«¯ç¼ºé™·-管ç†åŽå°.md b/changelogs-v2/2026-08/08_frontend_æ”¹æ´¾é€‰å®Œè½¦å¸æœºæ§½ä½åˆ—ä¸å›žæ˜¾-å‰ç«¯ç¼ºé™·-管ç†åŽå°.md index c8e1b26..0234b83 100644 --- a/changelogs-v2/2026-08/08_frontend_æ”¹æ´¾é€‰å®Œè½¦å¸æœºæ§½ä½åˆ—ä¸å›žæ˜¾-å‰ç«¯ç¼ºé™·-管ç†åŽå°.md +++ b/changelogs-v2/2026-08/08_frontend_æ”¹æ´¾é€‰å®Œè½¦å¸æœºæ§½ä½åˆ—ä¸å›žæ˜¾-å‰ç«¯ç¼ºé™·-管ç†åŽå°.md @@ -1,7 +1,7 @@ --- schema: "hl-changelog/v2" ticket: "frontend-fleet-reassign-display" -title: "改派选完车辆/叿œºåŽï¼Œæ§½ä½ã€Œå½“å‰è½¦è¾†/当å‰å¸æœºã€åˆ—ä¸å›žæ˜¾æ–°é€‰æ‹©ï¼ˆä»æ˜¾ç¤ºã€Œå¾…釿–°é€‰æ‹©ã€ï¼‰" +title: "改派选完车辆/叿œºåŽï¼Œæ§½ä½ã€Œå½“å‰è½¦è¾†/当å‰å¸æœºã€åˆ—与按天改派表格ä¸å›žæ˜¾æ–°é€‰æ‹©" consumer: "admin" author: "wx(GIT)" change_type: "å‰ç«¯ç¼ºé™·" @@ -12,38 +12,93 @@ frontend_owner: "mmg" frontend_ref: "" target_release: "" verified_at: "" -status_note: "å‰ç«¯ç¼ºé™·ï¼šæ”¹æ´¾æµç¨‹é€‰å®Œè½¦è¾†/叿œºï¼ˆç‚¹ã€Œå®Œæˆé€‰æ‹©ã€ï¼‰åŽï¼Œæ§½ä½è¡¨æ ¼é¡¶éƒ¨ã€Œå½“å‰è½¦è¾†/当å‰å¸æœºã€åˆ—ä¸å›žæ˜¾æ–°é€‰æ‹©ï¼Œä»æ˜¾ç¤ºã€Œå¾…釿–°é€‰æ‹©ã€ï¼›å®žé™…选择已写入底部改派è‰ç¨¿ï¼ˆå¯æ­£å¸¸æäº¤ï¼‰ã€‚用户误以为没选上。待å‰ç«¯ä¿®å¤å›žæ˜¾ã€‚" +status_note: "å‰ç«¯ç¼ºé™·ï¼šæ”¹æ´¾é€‰å®Œè½¦è¾†/叿œºï¼ˆå®Œæˆé€‰æ‹©ï¼‰åŽï¼Œæ§½ä½é¡¶éƒ¨åˆ—与按天改派表格å‡ä¸å›žæ˜¾æ–°é€‰æ‹©ã€‚选择已在å‰ç«¯è‰ç¨¿ï¼ˆåº•部å¯è§ï¼‰ä¸”坿­£å¸¸æäº¤ç”Ÿæ•ˆï¼Œçº¯å‰ç«¯å›žæ˜¾æœªåˆ·æ–°ã€‚å¾…å‰ç«¯ä¿®å¤ã€‚" updated_at: "2026-08-08" base: "dev-v3" -generated: "2026-08-08T22:40:00+08:00" +generated: "2026-08-08T22:50:00+08:00" --- -# 改派选完车辆/叿œºåŽï¼Œæ§½ä½ã€Œå½“å‰è½¦è¾†/当å‰å¸æœºã€åˆ—ä¸å›žæ˜¾æ–°é€‰æ‹© +# 改派选完车辆/叿œºåŽï¼Œæ§½ä½åˆ—与按天改派表格ä¸å›žæ˜¾æ–°é€‰æ‹© > å‰ç«¯ç¼ºé™·ï¼Œå¾…å‰ç«¯ä¿®å¤ã€‚åŽç«¯æ— é—®é¢˜ï¼ˆæ”¹æ´¾å¯æ­£å¸¸æäº¤ç”Ÿæ•ˆï¼‰ã€‚ ## 现象(TEST å®žæµ‹ï¼Œè®¢å• 26-6436 周梦æ´ï¼‰ -1. 改派æµç¨‹ï¼šæ”¹æ´¾ → 选择改派 → 清除车辆/叿œº → 选择车辆/叿œº → 弹窗选好新车(蒙A-T7777)+æ–°å¸æœºï¼ˆå®éŸ³å¾·åŠ›æ ¼å°”ï¼‰â†’ 点「完æˆé€‰æ‹©ã€ã€‚ -2. 回到排车页,**æ§½ä½è¡¨æ ¼é¡¶éƒ¨ã€Œå½“å‰è½¦è¾†ã€ã€Œå½“å‰å¸æœºã€åˆ—仿˜¾ç¤ºã€Œå¾…釿–°é€‰æ‹©ã€**——看ä¸åˆ°åˆšé€‰çš„车/叿œºã€‚ -3. 但页é¢**底部改派è‰ç¨¿å·²æ­£ç¡®æ˜¾ç¤º**「蒙A-T7777(丰田普拉多)· å®éŸ³å¾·åŠ›æ ¼å°” 135****5009ã€â€”—选择已记录。 -4. æŒ‰å¤©æ”¹æ´¾è¡¨æ ¼ä»æ˜¾ç¤ºåŽŸæ´¾å•(蒙A-E2E01 é“å°”å‰ å·²æ´¾è½¦ï¼‰ã€‚ +改派æµç¨‹æ“作:改派 → 下一步 → 选择改派 → 清除车辆/叿œº → 选择车辆/叿œº → 弹窗选**è’™A-T7777 + å®éŸ³å¾·åŠ›æ ¼å°”** → 点「完æˆé€‰æ‹©ã€ã€‚ -**问题**ï¼šé€‰å®ŒåŽæ§½ä½é¡¶éƒ¨åˆ—ä¸å›žæ˜¾ï¼Œç”¨æˆ·ä»¥ä¸ºæ²¡é€‰ä¸Š/æ“作没生效,易困惑误æ“作。 +回到排车页åŽï¼š +- **æ§½ä½è¡¨æ ¼é¡¶éƒ¨**:「当å‰è½¦è¾†ã€ã€Œå½“å‰å¸æœºã€åˆ—仿˜¾ç¤ºã€Œ**待釿–°é€‰æ‹©**ã€ï¼ˆæœªå›žæ˜¾æ–°é€‰ï¼‰ã€‚ +- **按天改派表格**(3 个æœåŠ¡æ—¥ 8/23~8/25):「当å‰è½¦è¾†ã€ã€Œå½“å‰å¸æœºã€åˆ—仿˜¾ç¤ºæ—§æ´¾å•「**è’™A-E2E01 é“å°”å‰**ã€ï¼ˆæœªå›žæ˜¾æ–°é€‰ï¼‰ã€‚ +- **底部改派è‰ç¨¿**正确显示「蒙A-T7777(丰田普拉多)· å®éŸ³å¾·åŠ›æ ¼å°” 135\*\*\*\*5009ã€â€”—选择已被å‰ç«¯è®°å½•ï¼Œåªæ˜¯ä¸Šé¢ä¸¤å¤„列没刷新。 + +用户以为没选上,易困惑/é‡å¤æ“作。 + +## æ¶‰åŠæŽ¥å£ + +### 1. æ´¾å•è¯¦æƒ…ï¼ˆå›žæ˜¾æ•°æ®æºï¼‰ + +``` +GET https://api.test.1814.love:9443/admin/fleet/board/orders/{orderId} +``` + +è·¯å¾„å‚æ•°ï¼š`orderId`(如 2086270156475936769ï¼Œå›¢å· 26-6436) + +å“应(节选,data 节点)——**这是改派å‰çš„当剿´¾å•事实**: +```json +{ + "currentAssignment": { + "id": "2086276434870853634", + "vehiclePlate": "è’™A-E2E01", + "driverName": "é“å°”å‰", + "assignmentStatus": "assigned" + }, + "vehicleSlots": [{ + "fleetItemIndex": 0, + "vehiclePlate": "è’™A-E2E01", + "driverName": "é“å°”å‰", + "slotStatus": "assigned", + "vehicleId": "2085284111341023234", + "driverId": "2065272150012444674" + }] +} +``` + +**说明**:改派「完æˆé€‰æ‹©ã€åŽï¼Œæ–°é€‰æ‹©åªåœ¨å‰ç«¯**è‰ç¨¿æ€**(尚未æäº¤ change),此时槽ä½åˆ—/按天表格若ä»è¯» `currentAssignment`/`vehicleSlots`ï¼ˆå³æ—§ assigned æ´¾å•),就永远显示旧值。å‰ç«¯åº”在选完åŽç”¨**è‰ç¨¿çš„æ–° vehicleId/driverId(车辆车牌/叿œºå§“å)**è¦†ç›–å›žæ˜¾è¿™ä¸¤å¤„åˆ—ï¼Œè€Œä¸æ˜¯ç»§ç»­å±•示 assigned 事实。 + +### 2. 改派æäº¤ï¼ˆé€‰æ‹©çœŸæ­£ç”Ÿæ•ˆï¼‰ + +``` +POST https://api.test.1814.love:9443/admin/fleet/assignments/{assignmentId}/change +``` + +è·¯å¾„å‚æ•°ï¼š`assignmentId`ï¼ˆå½“å‰æ´¾å• id,如 2086276434870853634) + +请求体(示例): +```json +{ + "newVehicleId": "è’™A-T7777对应vehicleId", + "newDriverId": "å®éŸ³å¾·åŠ›æ ¼å°”å¯¹åº”driverId", + "effectiveDate": "2026-08-23", + "holdMode": 1, + "reason": "改派", + "requestId": "front-change-" +} +``` + +å“应:`code=200` æˆåŠŸï¼Œæ—§è¡Œå–æ¶ˆã€æ–°è¡Œç”Ÿæ•ˆã€‚**此接å£å®žæµ‹æ­£å¸¸**(改派æäº¤åŽè½¦è¾†/叿œºæ­£ç¡®å˜æ›´ï¼‰â€”—所以是纯å‰ç«¯å›žæ˜¾é—®é¢˜ã€‚ ## 期望 -改派选完车辆/叿œºï¼ˆå®Œæˆé€‰æ‹©ï¼‰åŽï¼Œæ§½ä½è¡¨æ ¼çš„「当å‰è½¦è¾†ã€ã€Œå½“å‰å¸æœºã€åˆ—应立å³å›žæ˜¾æ–°é€‰çš„车辆+叿œºï¼ˆä¸Žåº•部è‰ç¨¿ä¸€è‡´ï¼‰ï¼Œè®©ç”¨æˆ·æ˜Žç¡®çœ‹åˆ°æ”¹æ´¾ç»“果。 +改派「完æˆé€‰æ‹©ã€åŽï¼ˆè‰ç¨¿æ€ã€æœªæäº¤å‰ï¼‰ï¼Œä»¥ä¸‹ä¸¤å¤„ç«‹å³å›žæ˜¾æ–°é€‰çš„车辆+叿œºï¼ˆä¸Žåº•部è‰ç¨¿ä¸€è‡´ï¼‰ï¼š +1. æ§½ä½è¡¨æ ¼é¡¶éƒ¨ã€Œå½“å‰è½¦è¾†ã€ã€Œå½“å‰å¸æœºã€åˆ—ï¼› +2. 按天改派表格æ¯ä¸ªæœåŠ¡æ—¥çš„ã€Œå½“å‰è½¦è¾†ã€ã€Œå½“å‰å¸æœºã€åˆ—。 -## 对比 - -- åˆæ¬¡æ´¾å•ï¼šé€‰å®Œåº”ç”¨åŽæ§½ä½åˆ—正常显示车/叿œº ✅ -- æ”¹æ´¾ï¼šé€‰å®ŒåŽæ§½ä½åˆ—ä¸å›žæ˜¾ï¼ˆä»ã€Œå¾…釿–°é€‰æ‹©ã€ï¼‰âŒ +å³ï¼šé€‰å®ŒåŽå‰ç«¯ç”¨è‰ç¨¿çš„ `newVehicleId/newDriverId`(解æžå‡ºè½¦ç‰Œ/叿œºå)覆盖这两处的展示,让用户明确看到改派结果。 ## å¤çŽ°è·¯å¾„ -æ´¾å•çœ‹æ¿ â†’ å·²æ´¾è½¦è®¢å• â†’ 改派 → 下一步 → 选择改派 → 清除车辆/叿œº → 选择车辆/叿œº → 弹窗选车+选叿œº → 完æˆé€‰æ‹© → 看槽ä½é¡¶éƒ¨ã€Œå½“å‰è½¦è¾†/当å‰å¸æœºã€åˆ—。 +æ´¾å•çœ‹æ¿ â†’ 已派车订å•(如 26-6436)→ 改派 → 下一步 → 选择改派 → 清除车辆/叿œº → 选择车辆/叿œº → 弹窗选车+选叿œº → 完æˆé€‰æ‹© → 观察槽ä½é¡¶éƒ¨åˆ—与按天改派表格的「当å‰è½¦è¾†/当å‰å¸æœºã€åˆ—。 ## 备注 -- åŽç«¯æ”¹æ´¾æäº¤ï¼ˆPOST /{id}/change)正常,选择已正确传入并生效——纯å‰ç«¯å›žæ˜¾é—®é¢˜ã€‚ +- åˆæ¬¡æ´¾å•(AssignModalï¼‰é€‰å®Œåº”ç”¨åŽæ§½ä½åˆ—正常回显 ✅;问题仅在**æ”¹æ´¾ï¼ˆé‡æ–°æ´¾å•)æµç¨‹**的「完æˆé€‰æ‹©ã€å›žæ˜¾çŽ¯èŠ‚ã€‚