From a28a67887f4ac441a8d51ec2b39262ee4fdb6805 Mon Sep 17 00:00:00 2001 From: lc Date: Fri, 11 Sep 2026 18:00:02 +0800 Subject: [PATCH] =?UTF-8?q?docs(7509):=20=E9=85=92=E5=BA=97=E6=8C=89?= =?UTF-8?q?=E6=99=AF=E5=8C=BA=E5=8F=A3=E5=BE=84=E6=8E=A5=E5=85=A5=E4=BE=9B?= =?UTF-8?q?=E5=BA=94=E5=95=86=E5=85=B3=E7=B3=BB=20Changelog=EF=BC=88suppli?= =?UTF-8?q?erFullName=20/=20=E5=8E=9F=E5=9B=A0=E5=8F=AF=E7=9C=81=E7=95=A5?= =?UTF-8?q?=20/=20395062=EF=BC=89Refs=20#7509?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01UqNs52DGnGU29PN8Ey37Ms --- ...Œ‰æ™¯åŒºå£å¾„接入供应商关系-修改接å£-管ç†åŽå°.md | 486 ++++++++++++++++++ 1 file changed, 486 insertions(+) create mode 100644 changelogs-v2/2026-09/11_7509_酒店按景区å£å¾„接入供应商关系-修改接å£-管ç†åŽå°.md diff --git a/changelogs-v2/2026-09/11_7509_酒店按景区å£å¾„接入供应商关系-修改接å£-管ç†åŽå°.md b/changelogs-v2/2026-09/11_7509_酒店按景区å£å¾„接入供应商关系-修改接å£-管ç†åŽå°.md new file mode 100644 index 00000000..f59dfde6 --- /dev/null +++ b/changelogs-v2/2026-09/11_7509_酒店按景区å£å¾„接入供应商关系-修改接å£-管ç†åŽå°.md @@ -0,0 +1,486 @@ +--- +schema: "hl-changelog/v2" +ticket: "7509" +title: "酒店按景区å£å¾„接入供应商关系" +consumer: "admin" +author: "lc(GIT)" +change_type: "修改接å£" +backend_status: "deployed" +gateway_status: "verified" +frontend_status: "pending" +frontend_owner: "" +frontend_ref: "" +target_release: "" +verified_at: "2026-09-11" +status_note: "åŽç«¯å·²éƒ¨ç½²å¹¶ç» Gateway 验è¯ï¼›å¾…å‰ç«¯å±•ç¤ºé…’店列表供应商全称并接入酒店供应商关系æ“作。" +updated_at: "2026-09-11" +base: "dev-v3" +--- + +# 酒店管ç†ï¼šæŒ‰æ™¯åŒºå£å¾„接入供应商关系 + +> **æœåŠ¡**: hl-resource-service（8082） +> **PR**: #7552 +> **Issue**: #7509 +> **日期**: 2026-09-11 +> **å½±å“范围**: 管ç†ç«¯é…’店列表ã€é…’店供应商查询/设置/改绑/解绑 + +## âš ï¸ å…³é”®å˜åŒ– + +- 酒店列表æ¯æ¡è®°å½•å›ºå®šè¿”回 `supplierFullName`；无当å‰ä¾›åº”商时为 `null`。 +- 酒店使用通用资æºä¾›åº”商关系接å£ï¼Œè·¯å¾„å‚数固定传 `resourceModule=HOTEL`；供应商类型固定为 `HOTEL`，`requiredTypeCode` å¯çœç•¥ã€‚ +- 酒店首次绑定ã€æ”¹ç»‘和解绑都å¯ä»¥çœç•¥ `changeReason`；此å‰è®¾ç½®ã€æ”¹ç»‘缺原因返回 `400 changeReasonä¸èƒ½ä¸ºç©º`。 +- 真正改绑或解绑å‰ä¼šæ£€æŸ¥è®¢å•ï¼šé…’店被未结æŸè®¢å•æŽ’房ã€ä½å®¿éœ€æ±‚点å或团期分房时返回 `395062`；产å“里仅列为备选的酒店ä¸æ‹¦æˆªã€‚ + +## 一ã€èƒŒæ™¯ + +酒店管ç†æ­¤å‰åˆ—表ä¸å«ä¾›åº”商全称，关系æ“作è¦æ±‚填写原因，改绑ã€è§£ç»‘ä¸æ£€æŸ¥è®¢å•ã€‚本次按景区ã€é¤åŽ…ã€æ¸¸çŽ©é¡¹ç›®çŽ°è¡Œå£å¾„冻结酒店所需的展示字段ã€è°ƒç”¨å‚æ•°ã€åŽŸå› è§„则和订å•çŠ¶æ€è¾¹ç•Œã€‚ + +## 二ã€å˜æ›´æŽ¥å£æ¸…å• + +| # | æŽ¥å£ | 方法 | 路径 | å˜æ›´ç±»åž‹ | 说明 | +|---|---|---|---|---|---| +| 1 | 酒店列表 | GET | `/admin/hotel/items` | å“应字段新增 | æ¯æ¡è®°å½•å›ºå®šè¿”回 `supplierFullName` | +| 2 | 查询酒店当å‰ä¾›åº”商 | GET | `/admin/supplier/resource-relations/{resourceModule}/{resourceId}/view` | 调用契约补充 | 酒店传 `resourceModule=HOTEL` | +| 3 | 设置或改绑酒店供应商 | PUT | `/admin/supplier/resource-relations/{resourceModule}/{resourceId}/update` | 请求与行为修改 | å¯çœç•¥åŽŸå› ï¼›çœŸæ­£æ”¹ç»‘增加未结æŸè®¢å•é—¨ç¦ | +| 4 | 解绑酒店供应商 | POST | `/admin/supplier/resource-relations/{resourceModule}/{resourceId}/unbind` | 行为修改 | å¯çœç•¥åŽŸå› ï¼›å¢žåŠ æœªç»“æŸè®¢å•é—¨ç¦ | + +## 三ã€æŽ¥å£è¯¦æƒ… + +### 1. 酒店列表 `GET /admin/hotel/items` + +**VO**: `HotelQueryRequest / PageResult` + +#### 使用场景 + +酒店管ç†åˆ—表åˆå§‹åŒ–ã€ç¿»é¡µã€ç­›é€‰æˆ–刷新时调用；列表“供应商â€åˆ—ç›´æŽ¥è¯»å– `supplierFullName`。 + +#### å…¥å‚ + +| 字段 | ä½ç½® | 类型 | å¿…å¡« | çº¦æŸ | 说明 | +|---|---|---|---|---|---| +| `keyword` | Query | String | å¦ | 最长 100 å­— | å称/地å€æ¨¡ç³Šæœç´¢ | +| `cityKeyword` | Query | String | å¦ | 最长 100 å­— | 城市åã€çœä»½ã€åœ°å€æ¨¡ç³Šæœç´¢ | +| `hotelType` | Query | String | å¦ | å­—å…¸ `hotel_type` | ä½å®¿ç±»åž‹ | +| `city` | Query | String | å¦ | - | 城市 | +| `district` | Query | String | å¦ | 最长 32 å­— | 区/åŽ¿ç²¾ç¡®åŒ¹é… | +| `starLevel` | Query | String | å¦ | å­—å…¸ `hotel_star_level` | 星级 | +| `status` | Query | Integer | å¦ | `0` 下架，`1` 上架 | 状æ€ç­›é€‰ | +| `tagId` | Query | Long | å¦ | - | å•ä¸ªæ ‡ç­¾ | +| `tagIds` | Query | String | å¦ | 逗å·åˆ†éš” | 多个标签 | +| `sortBy` | Query | String | å¦ | 最长 50 å­— | 排åºå­—段 | +| `sortDir` | Query | String | å¦ | `asc` 或 `desc` | 排åºæ–¹å‘ | +| `page` | Query | Integer | å¦ | æœ€å° 1，默认 1 | é¡µç  | +| `pageSize` | Query | Integer | å¦ | 1～100，默认 20 | æ¯é¡µæ¡æ•° | + +以上入å‚å‡ä¸ºæ—¢æœ‰å‚数，本次ä¸å˜ã€‚ + +#### å‡ºå‚ `Result>` + +| 字段 | 类型 | 说明 | +|---|---|---| +| `code` / `message` / `success` | Integer / String / Boolean | 业务结果 | +| `data.total` / `page` / `pageSize` | Long / Integer / Integer | åˆ†é¡µä¿¡æ¯ | +| `data.records[].hotelId` | String | 酒店 ID | +| `data.records[].name` | String | 酒店å称 | +| `data.records[].supplierFullName` | String 或 null | 当å‰æœ‰æ•ˆä¾›åº”商的法定全称；未关è”或供应商已删除时为 `null`，字段始终存在 | +| `data.records[]` 其他字段 | Object | 原酒店列表字段ä¿æŒä¸å˜ | + +#### 请求示例 + +无请求体： + +```http +GET /admin/hotel/items?page=1&pageSize=20 HTTP/1.1 +Authorization: Bearer +``` + +#### å“应示例 + +```json +{ + "code": 200, + "message": "æˆåŠŸ", + "success": true, + "data": { + "total": 2, + "page": 1, + "pageSize": 20, + "records": [ + {"hotelId": "2029000000000000101", "name": "示例酒店 A", "status": 1, "supplierFullName": "示例酒店供应商有é™å…¬å¸"}, + {"hotelId": "2029000000000000102", "name": "示例酒店 B", "status": 1, "supplierFullName": null} + ] + } +} +``` + +#### ç©ºæ•°æ® / é™çº§å“应 + +```json +{"code":200,"message":"æˆåŠŸ","success":true,"data":{"total":0,"page":1,"pageSize":20,"records":[]}} +``` + +#### 错误å“应 + +```json +{"code":401,"message":"缺少有效的 Authorization 头","success":false,"data":null} +``` + +#### 业务边界 + +- 本次ä¸æ–°å¢žç­›é€‰ã€æŽ’åºæˆ–分页规则；`supplierFullName` åªç”¨äºŽå±•ç¤ºï¼Œä¸æ˜¯ä¾›åº”商å称快照。 +- 无当å‰æœ‰æ•ˆå…³ç³»æ—¶å¿…须按 `null` 处ç†ï¼Œä¸è¦æ ¹æ®å­—段是å¦å­˜åœ¨åˆ†æ”¯ã€‚å°ç¨‹åºé…’店列表ä¸è¿”回该字段。 + +### 2. 查询酒店当å‰ä¾›åº”商 `GET /admin/supplier/resource-relations/{resourceModule}/{resourceId}/view` + +**VO**: `SupplierResourceRelationRespVO` + +#### 使用场景 + +打开酒店供应商弹窗或在写æ“作åŽåˆ·æ–°å½“å‰å…³ç³»æ—¶è°ƒç”¨ã€‚ + +#### å…¥å‚ + +| 字段 | ä½ç½® | 类型 | å¿…å¡« | çº¦æŸ | 说明 | +|---|---|---|---|---|---| +| `resourceModule` | Path | String | 是 | 酒店固定为 `HOTEL` | 资æºæ¨¡å— | +| `resourceId` | Path | String | 是 | 正整数 | 酒店 ID | + +#### å‡ºå‚ `Result` + +| 字段 | 类型 | 说明 | +|---|---|---| +| `code` / `message` / `success` | Integer / String / Boolean | 业务结果 | +| `data.relationId` | String | 当å‰å…³ç³» ID | +| `data.supplierId` / `supplierNo` / `supplierName` | String | 当å‰ä¾›åº”商 IDã€ç¼–å·å’Œå…¨ç§° | +| `data.resourceModule` / `moduleName` | String | `HOTEL` / é…’åº—ç®¡ç† | +| `data.resourceId` / `resourceName` | String | 酒店 ID å’Œå称 | +| `data.requiredTypeCode` / `requiredTypeName` | String | `HOTEL` / é…’åº—ç®¡ç† | +| `data.remark` | String 或 null | 关系备注 | +| `data.available` / `unavailableReasons` | Boolean / Array | 当å‰å…³ç³»æ˜¯å¦ä»å¯ç”¨åŠä¸å¯ç”¨åŽŸå›  | +| `data.createTime` / `updateTime` | String | `yyyy-MM-dd HH:mm:ss`；写æ“作使用最新 `updateTime` | + +#### 请求示例 + +无请求体： + +```http +GET /admin/supplier/resource-relations/HOTEL/2029000000000000101/view HTTP/1.1 +Authorization: Bearer +``` + +#### å“应示例 + +```json +{ + "code": 200, + "message": "æˆåŠŸ", + "success": true, + "data": { + "relationId": "2098200000000000101", + "supplierId": "2097899397319684099", + "supplierNo": "SUP260001", + "supplierName": "示例酒店供应商有é™å…¬å¸", + "resourceModule": "HOTEL", + "moduleName": "酒店管ç†", + "resourceId": "2029000000000000101", + "resourceName": "示例酒店 A", + "requiredTypeCode": "HOTEL", + "requiredTypeName": "酒店管ç†", + "remark": null, + "available": true, + "unavailableReasons": [], + "createTime": "2026-09-11 20:00:00", + "updateTime": "2026-09-11 20:00:00" + } +} +``` + +#### ç©ºæ•°æ® / é™çº§å“应 + +当å‰æ²¡æœ‰æœ‰æ•ˆå…³ç³»æ—¶ä¸æ˜¯ç©ºæˆåŠŸï¼Œè¿”回 `395038`。 + +#### 错误å“应 + +```json +{"code":395038,"message":"供应商资æºå…³è”ä¸å­˜åœ¨","success":false,"data":null} +``` + +#### 业务边界 + +- 使用现有登录凭è¯åŠ `supplier:resource:view` æœåŠ¡ç«¯æƒé™ï¼›å‰ç«¯æŒ‰é’®å¯è§æ€§ä¸èƒ½æ›¿ä»£åŽç«¯åˆ¤æƒã€‚ +- 未关è”时按 `395038` 展示“未设置供应商â€ï¼›ä¸è¦æŠŠå®ƒå½“æˆç³»ç»Ÿå¼‚常。 + +### 3. 设置或改绑酒店供应商 `PUT /admin/supplier/resource-relations/{resourceModule}/{resourceId}/update` + +**VO**: `SupplierResourceReassignReqVO / SupplierResourceRelationRespVO` + +#### 使用场景 + +酒店当å‰æ— å…³ç³»æ—¶é¦–次设置供应商，或选择å¦ä¸€ä¾›åº”商åŽæ”¹ç»‘。候选供应商ä»ç”¨ `GET /admin/supplier/items/list?resourceModule=HOTEL&resourceId={id}` 获å–（本次ä¸å˜ï¼‰ã€‚ + +#### å…¥å‚ + +| 字段 | ä½ç½® | 类型 | å¿…å¡« | çº¦æŸ | 说明 | +|---|---|---|---|---|---| +| `resourceModule` | Path | String | 是 | 酒店固定为 `HOTEL` | 资æºæ¨¡å— | +| `resourceId` | Path | String | 是 | 正整数 | 酒店 ID | +| `supplierId` | Body | String | 是 | 正整数 | 目标供应商 ID | +| `requiredTypeCode` | Body | String | å¦ | å¯çœç•¥ï¼›ä¼ å€¼åªèƒ½ä¸º `HOTEL` | 关系è¦æ±‚的供应商类型，由åŽç«¯å›ºå®š | +| `remark` | Body | String | å¦ | 最长 500 å­— | 关系备注 | +| `expectedCurrentSupplierId` | Body | String | 改绑时是 | 与版本时间åŒæ—¶ä¼ æˆ–åŒæ—¶çœç•¥ | 当å‰å…³ç³»çš„ `supplierId` | +| `expectedRelationUpdateTime` | Body | String | 改绑时是 | `yyyy-MM-dd HH:mm:ss` | 当å‰å…³ç³»çš„ `updateTime` | +| `changeReason` | Body | String | å¦ | 最长 500 å­— | 首次设置和改绑å‡å¯çœç•¥ï¼›ä¸è¦è¡¥é»˜è®¤åŽŸå›  | + +#### å‡ºå‚ `Result` + +| 字段 | 类型 | 说明 | +|---|---|---| +| `code` / `message` / `success` | Integer / String / Boolean | 业务结果 | +| `data.relationId` / `supplierId` / `supplierNo` / `supplierName` | String | 生效关系åŠä¾›åº”å•†ä¿¡æ¯ | +| `data.resourceModule` / `moduleName` / `resourceId` / `resourceName` | String | 酒店模å—和资æºä¿¡æ¯ | +| `data.requiredTypeCode` / `requiredTypeName` | String | 固定 `HOTEL` / é…’åº—ç®¡ç† | +| `data.remark` | String 或 null | 关系备注 | +| `data.available` / `unavailableReasons` | Boolean / Array | 当å‰å¯ç”¨æ€§ | +| `data.createTime` / `updateTime` | String | 当å‰å…³ç³»æ—¶é—´ä¸ŽåŽç»­æ“作版本 | + +#### 请求示例 + +首次绑定时ä¸è¦ä¼ ä¸¤ä¸ª `expected*` 字段，也无需传 `requiredTypeCode`ã€`changeReason`： + +```json +{"supplierId":"2097899397319684099"} +``` + +改绑时两个版本字段必须æ¥è‡ªæœ€æ–°å…³ç³»å›žè¯»ï¼š + +```json +{"supplierId":"2097849575707475970","expectedCurrentSupplierId":"2097899397319684099","expectedRelationUpdateTime":"2026-09-11 20:00:00"} +``` + +#### å“应示例 + +```json +{ + "code": 200, + "message": "æˆåŠŸ", + "success": true, + "data": { + "relationId": "2098200000000000102", + "supplierId": "2097849575707475970", + "supplierNo": "SUP260002", + "supplierName": "示例新酒店供应商有é™å…¬å¸", + "resourceModule": "HOTEL", + "moduleName": "酒店管ç†", + "resourceId": "2029000000000000101", + "resourceName": "示例酒店 A", + "requiredTypeCode": "HOTEL", + "requiredTypeName": "酒店管ç†", + "remark": null, + "available": true, + "unavailableReasons": [], + "createTime": "2026-09-11 20:01:00", + "updateTime": "2026-09-11 20:01:00" + } +} +``` + +#### ç©ºæ•°æ® / é™çº§å“应 + +无空æˆåŠŸç»“果；订å•æœåŠ¡ã€æƒé™æˆ–字典等必è¦ä¾èµ–无法明确核验时返回失败且ä¸æ”¹å˜å…³ç³»ã€‚ + +#### 错误å“应 + +```json +{"code":395062,"message":"酒店已关è”订å•ï¼Œä¸èƒ½æ›´æ¢ä¾›åº”商","success":false,"data":null} +``` + +```json +{"code":400,"message":"requiredTypeCode与资æºæ¨¡å—ä¸åŒ¹é…","success":false,"data":null} +``` + +#### 业务边界 + +- 当å‰æ— å…³ç³»æ—¶æ˜¯é¦–次绑定：ä¸ä¼ ç‰ˆæœ¬å¯¹ï¼›å³ä½¿é…’店已有订å•ä¹Ÿå…许绑定。 +- 当å‰æœ‰å…³ç³»ä¸”目标供应商ä¸åŒæ‰æ˜¯çœŸæ­£æ”¹ç»‘：必须传完整ã€æœ€æ–°ç‰ˆæœ¬å¯¹ï¼›é…’店被未结æŸè®¢å•æŽ’房ã€ä½å®¿éœ€æ±‚点å或团期分房时返回 `395062`，原关系ä¸å˜ï¼›åªå…³è”已完æˆã€å·²å–消订å•ï¼ˆåŒ…括两者混åˆï¼‰æˆ–åªåœ¨äº§å“里列为备选时å…许。 +- 版本过期返回 `395014`；必è¦ä¾èµ–无法明确判断返回 `395039`；失败ä¸æ”¹å˜å…³ç³»æˆ–审计。 + +### 4. 解绑酒店供应商 `POST /admin/supplier/resource-relations/{resourceModule}/{resourceId}/unbind` + +**VO**: `SupplierResourceUnbindReqVO / Result` + +#### 使用场景 + +用户确认清除酒店当å‰ä¾›åº”商关系时调用。 + +#### å…¥å‚ + +| 字段 | ä½ç½® | 类型 | å¿…å¡« | çº¦æŸ | 说明 | +|---|---|---|---|---|---| +| `resourceModule` | Path | String | 是 | 酒店固定为 `HOTEL` | 资æºæ¨¡å— | +| `resourceId` | Path | String | 是 | 正整数 | 酒店 ID | +| `expectedCurrentSupplierId` | Body | String | 是 | 正整数 | 当å‰å…³ç³»çš„ `supplierId` | +| `expectedRelationUpdateTime` | Body | String | 是 | `yyyy-MM-dd HH:mm:ss` | 当å‰å…³ç³»çš„ `updateTime` | +| `changeReason` | Body | String | å¦ | 最长 500 å­— | å¯çœç•¥ã€`null`ã€ç©ºä¸²æˆ–空白；ä¸è¦è¡¥é»˜è®¤åŽŸå›  | + +#### å‡ºå‚ `Result` + +| 字段 | 类型 | 说明 | +|---|---|---| +| `code` / `message` / `success` | Integer / String / Boolean | 业务结果 | +| `data` | null | æˆåŠŸæ—¶å›ºå®šä¸º `null` | + +#### 请求示例 + +```json +{"expectedCurrentSupplierId":"2097849575707475970","expectedRelationUpdateTime":"2026-09-11 20:01:00"} +``` + +#### å“应示例 + +```json +{"code":200,"message":"æˆåŠŸ","success":true,"data":null} +``` + +#### ç©ºæ•°æ® / é™çº§å“应 + +当å‰æ— å…³ç³»æ—¶è¿”回 `395038`；必è¦ä¾èµ–无法明确核验时返回 `395039`，å‡ä¸æ‰§è¡Œè§£ç»‘。 + +#### 错误å“应 + +```json +{"code":395062,"message":"酒店已关è”订å•ï¼Œä¸èƒ½æ›´æ¢ä¾›åº”商","success":false,"data":null} +``` + +#### 业务边界 + +- 解绑必须使用当å‰å…³ç³»æœ€æ–°ç‰ˆæœ¬å¯¹ï¼›ç‰ˆæœ¬è¿‡æœŸè¿”回 `395014`，原关系ä¸å˜ã€‚ +- 酒店被未结æŸè®¢å•æŽ’房ã€ä½å®¿éœ€æ±‚点å或团期分房时返回 `395062`ï¼›åªå…³è”已完æˆã€å·²å–消订å•ï¼ˆåŒ…括两者混åˆï¼‰æ—¶å…许解绑。 +- 登录ã€`supplier:resource:manage` æœåŠ¡ç«¯æƒé™ã€æ•°æ®èŒƒå›´ã€å¹‚ç­‰ã€é”和审计规则ä¿æŒä¸å˜ï¼›å¤±è´¥é›¶å†™å…¥ã€‚ + +## å››ã€å¥‘约约æŸä¸Žæ­£ç¡®è°ƒç”¨æ–¹å¼ + +| 场景 | 正确 payload | 调用结果 | +|---|---|---| +| 查询当å‰å…³ç³» | 无请求体，`resourceModule=HOTEL` | 返回关系；无关系为 `395038` | +| 首次绑定 | `{"supplierId":"22"}` | ä¸ä¼ ç‰ˆæœ¬å¯¹ã€ç±»åž‹å’ŒåŽŸå›  | +| 改绑 | `{"supplierId":"33","expectedCurrentSupplierId":"22","expectedRelationUpdateTime":"2026-09-11 20:00:00"}` | 两个版本字段必须æˆå¯¹ä¸”å–最新关系值 | +| 解绑 | `{"expectedCurrentSupplierId":"33","expectedRelationUpdateTime":"2026-09-11 20:01:00"}` | å¯çœç•¥ `changeReason` | +| 错误：传其他类型 | `{"supplierId":"33","requiredTypeCode":"SCENIC"}` | 返回 `400`，ä¸å†™å…¥ | +| 错误：版本字段åªä¼ ä¸€ä¸ª | `{"supplierId":"33","expectedCurrentSupplierId":"22"}` | 返回 `400`，ä¸å†™å…¥ | + +æ¯æ¬¡æ”¹ç»‘或解绑å‰å…ˆå›žè¯»å½“å‰å…³ç³»ï¼ŒæˆåŠŸåŽé‡æ–°åˆ·æ–°å…³ç³»å’Œé…’店列表。业务失败å¯èƒ½ä»ä¸º HTTP 200，必须åŒæ—¶åˆ¤æ–­å“应体 `code` 与 `success`。 + +## 五ã€æ•°æ®åº“行为 + +| å‰ç«¯æ“作 | 外部å¯è§‚察结果 | +|---|---| +| 首次绑定 | 生æˆä¸€ä¸ªå½“å‰æœ‰æ•ˆå…³ç³»ï¼Œ`requiredTypeCode=HOTEL`；未填原因时ä¸è™šæž„默认原因 | +| 改绑 | 旧关系转为历å²ï¼Œæ–°ä¾›åº”商æˆä¸ºå”¯ä¸€å½“å‰å…³ç³»ï¼Œå¹¶ä¿ç•™æ­£å¸¸å˜æ›´å®¡è®¡ | +| 解绑 | 当å‰å…³ç³»æ¶ˆå¤±å¹¶ä¿ç•™æ­£å¸¸è§£ç»‘审计；酒店列表返回 `supplierFullName: null` | +| 订å•ã€ç‰ˆæœ¬ã€æƒé™ã€ç±»åž‹æˆ–资格校验失败 | 当å‰å…³ç³»å’Œå®¡è®¡å‡ä¸å˜åŒ– | + +本次ä¸è¿ç§»æˆ–回填任何数æ®ï¼Œä¸ä¿®æ”¹è®¢å•ä¸šåŠ¡ã€è®¢å•æ•°æ®æˆ–订å•ä¾›åº”商快照。 + +## å…­ã€è¾¹ç•Œè¡Œä¸º + +- 未登录返回 `401`；关系查询è¦æ±‚查看æƒé™ï¼Œè®¾ç½®ã€æ”¹ç»‘ã€è§£ç»‘è¦æ±‚维护æƒé™åŠå¯¹åº”æ•°æ®èŒƒå›´ã€‚ +- 酒店未绑定供应商时，列表返回 `supplierFullName: null`，关系查询返回 `395038`。 +- `changeReason` 最长 500 å­—ï¼›çœç•¥ã€`null`ã€ç©ºä¸²æˆ–纯空白å‡æŒ‰æœªå¡«å†™å¤„ç†ã€‚ +- 未结æŸè®¢å•åŒ…å«é™¤ `COMPLETED`ã€`CANCELLED` 以外的状æ€ä»¥åŠæœªçŸ¥çŠ¶æ€ï¼›æ–°æ—§è®¢å•ä»»ä¸€ç¡®è®¤å­˜åœ¨å³è¿”回 `395062`。 +- 订å•å…³è”åªè®¤æˆ¿æŽ§å·²æŽ’房ã€è®¢å•å½“å‰ä½å®¿éœ€æ±‚点åã€å›¢æœŸåˆ†æˆ¿ï¼›äº§å“里仅列为备选的酒店ä¸è®¡å…¥ã€‚ +- 无法从任一订å•æœåŠ¡å¾—到明确结果时返回 `395039`，ä¸æŠŠä¾èµ–异常当æˆæ— è®¢å•ã€‚ + +## å…­.5ã€æžšä¸¾ / æ•°æ®å­—å…¸ + +### `resourceModule` / `requiredTypeCode`（酒店供应商关系） + +**所属字段**: Path `resourceModule`ã€Body/Response `requiredTypeCode` | **类型**: `String` + +| 值 | 中文 | 说明 | +|---|---|---| +| `HOTEL` | é…’åº—ç®¡ç† | 酒店关系固定值；`requiredTypeCode` å¯çœç•¥å¹¶ç”±åŽç«¯ç¡®å®š | + +### ä¸šåŠ¡é”™è¯¯ç  + +| 值 | 中文 | 说明 | +|---|---|---| +| `395062` | 酒店已关è”订å•ï¼Œä¸èƒ½æ›´æ¢ä¾›åº”商 | 本次新增；真正改绑或解绑时存在未结æŸè®¢å• | + +## å…­.6ã€ä¿®æ”¹å‰åŽå¯¹æ¯” + +### 字段级对比 + +| 字段 | æ”¹å‰ | æ”¹åŽ | +|---|---|---| +| `GET /admin/hotel/items` çš„ `records[].supplierFullName` | ä¸è¿”回 | æ¯æ¡å›ºå®šè¿”回 `String` 或 `null` | +| 酒店设置/改绑的 `changeReason` | å¿…å¡« | å¯çœç•¥ï¼›åŽŸæœ‰éžç©ºå€¼ç»§ç»­å…¼å®¹ | +| 酒店解绑的 `changeReason` | å·²å¯çœç•¥ | ä¿æŒå¯çœç•¥ | + +### 行为级对比 + +| 行为 | æ”¹å‰ | æ”¹åŽ | +|---|---|---| +| 酒店列表展示供应商 | 列表无å称字段 | ç›´æŽ¥è¯»å– `supplierFullName` | +| 酒店真正改绑ã€è§£ç»‘ | ä¸æ£€æŸ¥è®¢å• | 被未结æŸè®¢å•æŽ’房ã€ç‚¹å或团期分房时返回 `395062`；其他情形放行 | +| 尚未绑定供应商的酒店 | å¯é¦–次绑定（须填原因） | å¯é¦–次绑定且å¯çœç•¥åŽŸå› ï¼Œå³ä½¿å·²æœ‰è®¢å• | + +## å…­.7ã€å½±å“评估 + +- **是å¦ç ´åå‘åŽå…¼å®¹**: å¦ï¼›æ–°å¢žå¯ç©ºå­—段ã€æ”¾å®½å¯é€‰å…¥å‚与新增业务ä¿æŠ¤ã€‚ +- **å‰ç«¯æ˜¯å¦å¿…é¡»åŒæ­¥ä¸Šçº¿**: 是。 +- **å‰ç«¯ workaround 清ç†ç‚¹**: 酒店列表直接展示 `supplierFullName`ï¼›å¤ç”¨ä¾›åº”商关系弹窗并传 `HOTEL`；删除酒店设置/改绑/解绑原因弹框和必填校验；收到 `395062` æ—¶æ示原文并ä¿æŒå½“å‰å…³ç³»ã€‚ + +## 七ã€ä¸å½±å“范围 + +- **ä»…å½±å“**: 管ç†ç«¯é…’店列表ã€é…’店供应商关系æ“作。 +- **零影å“**: 订å•åˆ›å»ºã€çŠ¶æ€æµè½¬ã€ç»“ç®—ã€æ”¯ä»˜ã€é€€æ¬¾ã€è®¢å•æ•°æ®å’Œè®¢å•ä¾›åº”商快照；å°ç¨‹åºé…’店列表；供应商候选列表。 +- 景区ã€é¤åŽ…ã€æ¸¸çŽ©é¡¹ç›®åŠå…¶ä»–资æºæ¨¡å—的字段ã€ç±»åž‹ã€åŽŸå› è§„则和订å•é—¨ç¦ä¿æŒåŽŸå¥‘约；数æ®åº“结构ã€é…ç½®ã€Redisã€MQ å’Œ Gateway 路由无å˜åŒ–。 + +## å…«ã€æµ‹è¯•çŽ¯å¢ƒå·²éªŒè¯ + +TEST 部署æ交 `02e998fbf706e5d69cb872ece7c9034128dec6e7`（hl-order-service-v3 任务 c01e3996ã€hl-order-service-v2 任务 051efee5ã€hl-resource-service 任务 72fd67b1，å‡åŒå®žä¾‹å¥åº·ï¼‰ï¼›2026-09-11 ç» Gateway 以真实 TEST 身份实测 38/38 通过： + +| 场景 | 结果 | +|---|---| +| `GET /admin/hotel/items` æ¯æ¡è®°å½•å« `supplierFullName`；已绑定酒店为当å‰ä¾›åº”商全称，未绑定为 `null` | 通过 | +| 未绑定酒店首次绑定ã€æ”¹ç»‘ã€è§£ç»‘å‡ä¸ä¼  `changeReason` æˆåŠŸï¼›åˆ—表字段éšä¹‹å˜åŒ– | 通过 | +| `requiredTypeCode=SCENIC` 绑定酒店 | 返回 400 | +| 已绑定且有未结æŸè®¢å•ï¼ˆæˆ¿æŽ§æŽ’房）的酒店改绑ã€è§£ç»‘ | å‡è¿”回 `395062`，原关系ä¸å˜ | +| 仅在未结æŸè®¢å•äº§å“中列为备选的酒店改绑并改回 | å‡æˆåŠŸ | +| 尚未绑定ã€è®¢å•ä½å®¿éœ€æ±‚已点å的酒店首次绑定 | æˆåŠŸ | +| åŒä¸€é…’店在该订å•æœªç»“æŸæ—¶æ”¹ç»‘ã€è§£ç»‘ | å‡è¿”回 `395062`，原关系ä¸å˜ | +| 订å•å‡ºè¡Œå‰å–消åŽï¼ˆä»…å…³è”å·²å–消订å•ï¼‰æ”¹ç»‘ã€è§£ç»‘ | å‡æˆåŠŸ | +| 验收å‰åŽçœŸå®žä¾›åº”商关系ã€V2/V3 订å•æ‘˜è¦ | 一致 | + +ä»…å…³è”已完æˆè®¢å•ã€å·²å®Œæˆä¸Žå·²å–消混åˆä¸¤ç§æƒ…形由 V2ã€V3 隔离 MySQL 自动化测试è¯æ˜Žã€‚ + +**当å‰çŠ¶æ€ï¼šåŽç«¯å·²éƒ¨ç½²å¹¶éªŒè¯ï¼›å¾…å‰ç«¯å¤„ç†ã€‚** + +## ä¹ã€ç›¸å…³åŽ†å² PR + +| PR | Issue | 说明 | 是å¦ä»æœ‰æ•ˆ | +|---|---|---|---| +| #7358 | #7357 | 景区改绑供应商å…原因 | 是 | +| #7401 | #7400 | 全部资æºä¾›åº”商解绑å…原因 | 是 | +| #7493 | #7387 | é¤åŽ…列表ã€åŽŸå› è§„则与订å•é—¨ç¦ | 是 | +| #7507 | #7500 | 游玩项目列表ã€åŽŸå› è§„则与订å•é—¨ç¦ | 是 | +| **#7552** | **#7509** | 酒店列表ã€åŽŸå› è§„则与订å•é—¨ç¦ | **是，酒店最新契约** | + +## åã€ç›¸å…³æ–‡æ¡£ + +- å…³è” Issue：[#7509](https://git.1814.love:8443/wx/HL/issues/7509) +- åŽç«¯ PR：[#7552](https://git.1814.love:8443/wx/HL/pulls/7552) +- åˆå¹¶æ交：`02e998fbf706e5d69cb872ece7c9034128dec6e7`（PR #7552） + +## å…³è” / è”系人 + +### 链接 + +- **Issue**: [#7509](https://git.1814.love:8443/wx/HL/issues/7509) +- **PR**: [#7552](https://git.1814.love:8443/wx/HL/pulls/7552) +- **Merge commit**: `02e998fbf706e5d69cb872ece7c9034128dec6e7` + +### è”系人 + +- **åŽç«¯è´Ÿè´£äºº**: @lc