hl-api-changelog/changelogs-v2/2026-06/05_3414_站内信前端待办清单-我的消息页未建404+选员工下拉未接线-管理后台.md

4.0 KiB

【前端待办清单·管理后台】内部员工站内信:「我的消息」页未建(404) + 选员工下拉未接线

关联: 工单 #3414PR #3424/#3425/#3427 服务: 前端 hl-ui后端 100% 就绪、已部署测试服、API 实测通过,无任何后端待办 提报时间: 2026-06-05 | 责任方: mmg


⚠️ 总览:后端全好,卡在两个前端待办

内部员工站内信后端完整交付(收件箱 API + SSE 实时 + 自定义推送选员工),但前端有 2 处没做完,导致功能用不起来。逐条实测定性如下,mmg 照清单勾:

# 待办 现象(测试环境实测) 缺什么
1 「我的消息」收件箱页 访问 /notification/my-messages404 页面不存在;菜单树里通知中心下没有「我的消息」菜单 菜单 + 路由 + 页面组件 + 顶部铃铛,全没建
2 自定义推送「选择员工」下拉 选「站内信(内部员工)」+「指定员工」后下拉无数据 下拉 UI 建了但没接搜索接口(访问日志实证零调用)

1. 「我的消息」收件箱页完全没建,404

实测:直接访问 https://web.test.1814.love:9443/notification/my-messages 返回前端 404;/admin/menu/tree 里通知中心(menu_id=950)下仍只有 通知配置/消息分类管理/通知日志/自定义推送,无「我的消息」

要做的(参照 04_3414 §入口位置)

  1. sys_menu 加菜单:通知中心(950)下加「我的消息」,component 指向新页面组件(建议 notification/MyMessages),经「系统管理→菜单管理」加。
  2. 顶部全局铃铛:未读红点 = GET /admin/message/unread-count,由 SSE 实时刷新。
  3. 收件箱页组件(平铺列表,内部员工统一 SYSTEM 分类,不需要分类 tab
    • 列表 GET /admin/message/list?pageNo=&pageSize=
    • 详情 GET /admin/message/{id}🆕 深链/刷新/铃铛点击时按 ID 拉单条,返回完整 content/link;纯查询不改已读,不存在/越权返 code=200401「站内信不存在或无权访问」
    • 单条/全部已读 PUT /admin/message/{id}/readPUT /admin/message/read-all
    • 删除 DELETE /admin/message/{id}
  4. SSE 客户端new EventSource('https://api.test.1814.love:9443/ws/admin-msg/stream?token={admin token}'),收到 message 事件刷新角标(详见 04_3414 §3

后端这些接口均已部署测试服 + 实测 200。光加菜单不建组件 = 点开 404现状就是


2. 自定义推送「选择员工」下拉(建了但没接线)

详见 05_3414_选择员工下拉无数据-前端未接searchAdmins接口-管理后台.md。要点:

  • 「指定员工」下拉接成远程搜索:输入调 GET /admin/notification/custom-push/admins?keyword={输入}adminId 作 value、name 作 label。
  • ⚠️ 字段名和 C 端不同:员工接口返 adminId/name别照搬 C 端的 id/realName,克隆组件须改字段映射。

3. 后端状态(无需改动,已全部就绪)

  • 收件箱:/admin/message/*(列表/未读数/已读/删除) 实测 200
  • 🆕 单条详情:GET /admin/message/{id}PR #3490,2026-06-05 合 dev-v3 + 部署测试服) 实测:命中返完整 VO含 content/link;不存在/越权返 code=200401 —— 给「我的消息」详情页深链/刷新用
  • SSE 实时:/ws/admin-msg/stream(过网关 + nginx 实测收到事件)
  • 选员工:/admin/notification/custom-push/admins 实测返 20 员工
  • 发站内信:POST /admin/notification/custom-pushADMIN_INAPP 实测落库 + SSE 推送

4. 关联

  • 主功能 + 完整接口契约:04_3414_内部员工站内信收件箱-SSE实时推送-管理后台.md
  • 选员工下拉 bug 详情:05_3414_选择员工下拉无数据-前端未接searchAdmins接口-管理后台.md
  • 后端:@wx | 前端:mmg