【前端 BUG·管理后台】自定义推送「选择员工」下拉无数据 = 前端未接 searchAdmins 接口

关联: 工单 #3414（内部员工站内信，PR #3424/#3425/#3427）服务: 前端 hl-ui（后端无改动）| 提报时间: 2026-06-05

存放目录: changelogs-v2/2026-06/ 影响范围: 管理后台「通知中心 / 自定义推送」→ 站内信(内部员工) → 指定员工类型: 前端接线 bug（mmg 修），后端已实测正常无需改动

⚠️ 关键说明

测试环境「自定义推送」页，选「站内信(内部员工)」通道 + 「指定员工」后，「选择员工」下拉显示「无数据」。

根因 = 前端把下拉 UI 画了，但没接后端搜索接口。 后端 GET /admin/notification/custom-push/admins 实测 200、返 20 个员工，后端没问题。

1. 实证（测试服 nginx 访问日志）

在该页面操作时，浏览器对内部接口的调用只有一条 GET /admin/role/all（给「按角色」选项用的），对搜员工的 /admin/notification/custom-push/admins 零调用。即「选择员工」远程搜索框没绑后端接口。

后端实测对照（Python 直调，均 200 有数据）：

# 空关键词返前 20 个员工
GET /admin/notification/custom-push/admins?keyword=        -> 200, 20 条
# 按姓名/用户名模糊
GET /admin/notification/custom-push/admins?keyword=admin   -> 200, 2 条

2. 前端修法（mmg）

2.1 「指定员工」选择员工下拉 → 接成远程搜索

输入时调用（带当前 admin token）：

GET /admin/notification/custom-push/admins?keyword={输入值}

响应 data：员工数组，每项字段：

字段	类型	用途
`adminId`	string	option 的 value（雪花 String，提交时收集成 `adminIds`）
`name`	string	option 的 label（企微真名，可能为空则用 `username`）
`username`	string	登录名（label 兜底）
`roleKey` / `roleName`	string	角色（可展示副文本）

提交推送时（§见 04_3414 §5.2）：{channel:"ADMIN_INAPP", targetType:"ADMIN_SPECIFIC", adminIds:[选中的 adminId...], title, content}。

2.2 ⚠️ 字段名和 C 端不一样，别照搬

若克隆 C 端「选择用户」组件（/custom-push/users），注意字段名不同：

角色	接口	返回字段
C 端客人	`/custom-push/users`	`id` / `realName` / `phone` / `avatarUrl`
内部员工	`/custom-push/admins`	`adminId` / `name` / `username` / roleKey / roleName

克隆组件必须改字段映射（id→adminId、realName→name），否则就算接上接口，也会因取不到字段继续「无数据」。

2.3 「按角色」目标

「按角色」当前已接 /admin/role/all 加载角色列表（正常）。选角色后提交：{channel:"ADMIN_INAPP", targetType:"ADMIN_BY_ROLE", roleKeys:[选中的 roleKey...], title, content}。

3. 后端状态（无需改动）

/admin/notification/custom-push/admins（搜员工）：已部署测试服，实测 200 有数据。
/admin/notification/custom-push（发站内信）：已部署，ADMIN_SPECIFIC / ADMIN_BY_ROLE 实测通过。
内部员工站内信分类固定 SYSTEM（后端强制，前端「消息分类」对内部员工可隐藏）。

4. 关联

主功能 changelog：04_3414_内部员工站内信收件箱-SSE实时推送-管理后台.md（§5 选内部员工 + §3 SSE）
后端负责人：@wx
前端对接（本 bug 修复）：mmg

3.6 KiB 原始文件 Blame 文件历史 Unescape Escape