63 行
4.0 KiB
Markdown
63 行
4.0 KiB
Markdown
# 【前端待办清单·管理后台】内部员工站内信：「我的消息」页未建(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=`
|
||
- 详情 `GET /admin/message/{id}`（🆕 深链/刷新/铃铛点击时按 ID 拉单条，返回完整 `content`/`link`；纯查询不改已读，不存在/越权返 code=200401「站内信不存在或无权访问」）
|
||
- 单条/全部已读 `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
|
||
- **🆕 单条详情：`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-push`（ADMIN_INAPP）✅ 实测落库 + SSE 推送
|
||
|
||
---
|
||
|
||
## 4. 关联
|
||
|
||
- 主功能 + 完整接口契约：`04_3414_内部员工站内信收件箱-SSE实时推送-管理后台.md`
|
||
- 选员工下拉 bug 详情：`05_3414_选择员工下拉无数据-前端未接searchAdmins接口-管理后台.md`
|
||
- 后端：@wx | 前端：**mmg**
|