From d8cb0d612832545a81e1154b8276b046d01b6d32 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Wed, 22 Jul 2026 11:07:42 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=205132=20=E8=AF=A6?= =?UTF-8?q?=E7=BB=86=E5=87=BA=E8=A1=8C=E4=BA=BA=E5=A5=91=E7=BA=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...§å“行程节点与出行人-修改接å£-å‰ç«¯å¾…处ç†-管ç†åŽå°.md | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/changelogs-v2/2026-07/79_车务派å•详情补全产å“行程节点与出行人-修改接å£-å‰ç«¯å¾…处ç†-管ç†åŽå°.md b/changelogs-v2/2026-07/79_车务派å•详情补全产å“行程节点与出行人-修改接å£-å‰ç«¯å¾…处ç†-管ç†åŽå°.md index 9411d3f..fee33f0 100644 --- a/changelogs-v2/2026-07/79_车务派å•详情补全产å“行程节点与出行人-修改接å£-å‰ç«¯å¾…处ç†-管ç†åŽå°.md +++ b/changelogs-v2/2026-07/79_车务派å•详情补全产å“行程节点与出行人-修改接å£-å‰ç«¯å¾…处ç†-管ç†åŽå°.md @@ -56,16 +56,23 @@ GET /admin/fleet/board/orders/{orderId} | `travelers` | Array | 出行人脱æ•基本信æ¯ï¼›æ— å‡ºè¡Œäººæˆ–下游é™çº§æ—¶è¿”回 `[]` | | `travelers[].travelerId` | String | 出行人雪花 IDï¼Œå¿…é¡»æŒ‰å­—ç¬¦ä¸²å¤„ç† | | `travelers[].travelerType` | String/null | `ADULT` / `CHILD` / `YOUNG_CHILD` / `BABY` | +| `travelers[].travelerTypeName` | String/null | 人员类型中文å,如“æˆäººâ€â€œå„¿ç«¥â€ | | `travelers[].nameMasked` | String/null | 脱æ•å§“å | | `travelers[].gender` | String/null | 性别字典值 | +| `travelers[].genderName` | String/null | 性别中文å | | `travelers[].ageAtDeparture` | Number/null | 按订å•å‡ºå‘æ—¥è®¡ç®—çš„å‘¨å² | | `travelers[].idType` | String/null | è¯ä»¶ç±»åž‹å­—典值 | +| `travelers[].idTypeName` | String/null | è¯ä»¶ç±»åž‹ä¸­æ–‡å | | `travelers[].idNoMasked` | String/null | 脱æ•è¯ä»¶å· | | `travelers[].phoneMasked` | String/null | è„±æ•æ‰‹æœºå· | | `travelers[].nationality` | String/null | å›½ç± | +| `travelers[].race` | String/null | æ°‘æ— | | `travelers[].emergencyContactMasked` | String/null | 脱æ•紧急è”系人姓å | | `travelers[].emergencyPhoneMasked` | String/null | 脱æ•紧急è”ç³»äººç”µè¯ | +| `travelers[].roomGroupNo` | Number/null | åŒä½åˆ†ç»„å· | +| `travelers[].transportPlanIds` | String[] | å…³è”大交通批次 IDï¼Œå¿…é¡»æŒ‰å­—ç¬¦ä¸²å¤„ç† | | `travelers[].profileStatus` | String/null | 资料状æ€ï¼š`PENDING` / `COMPLETED` | +| `travelers[].profileStatusName` | String/null | 资料状æ€ä¸­æ–‡å | `productName` 是已有字段,结构ä¸å˜ï¼›æœ¬æ¬¡é¡µé¢å¿…须消费,ä¸å†åªä¿å­˜åœ¨ `normalizeBoardOrder().product` 而ä¸å±•示。 @@ -127,16 +134,23 @@ GET /admin/fleet/board/orders/{orderId} { "travelerId": "3001", "travelerType": "ADULT", + "travelerTypeName": "æˆäºº", "nameMasked": "å­”**", "gender": "2", + "genderName": "女", "ageAtDeparture": 35, "idType": "ID_CARD", + "idTypeName": "身份è¯", "idNoMasked": "150***********1234", "phoneMasked": "138****1234", "nationality": "中国", + "race": "è’™å¤æ—", "emergencyContactMasked": "王*", "emergencyPhoneMasked": "139****5678", - "profileStatus": "COMPLETED" + "roomGroupNo": 1, + "transportPlanIds": ["4001"], + "profileStatus": "COMPLETED", + "profileStatusName": "已完善" } ], "transport": { @@ -179,7 +193,7 @@ GET /admin/fleet/board/orders/{orderId} - 主文案显示 `nodeName`。 - `durationMinutes` 有值时显示易读时长。 - `description` 有值且与日简介ä¸é‡å¤æ—¶æ˜¾ç¤ºèŠ‚ç‚¹ç®€ä»‹ã€‚ -4. å³ä¾§æ–°å¢žâ€œå‡ºè¡Œäººä¿¡æ¯â€åŒºï¼Œé»˜è®¤å±•示脱æ•å§“åã€äººå‘˜ç±»åž‹ã€æ€§åˆ«ã€å‡ºå‘时年龄ã€è„±æ•手机å·å’Œèµ„料状æ€ï¼›è¯ä»¶/紧急è”系人å¯åœ¨è¡Œå†…展开或次è¦ä¿¡æ¯åŒºå±•示。 +4. å³ä¾§æ–°å¢žâ€œå‡ºè¡Œäººä¿¡æ¯â€åŒºï¼Œé»˜è®¤å±•示脱æ•å§“åã€äººå‘˜ç±»åž‹ã€æ€§åˆ«ã€å‡ºå‘时年龄ã€å›½ç±/æ°‘æ—ã€è„±æ•手机å·å’Œèµ„料状æ€ï¼›è¯ä»¶ã€åŒä½åˆ†ç»„ã€å…³è”大交通批次åŠç´§æ€¥è”系人å¯åœ¨è¡Œå†…展开或次è¦ä¿¡æ¯åŒºå±•示。 5. ç¦æ­¢ä¸ºäº†å±•示此页é¢è°ƒç”¨æ˜Žæ–‡æŽ¥å£ `POST /admin/fleet/board/orders/{orderId}/travelers/plain`。Step1 åªä½¿ç”¨è¯¦æƒ…å“åº”ä¸­çš„è„±æ• `travelers[]`。 6. ç©ºæ€æ˜Žç¡®ï¼šæ— èŠ‚ç‚¹æ˜¾ç¤ºâ€œæš‚æ— è¡Œç¨‹èŠ‚ç‚¹â€ï¼Œæ— å‡ºè¡Œäººæ˜¾ç¤ºâ€œæš‚未填写出行人信æ¯â€ï¼›ä¸å¾—ç”Ÿæˆæ¨¡æ‹ŸèŠ‚ç‚¹æˆ–æ¨¡æ‹Ÿå‡ºè¡Œäººã€‚ 7. 雪花 ID ç¦æ­¢ `Number()` / `parseInt()`,统一按字符串处ç†ã€‚ @@ -206,6 +220,7 @@ GET /admin/fleet/board/orders/{orderId} - [ ] æ¯æ—¥å®‰æŽ’按节点顺åºå±•示时间ã€èŠ‚ç‚¹åã€æ—¶é•¿å’Œç®€ä»‹ã€‚ - [ ] 节点无 `startTime` æ—¶å¯å›žé€€æ˜¾ç¤º `timePeriod`,ä¸ä¼šå‡ºçް `undefined`。 - [ ] å³ä¾§å¯çœ‹åˆ°å…¨éƒ¨å‡ºè¡Œäººçš„脱æ•基本信æ¯ã€‚ +- [ ] æ¯ä½å‡ºè¡Œäººæ˜Žç¡®å±•ç¤ºæŒ‰å‡ºå‘æ—¥è®¡ç®—çš„å¹´é¾„ï¼Œå¹¶å¯æŸ¥çœ‹äººå‘˜ç±»åž‹ã€æ€§åˆ«ã€è¯ä»¶ã€å›½ç±/æ°‘æ—ã€åŒä½åˆ†ç»„ã€å…³è”大交通åŠèµ„料状æ€ã€‚ - [ ] 无节点/无出行人时展示真实空æ€ï¼Œä¸ç”Ÿæˆæ¨¡æ‹Ÿæ•°æ®ã€‚ - [ ] é¡µé¢ Network åªéœ€çŽ°æœ‰è¯¦æƒ…è¯·æ±‚ï¼Œä¸è°ƒç”¨å‡ºè¡Œäººæ˜Žæ–‡æŽ¥å£ã€‚ - [ ] 现有留言ã€ç‰¹æ®Šè¦æ±‚ã€æ­¥éª¤æ¡å’Œæ“作记录ä¸å—å½±å“。