From a22e9c1ae36f5682360979d6fd08ea33329736c3 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Wed, 24 Jun 2026 18:15:31 +0800 Subject: [PATCH] =?UTF-8?q?=E9=85=8D=E6=88=BF=E9=80=89=E9=85=92=E5=BA=97?= =?UTF-8?q?=E9=BB=98=E8=AE=A4=E4=B8=8D=E6=8C=89=E5=9F=8E=E5=B8=82=EF=BC=88?= =?UTF-8?q?=E5=90=8E=E7=AB=AF=20order+resource=20=E6=94=B9,=E8=B7=A8?= =?UTF-8?q?=E5=9F=8E=E5=88=97=E5=85=A8=E9=83=A8=EF=BC=89+=E6=9B=B4?= =?UTF-8?q?=E6=AD=A3=E5=89=8D=E7=AF=87=E3=80=8C=E8=BF=94=E5=85=A8=E9=9B=86?= =?UTF-8?q?=E3=80=8D=E5=AE=9A=E6=80=A7=EF=BC=88#4363/#4364=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...æˆ¿é€‰é…’åº—é»˜è®¤ä¸æŒ‰åŸŽå¸‚列全部跨城_管ç†åŽå°.md | 30 +++++++++++++++++++ ...’店候选列表åŽç«¯è¿”全集å‰ç«¯éœ€å…¨é‡æ¸²æŸ“_管ç†åŽå°.md | 29 ------------------ 2 files changed, 30 insertions(+), 29 deletions(-) create mode 100644 changelogs-v2/2026-06/24_4363_é…æˆ¿é€‰é…’åº—é»˜è®¤ä¸æŒ‰åŸŽå¸‚列全部跨城_管ç†åŽå°.md delete mode 100644 changelogs-v2/2026-06/24_é…æˆ¿é€‰æ‹©é…’店候选列表åŽç«¯è¿”全集å‰ç«¯éœ€å…¨é‡æ¸²æŸ“_管ç†åŽå°.md diff --git a/changelogs-v2/2026-06/24_4363_é…æˆ¿é€‰é…’åº—é»˜è®¤ä¸æŒ‰åŸŽå¸‚列全部跨城_管ç†åŽå°.md b/changelogs-v2/2026-06/24_4363_é…æˆ¿é€‰é…’åº—é»˜è®¤ä¸æŒ‰åŸŽå¸‚列全部跨城_管ç†åŽå°.md new file mode 100644 index 0000000..fdc996f --- /dev/null +++ b/changelogs-v2/2026-06/24_4363_é…æˆ¿é€‰é…’åº—é»˜è®¤ä¸æŒ‰åŸŽå¸‚列全部跨城_管ç†åŽå°.md @@ -0,0 +1,30 @@ +# é…æˆ¿é€‰é…’åº—é»˜è®¤ä¸æŒ‰åŸŽå¸‚(列全部在售·跨城,池内/定制师优先;æœç´¢æ¡†å¯ç­›ï¼›å·²ä¸Šçº¿æµ‹è¯•æœÂ·å¯å¯¹æŽ¥ï¼‰ + +> å˜æ›´ç±»åž‹ï¼šâœ¨ è¡Œä¸ºå˜æ›´ï¼ˆåŽç«¯ order + resource 一并改,已部署测试æœå¹¶ API 实测) +> 端类型:管ç†åŽå°ï¼ˆé…房·「选择酒店ã€å¼¹çª—) +> 日期:2026-06-24 | å·¥å•:#4363 | PR:#4364 | æœåŠ¡ï¼šhl-order-service-v3 + hl-resource-service +> å…³è”:承接 #4346(本å•åšå…¨ï¼‰ã€‚**更正本目录早å‰ã€Œé…房选择酒店候选列表åŽç«¯è¿”全集ã€é‚£ç¯‡**——彼时åŽç«¯å®žä¸ºæŒ‰è¡Œç¨‹åŸŽå¸‚过滤(éžçº¯å‰ç«¯ bug,我先å‰å®šæ€§æœ‰è¯¯,致歉),çŽ°å·²æ”¹ä¸ºé»˜è®¤ä¸æŒ‰åŸŽå¸‚。 + +--- + +## âš ï¸ å…³é”®è¯´æ˜Ž +- **è¡Œä¸ºå˜æ›´**ï¼šé…æˆ¿ã€Œé€‰æ‹©é…’店ã€`GET /v3/admin/hotel-candidates` **默认ä¸å†æŒ‰è¡Œç¨‹åŸŽå¸‚过滤**,改为**列全部在售酒店**(带标签的池内 / 定制师推èç”±åŽç«¯æŽ’最å‰ï¼‰ã€‚ +- 用户在æœç´¢æ¡†è¾“入城市 / å…³é”®è¯æ—¶æ‰æŒ‰åŸŽå¸‚ / 关键è¯ç­›ï¼ˆ`city` / `keyword` å…¥å‚,行为ä¸å˜ï¼‰ã€‚ +- 接å£**æ—  total / 分页字段**,`candidates` æ˜¯å®Œæ•´æ•°ç»„ï¼ˆé»˜è®¤ä¸Šé™ 30,排åºåŽæˆªæ–­ï¼‰ã€‚**å‰ç«¯å…¨é‡é¡ºåºæ¸²æŸ“ candidates,勿按标签过滤**。 + +## 1. å…¥å‚ / 出å‚(契约ä¸å˜,仅默认行为å˜ï¼‰ +`GET /v3/admin/hotel-candidates`: +- `orderId`(必传)/ `dayNumber`(推算 stayDate,**ä¸å†ç”¨äºŽæŽ¨ç®—城市**)/ `city`(选填,æœç´¢æ¡†æŒ‡å®šæ‰æŒ‰åŸŽå¸‚筛)/ `keyword`(选填,跨城 / çœå…³é”®è¯æœï¼‰/ `limit`(默认 **30**,ä¸Šé™ 50)。 +- å‡ºå‚ `data.candidates[]` 字段åŒå‰ï¼ˆhotelName / protoPrice / isPoolMatch / isConsultantRecommended / tags / ...);排åºï¼šå®šåˆ¶å¸ˆç‚¹å > 池内 > 普通。 + +## 2. 测试æœå®žæµ‹ï¼ˆorder 2069593503129636865 第 1 晚) +| 调用 | data.city | 候选城市 | æ¡æ•° | +|---|---|---|---| +| 默认(ä¸ä¼  city) | null | **兴安盟 + 呼伦è´å°”市(跨城)** | 10(全部在售,池内海拉尔海棠排第 1) | +| ä¼  `city=海拉尔` | 海拉尔 | 呼伦è´å°”市 | 1(按城市筛) | + +改å‰åŒä¸€è°ƒç”¨åªè¿”呼伦è´å°”市 10 æ¡ï¼ˆé”行程城市);改åŽè·¨åŸŽè¿”全部在售(å«å…´å®‰ç›Ÿé˜¿å°”å±±æˆæ‚¦é…’店)。 + +## 3. å‰ç«¯åŠ¨ä½œ +- **å…¨é‡é¡ºåºæ¸²æŸ“ `candidates`**(åŽç«¯å·²æŽ’好åº,带标签的在最å‰ï¼‰,弹窗「共 N æ¡ã€= candidates.length,勿按标签过滤。 +- æœç´¢æ¡†ï¼šè¾“入城市 → ä¼  `city`;跨城 / å…³é”®è¯ â†’ ä¼  `keyword`。 diff --git a/changelogs-v2/2026-06/24_é…æˆ¿é€‰æ‹©é…’店候选列表åŽç«¯è¿”全集å‰ç«¯éœ€å…¨é‡æ¸²æŸ“_管ç†åŽå°.md b/changelogs-v2/2026-06/24_é…æˆ¿é€‰æ‹©é…’店候选列表åŽç«¯è¿”全集å‰ç«¯éœ€å…¨é‡æ¸²æŸ“_管ç†åŽå°.md deleted file mode 100644 index 9ed80ae..0000000 --- a/changelogs-v2/2026-06/24_é…æˆ¿é€‰æ‹©é…’店候选列表åŽç«¯è¿”全集å‰ç«¯éœ€å…¨é‡æ¸²æŸ“_管ç†åŽå°.md +++ /dev/null @@ -1,29 +0,0 @@ -# é…æˆ¿ã€Œé€‰æ‹©é…’店ã€å€™é€‰åˆ—表:åŽç«¯è¿”回全集 + 已排åºï¼Œå‰ç«¯éœ€å…¨é‡æ¸²æŸ“(接å£è¯´æ˜ŽÂ·åŽç«¯æ— æ”¹åŠ¨ï¼‰ - -> å˜æ›´ç±»åž‹ï¼šðŸ“– 接å£ä½¿ç”¨è¯´æ˜Žï¼ˆåŽç«¯æ— æ”¹åŠ¨ï¼›æ¾„æ¸…å‰ç«¯æ¸²æŸ“缺陷) -> 端类型:管ç†åŽå°ï¼ˆé…房·「选择酒店ã€å¼¹çª—) -> 日期:2026-06-24 | æœåŠ¡ï¼šhl-order-service-v3 | 接å£ï¼š`GET /v3/admin/hotel-candidates` - ---- - -## âš ï¸ å…³é”®è¯´æ˜Žï¼ˆå®šä½ä¸ºå‰ç«¯æ¸²æŸ“ bug) -- **现象**ï¼šé…æˆ¿ã€Œé€‰æ‹©é…’店ã€å¼¹çª—显示「共 N æ¡ã€,列表å´åªæ¸²æŸ“ 1 行(åªå‰©æ± å†…/带标签那家),城市内其余酒店没显示。 -- **定ä½**:**åŽç«¯æ— é—®é¢˜**。`GET /v3/admin/hotel-candidates` 实测返回**城市内全部酒店**(测试æœè®¢å• 2069593503129636865 第 1 晚返 **10 æ¡**),且**已按「定制师点å > äº§å“æ± å†… > æ™®é€šã€æŽ’å¥½åº**(池内的海拉尔海棠排第 1)。 -- **根因**ï¼šè¯¥æŽ¥å£ RespVO **没有 total / 分页字段**,åªæœ‰ `candidates` 完整数组。å‰ç«¯ã€Œå…± N æ¡ã€= `candidates.length`,å³å‰ç«¯**已收到全部 N æ¡**,å´åªæ¸²æŸ“了 1 行(疑似误按 `isPoolMatch / isConsultantRecommended = true` 过滤,æŠŠæ™®é€šé…’åº—æ¼æŽ‰ï¼‰ã€‚ -- **å‰ç«¯åŠ¨ä½œ**:**å…¨é‡é¡ºåºæ¸²æŸ“ `candidates` 数组,ä¸è¦æŒ‰æ ‡ç­¾è¿‡æ»¤**。åŽç«¯å·²æŽ’好åº,带标签的天然在最å‰,普通酒店在åŽã€‚ - -## 1. 接å£å‡ºå‚ï¼ˆå…³é”®å­—æ®µï¼Œæœ¬æ¬¡æ— å˜æ›´ï¼‰ -`GET /v3/admin/hotel-candidates` → `data.candidates[]`(完整数组,无分页,é»˜è®¤ä¸Šé™ limit=10,å¯ä¼  limit 上调,≤50): - -| 字段 | 类型 | 说明 | -|---|---|---| -| `hotelName` | String | 酒店å | -| `protoPrice` | String(BigDecimal) | å议价 | -| `matchedRoomTypeLabel` / `matchedRoomTypeAvailable` | String / Integer | åŒ¹é…æˆ¿åž‹ / å¯ç”¨æˆ¿ | -| `isPoolMatch` | Boolean | 是å¦äº§å“池内(å‰ç«¯æ ‡ç­¾ã€Œäº§å“池内ã€ï¼‰ | -| `isConsultantRecommended` | Boolean | 是å¦å®šåˆ¶å¸ˆç‚¹å(å‰ç«¯æ ‡ç­¾ã€Œå®šåˆ¶å¸ˆæŽ¨èã€ï¼‰ | -| `tags` | List<String> | è¿è¥æ ‡ç­¾ï¼ˆè‰åŽŸæ™¯è§‚ / 嫿—©é¤ / 性价比高 等) | -| `recommendSource` / `score` | String / Double | æŽ¨èæ¥æº / 排åºåˆ†ï¼ˆåŽç«¯å·²æ®æ­¤æŽ’åº,å‰ç«¯å‹¿é‡æŽ’,æŒ‰è¿”å›žé¡ºåºæ¸²æŸ“å³å¯ï¼‰ | - -## 2. 测试æœå®žæµ‹ï¼ˆorder 2069593503129636865 第 1 晚) -返回 **10 æ¡**:海拉尔海棠(`isPoolMatch=true`,第 1)+ 呼伦è´å°”香格里拉 / 海拉尔嘉世豪 / æ©å’Œç“¦è¥¿é‡Œæ°‘宿 / é¢å°”å¤çº³ç™½æ¡¦ / 满洲里凯旋 / é¢å°”å¤çº³è±ªæ˜Ÿ / 海拉尔首旅京伦 / é¢å°”å¤çº³çŽ–æˆä¸‡è±ª / 黑山头弘å‰å‰Œéƒ¨ ç­‰ 9 家城市内酒店。**å‰ç«¯åº”渲染全部 10 行**,当å‰åªæ˜¾ç¤º 1 行å³ç¼ºé™·æ‰€åœ¨ã€‚