From 8c1454545293b3ceaf8e9f08a06c565fccef967a Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 5 Jun 2026 10:27:18 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E5=91=8A=E7=9F=A5=E5=89=8D?= =?UTF-8?q?=E7=AB=AF=20#3414=20=E7=AB=99=E5=86=85=E4=BF=A1=E5=89=8D?= =?UTF-8?q?=E7=AB=AF=E5=BE=85=E5=8A=9E=E6=B8=85=E5=8D=95(=E6=88=91?= =?UTF-8?q?=E7=9A=84=E6=B6=88=E6=81=AF=E9=A1=B5404=E6=9C=AA=E5=BB=BA+?= =?UTF-8?q?=E9=80=89=E5=91=98=E5=B7=A5=E4=B8=8B=E6=8B=89=E6=9C=AA=E6=8E=A5?= =?UTF-8?q?=E7=BA=BF)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...单-我的消息页未建404+选员工下拉未接线-管理后台.md | 60 +++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 changelogs-v2/2026-06/05_3414_站内信前端待办清单-我的消息页未建404+选员工下拉未接线-管理后台.md diff --git a/changelogs-v2/2026-06/05_3414_站内信前端待办清单-我的消息页未建404+选员工下拉未接线-管理后台.md b/changelogs-v2/2026-06/05_3414_站内信前端待办清单-我的消息页未建404+选员工下拉未接线-管理后台.md new file mode 100644 index 0000000..58ebea6 --- /dev/null +++ b/changelogs-v2/2026-06/05_3414_站内信前端待办清单-我的消息页未建404+选员工下拉未接线-管理后台.md @@ -0,0 +1,60 @@ +# 【前端待办清单·管理后台】内部员工站内信：「我的消息」页未建(404) + 选员工下拉未接线 + +> **关联**: 工单 #3414（PR #3424/#3425/#3427） +> **服务**: 前端 hl-ui（**后端 100% 就绪、已部署测试服、API 实测通过，无任何后端待办**） +> **提报时间**: 2026-06-05 | **责任方**: mmg + +--- + +## ⚠️ 总览：后端全好，卡在两个前端待办 + +内部员工站内信后端完整交付（收件箱 API + SSE 实时 + 自定义推送选员工），但前端有 **2 处没做完**，导致功能用不起来。逐条实测定性如下，mmg 照清单勾： + +| # | 待办 | 现象（测试环境实测） | 缺什么 | +|---|------|---------|--------| +| 1 | **「我的消息」收件箱页** | 访问 `/notification/my-messages` → **404 页面不存在**；菜单树里通知中心下**没有「我的消息」菜单** | 菜单 + 路由 + 页面组件 + 顶部铃铛，**全没建** | +| 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=` + - 单条/全部已读 `PUT /admin/message/{id}/read`、`PUT /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 +- SSE 实时：`/ws/admin-msg/stream`（过网关 + nginx 实测收到事件）✅ +- 选员工：`/admin/notification/custom-push/admins` ✅ 实测返 20 员工 +- 发站内信：`POST /admin/notification/custom-push`（ADMIN_INAPP）✅ 实测落库 + SSE 推送 + +--- + +## 4. 关联 + +- 主功能 + 完整接口契约：`04_3414_内部员工站内信收件箱-SSE实时推送-管理后台.md` +- 选员工下拉 bug 详情：`05_3414_选择员工下拉无数据-前端未接searchAdmins接口-管理后台.md` +- 后端：@wx | 前端：**mmg**