hl-api-changelog/changelogs-v2/2026-09/03_7042_设置供应商列表按资源类型过滤-前端缺陷-管理后台.md

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base

schema	ticket	title	consumer	author	change_type	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	target_release	verified_at	status_note	updated_at	base
hl-changelog/v2	7042	设置供应商列表按资源类型过滤	admin	lc(GIT)	前端缺陷	not_required	not_required	pending					后端现有 typeCode 筛选与关系类型门禁正确；首次设置供应商时前端未传资源对应类型。当前状态：待前端处理。	2026-09-03	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
• 后端联系人：@lc