From 171be62be561cafc244fe1102c61f0398582663d Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Thu, 23 Jul 2026 16:23:50 +0800 Subject: [PATCH] docs(fleet): verify reassign context handoff (#5186) --- ...¦ä¸­è®¢å•æ¢å¤æ´¾è½¦æ´¾äººå…¥å£-修改接å£-管ç†åŽå°.md | 20 +++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/changelogs-v2/2026-07/23_5186_æŽ’è½¦ä¸­è®¢å•æ¢å¤æ´¾è½¦æ´¾äººå…¥å£-修改接å£-管ç†åŽå°.md b/changelogs-v2/2026-07/23_5186_æŽ’è½¦ä¸­è®¢å•æ¢å¤æ´¾è½¦æ´¾äººå…¥å£-修改接å£-管ç†åŽå°.md index 4ff7cc1..0cf4bbd 100644 --- a/changelogs-v2/2026-07/23_5186_æŽ’è½¦ä¸­è®¢å•æ¢å¤æ´¾è½¦æ´¾äººå…¥å£-修改接å£-管ç†åŽå°.md +++ b/changelogs-v2/2026-07/23_5186_æŽ’è½¦ä¸­è®¢å•æ¢å¤æ´¾è½¦æ´¾äººå…¥å£-修改接å£-管ç†åŽå°.md @@ -4,8 +4,8 @@ ticket: "5186" title: "æŽ’è½¦ä¸­è®¢å•æ¢å¤æ´¾è½¦æ´¾äººå…¥å£å¹¶è¡¥é½æ”¹æ´¾ä¸Šä¸‹æ–‡" consumer: "admin" backend: "verified" -gateway: "pending" -frontend: "pending" +gateway: "verified" +frontend: "not-required" base: "dev-v3" generated: "2026-07-23T16:10:00+08:00" --- @@ -23,14 +23,14 @@ generated: "2026-07-23T16:10:00+08:00" 排车状æ€ä¸º `holding` 或 `holding_urgent` 时,订å•å¹¶éžä¸å¯æ“作:åŽç«¯çŽ°åœ¨è¿”å›ž `canAssign=true`,并在 `availableActionCodes` ä¸­ä¸‹å‘ `CHANGE_ASSIGNMENT`,å…è®¸è½¦åŠ¡ç»§ç»­è¿›å…¥â€œæ´¾è½¦æ´¾äººâ€æµç¨‹è°ƒæ•´å¸æœºæˆ–车辆。 -2026-07-23 补充:改派候选查询需è¦ç”¨ `orderId + requirementId + fleetItemIndex` 精确定ä½å½“å‰è®¢å•的当å‰ç”¨è½¦éœ€æ±‚æ§½ä½ã€‚看æ¿åˆ—表ã€è¯¦æƒ…顶层和详情内æ¯ä¸ªæœ‰æ•ˆæ´¾è½¦ç»„现å‡ç¨³å®šè¿”回字符串形å¼çš„ `requirementId`,å‰ç«¯ç›´æŽ¥é€ä¼ ï¼Œä¸è‡ªè¡ŒæŽ¨å¯¼ã€‚ +2026-07-23 契约修订:改派候选查询需è¦ç”¨ `orderId + requirementId + fleetItemIndex` 精确定ä½å½“å‰è®¢å•的当å‰ç”¨è½¦éœ€æ±‚æ§½ä½ã€‚看æ¿åˆ—表ã€è¯¦æƒ…顶层和详情内æ¯ä¸ªæœ‰æ•ˆæ´¾è½¦ç»„现å‡ç¨³å®šè¿”回字符串形å¼çš„ `requirementId`,å‰ç«¯ç›´æŽ¥é€ä¼ ï¼Œä¸è‡ªè¡ŒæŽ¨å¯¼ã€‚ -## 一ã€å˜æ›´æŽ¥å£ +## å˜æ›´æŽ¥å£ | æŽ¥å£ | 方法 | 路径 | å˜æ›´ç±»åž‹ | |------|------|------|----------| -| æ´¾å•看æ¿åˆ—表 | GET | `/v3/admin/fleet/board/orders` | å“应字段å–å€¼æ‰©å±•ã€æ–°å¢žå­—段 | -| æ´¾å•看æ¿è¯¦æƒ… | GET | `/v3/admin/fleet/board/orders/{orderId}` | 新增字段 | +| æ´¾å•看æ¿åˆ—表 | GET | `/admin/fleet/board/orders` | å“应字段å–å€¼æ‰©å±•ã€æ–°å¢žå­—段 | +| æ´¾å•看æ¿è¯¦æƒ… | GET | `/admin/fleet/board/orders/:orderId` | 新增字段 | è¯·æ±‚å‚æ•°å’Œå†™æŽ¥å£è·¯å¾„凿œªæ”¹å˜ã€‚ @@ -84,11 +84,15 @@ generated: "2026-07-23T16:10:00+08:00" - [ ] `assigned`ã€`completed`ã€`canceled` ä¸è¯¯æ˜¾ç¤ºå…¥å£ã€‚ - [ ] 调整æˆåŠŸåŽåˆ·æ–°çœ‹æ¿ï¼Œé¡µé¢åªä¿ç•™ä¸€ç»„当剿œ‰æ•ˆæ´¾å•。 -## 五ã€åŽç«¯éªŒè¯ +## 验è¯è¯æ® -- 状æ€çŸ©é˜µã€ç”Ÿå‘½å‘¨æœŸåŠ¨ä½œã€æ”¹æ´¾ä¸Šä¸‹æ–‡åŠæŽ’è½¦ä¸­æ”¹æ´¾ä¿æŠ¤å·²æœ‰å®šå‘æµ‹è¯•覆盖。 +- åŽç«¯æäº¤ï¼š`aaeb01242`ï¼›PR:[wx/HL#5190](https://git.1814.love:8443/wx/HL/pulls/5190),已åˆå¹¶ `dev-v3`。 +- 状æ€çŸ©é˜µã€ç”Ÿå‘½å‘¨æœŸåŠ¨ä½œã€æ”¹æ´¾ä¸Šä¸‹æ–‡åŠæŽ’è½¦ä¸­æ”¹æ´¾ä¿æŠ¤å·²æœ‰å®šå‘æµ‹è¯•覆盖;`BoardOrderServiceTest` 与 `BoardControllerTest` å…± 49 项通过。 - `mvn -f hl-fleet-service/pom.xml spotless:check` 通过。 - `mvn -pl hl-fleet-service -am verify` 通过。 +- 测试环境 Fleet 滚动部署任务 `3458b3ab` æˆåŠŸï¼Œ8087ã€8187 两实例å¥åº·ã€‚ +- ç½‘å…³æŒ‰å›¢å· `26-7042` 验è¯ï¼šåˆ—表与详情 HTTP/code 200,`requirementId` 在列表ã€è¯¦æƒ…顶层ã€`currentAssignment` å’Œ `activeAssignments[]` å‡å­˜åœ¨ï¼›æºå¸¦ `orderId + requirementId + fleetItemIndex + excludeAssignmentId` è°ƒç”¨å€™é€‰æŽ¥å£ HTTP/code 200,返回 19 辆车ã€19 å叿œºå€™é€‰ã€‚ +- 当å‰å‰ç«¯ `v2.1` 已从 `order.requirementId` 组装候选请求,本次无需å‰ç«¯ä»£ç ä¿®æ”¹ï¼›åŽç«¯éƒ¨ç½²åŽç›´æŽ¥èŽ·å¾—è¯¥å­—æ®µã€‚ ## å…­ã€ç›¸å…³æ–‡æ¡£