更正供应商类型过滤前端状态（#7042）

2026-09-04 09:51:13 +08:00
@@ -7,54 +7,28 @@ author: "lc(GIT)"
 change_type: "前端缺陷"
 backend_status: "not_required"
 gateway_status: "not_required"
-frontend_status: "pending"
+frontend_status: "not_required"
 frontend_owner: ""
 frontend_ref: ""
 target_release: ""
 verified_at: ""
-status_note: "后端现有 typeCode 筛选与关系类型门禁正确；首次设置供应商时前端未传资源对应类型。当前状态：待前端处理。"
-updated_at: "2026-09-03"
+status_note: "原前端传入 typeCode 并维护类型映射的要求已作废；改由后端工单 #7059 处理。当前状态：无需前端处理。"
+updated_at: "2026-09-04"
 base: "dev-v3"
 ---

-# 设置供应商列表按资源类型过滤
+# 设置供应商列表按资源类型过滤（更正）

-后端接口、字段和错误码均无变化。本条仅明确管理端资源页面调用现有供应商接口的正确方式；当前状态：**待前端处理**。
+> **更正（2026-09-04）**：原记录要求前端传入 `typeCode` 并维护资源分类与供应商类型映射，该要求已作废。当前状态：**无需前端处理**。

-## 接口与字段
+## 更正结论

- 列表接口：`GET /admin/supplier/items/list`
- 请求参数：`status=ACTIVE`、`typeCode=<当前资源要求的供应商类型>`、`limit=200`；搜索时继续传 `keyword`。
- 响应：`data[]` 中每个供应商都具有请求的有效 `typeCode` 关系；`types[]` 仍返回该供应商的有效类型列表。
- 关系写接口：`PUT /admin/supplier/resource-relations/{resourceModule}/{resourceId}/update`。对必须显式指定或允许覆盖类型的模块，`requiredTypeCode` 应与列表请求的 `typeCode` 一致。
-
-## 资源类型口径
-
-| `resourceModule` | 列表 `typeCode` |
-| --- | --- |
-| `SCENIC` | `SCENIC` |
-| `RESTAURANT` | `RESTAURANT` |
-| `HOTEL` | `HOTEL` |
-| `VEHICLE` | `FLEET` |
-| `SUPPLIES_COMBO` | `SUPPLIES` |
-| `SUPPLIES` | 默认 `SUPPLIES`；存在明确的有效要求类型时使用该类型 |
-| `SERVICE` | 默认 `SERVICE`；存在明确的有效要求类型时使用该类型 |
-| `ACTIVITY`、`COST_ITEM`、`STAFF` | 使用当前资源业务上下文明确的要求类型，不得省略 |
-
-景区管理的调用示例：`GET /admin/supplier/items/list?status=ACTIVE&typeCode=SCENIC&limit=200`。该列表不得显示仅具有 `FLEET` 类型、没有 `SCENIC` 类型的供应商。
-
-## 前端处理要求
-
-1. 在首次设置供应商和已有关系改绑两种入口打开选择器前，先从资源模块或资源业务上下文确定要求类型，再把该值作为列表接口的 `typeCode`；不得只从已有关系的 `requiredTypeCode` 取值。
-2. 查询当前关系返回业务码 `395038` 只表示尚未绑定，不能据此清空类型并请求全部 `ACTIVE` 供应商；无法确定要求类型时不要展示未过滤列表。
-3. 统一响应可能使用 HTTP 200 表达业务失败，继续判断 `code`、`success` 和 `data`。关系写入返回 `395037` 时表示目标供应商类型不满足资源要求。
-
-## 变更与撤回
-
- 后端源码、前端源码、接口、数据库、配置、Redis 和 MQ 均无变更。
- 如需撤回联调说明，精确回退本 Changelog 提交并推送 `main`；既有运行契约不受影响。
+- 前端无需新增或修改代码，也无需维护资源分类与供应商类型映射。
+- 原“资源类型口径”和“前端处理要求”全部撤销，不再作为调用约束。
+- 设置供应商候选列表的类型解析与过滤改由后端工单 #7059 处理。

 ## 关联

 - Issue：[#7042](https://git.1814.love:8443/wx/HL/issues/7042)
+- 后端更正工单：[#7059](https://git.1814.love:8443/wx/HL/issues/7059)
 - 后端联系人：@lc