diff --git a/changelogs-v2/2026-09/03_7042_设置供应商列表按资源类型过滤-前端缺陷-管理后台.md b/changelogs-v2/2026-09/03_7042_设置供应商列表按资源类型过滤-前端缺陷-管理后台.md new file mode 100644 index 00000000..620b1c90 --- /dev/null +++ b/changelogs-v2/2026-09/03_7042_设置供应商列表按资源类型过滤-前端缺陷-管理后台.md @@ -0,0 +1,60 @@ +--- +schema: "hl-changelog/v2" +ticket: "7042" +title: "设置供应商列表按资源类型过滤" +consumer: "admin" +author: "lc(GIT)" +change_type: "前端缺陷" +backend_status: "not_required" +gateway_status: "not_required" +frontend_status: "pending" +frontend_owner: "" +frontend_ref: "" +target_release: "" +verified_at: "" +status_note: "后端现有 typeCode 筛选与关系类型门禁正确;首次设置供应商时前端未传资源对应类型。当前状态:待前端处理。" +updated_at: "2026-09-03" +base: "dev-v3" +--- + +# 设置供应商列表按资源类型过滤 + +后端接口、字段和错误码均无变化。本条仅明确管理端资源页面调用现有供应商接口的正确方式;当前状态:**待前端处理**。 + +## 接口与字段 + +- 列表接口:`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`;既有运行契约不受影响。 + +## 关联 + +- Issue:[#7042](https://git.1814.love:8443/wx/HL/issues/7042) +- 后端联系人:@lc