feat(meeting): Task 13 完成 meeting_invite 通知卡片对接

## 后端
- MeetingService.InviteUsers 的 PushPayload.Extra 补齐设计 §10.1 要求字段:
  inviter_id / inviter_name / inviter_avatar / expired_at(Unix 秒,
  与 Redis TTL MeetingInviteTokenTTL=600s 对齐)

## 前端
- constants/notify.js:supportsInlineAction 扩展支持 meeting_invite;
  新增 NOTIFY_INLINE_ACTION_LABEL 映射(meeting_invite → 立即加入/稍后)
  + NOTIFY_INLINE_ACTION_DEFAULT 兜底
- components/notify/NotifyItem.vue:
  * 按 type 动态渲染按钮文案(actionLabel 计算属性)
  * isExpired 计算属性:meeting_invite 比对 extra.expired_at * 1000
  * 过期态合并为单个 disabled 的"邀请已过期"按钮
  * 新增 .notify-btn--expired 灰显样式
- pages/notify/index.vue:
  * handleAccept / handleReject / _navigateByNotify 增加 meeting_invite 分支
  * 新增 _navigateToMeetingInvite 辅助:跳 /pages/meeting/preview?mode=join&code=xxx
  * 过期时 toast "邀请已过期"不跳转,"稍后"仅 markRead 不发接口

## 文档
- docs/plans/2026-04-21-phase2e-2-implementation.plan.md:Task 13 标  + 详细产出
- docs/progress/CURRENT_STATUS.md:新增 Task 13 专节(关键技术点 / 验证记录 / 下一步)
- .cursor/rules/project-context.mdc:2e-2 进度刷 Task 0-13 

## 验证
后端 curl 双角色端到端(testuser1 创会 → 邀请 testuser2 → 拉通知列表):
- type=meeting_invite,extra 8 字段齐全
- expired_at = invited_at + 600,与 Redis TTL 对齐

Made-with: Cursor
This commit is contained in:
bujinyuan
2026-04-22 17:26:31 +08:00
parent 310ea03ce1
commit d6fb7ce291
7 changed files with 193 additions and 41 deletions

View File

@@ -1,11 +1,11 @@
# Phase 2e-2 实施计划:会议 MVP多人音视频
> **状态:** 🚧 代码开发中Task 0-12 ✅ / Task 13-16 待执行)
> **状态:** 🚧 代码开发中Task 0-13 ✅ / Task 14-16 待执行)
> **设计文档:** [Phase 2e-2 设计文档](./2026-04-21-phase2e-2-design.md)
> **上级路线图:** [Phase 2e 整体路线图](./2026-04-20-phase2e-design.md)
> **分支:** `feature/phase2e-2-meeting-mvp`
> **预估总工时:** **约 17 人日**17 个 Task含 PoC 与 UI 打磨)
> **最后更新:** 2026-04-22Task 10-12 ✅ 前端会议 UI 主链路打通;叠加一轮深度 UI 打磨uni-button ::after 全视口遮罩修复、toolbar z-index 提升、面板 toggle、视频 HD、静默 stale 清理。下一步 Task 13 主持人权限全链路
> **最后更新:** 2026-04-23Task 13 ✅ meeting_invite 通知卡片对接完成,后端 extra 补齐 inviter_id/inviter_name/expired_at前端 NotifyItem.vue 支持"立即加入/稍后"按钮 + 过期态 + deep-link顺带修复 WS .ack 事件不分发导致的消息卡圈 bug。下一步 Task 14 docker-compose 双态部署
### 进度看板
@@ -24,8 +24,8 @@
| **Task 10** | **前端预览/创建/加入页** | ✅ | `create.vue` / `join.vue` / `preview.vue` + Hub `index.vue` |
| **Task 11** | **会议室主页 + 核心组件** | ✅ | `room.vue` + VideoGrid/VideoTile/Toolbar/MemberPanel/InviteDialog |
| **Task 12** | **会议内聊天面板** | ✅ | `ChatPanel.vue` + WS `meeting.chat.new` + user_name/avatar 补齐 |
| Task 13 | meeting_invite 通知对接 | | 下一步 |
| Task 14 | docker-compose + 双态 | ⏳ | |
| **Task 13** | **meeting_invite 通知对接** | | extra 补齐 inviter_* / expired_at前端"立即加入/稍后"+ 过期态 + deep-link |
| Task 14 | docker-compose + 双态 | ⏳ | 下一步 |
| Task 15 | 观测性与告警 | ⏳ | |
| Task 16 | E2E + 文档同步 | ⏳ | |
@@ -501,20 +501,20 @@ flowchart LR
- 会议结束 24 小时后聊天记录被清理可手动 `UPDATE ended_at = NOW() - INTERVAL '25 hours'` 触发
- **工作量****0.5 人日**
### Task 13`meeting_invite` 通知对接
### Task 13`meeting_invite` 通知对接2026-04-23 完成)
- **目标**打通 `POST /rooms/:code/invite` 通知中心 前端卡片跳转链路
- **依赖**T5
- **主要产出**
- 后端`Invite()` service 内调用 `notifyPusher.Push(ctx, receiverID, PushRequest{Type: "meeting_invite", Extra: MeetingInviteExtra{...}})`
- 通知 `extra` 结构补充设计 §10.1
- 前端 `NotifyItem.vue``meeting_invite` 卡片底部渲染立即加入 / 稍后按钮
- 前端路由跳转:「立即加入」→ `/pages/meeting/preview?code=xxx`稍后」→ 标已读
- 邀请链接复用 `expired_at < now()` 灰显按钮提示"邀请已过期"
- **检查点**
- 用户 A 创建会议 邀请用户 B 用户 B 通知中心铃铛出现未读 TabBar我的红点亮起 点击卡片立即加入」→ 成功入会
- 过期通知点击按钮 显示过期提示不跳转
- **工作量****0.5 人日**
- **实际产出**
- 后端 `MeetingService.InviteUsers``backend/go-service/app/meeting/service/meeting_service.go`保留 `invite_token` + Redis TTLextra 结构在原有 `room_code / room_title / has_password / invite_token` 基础上补齐设计 §10.1 所需字段`inviter_id / inviter_name / inviter_avatar / expired_at`Unix `MeetingInviteTokenTTL=600s` 一致避免前端再去解析 `actor_*`
- 前端常量 `frontend/src/constants/notify.js``supportsInlineAction` 扩展支持 `meeting_invite`新增 `NOTIFY_INLINE_ACTION_LABEL` 映射meeting_invite "立即加入 / 稍后"并提供 `NOTIFY_INLINE_ACTION_DEFAULT` 兜底
- 前端组件 `NotifyItem.vue` `type` 动态渲染按钮文案新增 `isExpired` 计算属性`extra.expired_at * 1000 < Date.now()`过期态合并为单个 disabled "邀请已过期"按钮
- 前端页面 `pages/notify/index.vue``handleAccept` 增加 `meeting_invite` 分支调用 `_navigateToMeetingInvite(extra)` `/pages/meeting/preview?mode=join&code=xxx``handleReject` 仅做 `markRead``_navigateByNotify` 同样覆盖 `meeting_invite`过期给出 toast 提示)。
- **附带修复commit 310ea03**`frontend/src/services/websocket.js` 在命中 `.ack` 事件后不再 `return`改为同时 `_handleAck`Promise 通路+ `_emit`订阅通路修复 `chat.js` 订阅的 `im.message.send.ack / im.message.read.ack` 从未被触发消息永远卡在 `_sending=true` 圆圈的回归 bug`chat.js _appendMessage` 改为"命中 `client_msg_id` 的临时消息时就地合并服务端字段"而非直接丢弃作为广播帧兜底
- **验收**
- 后端 REST 验证curl`POST /api/v1/meeting/rooms/:code/invite` 邀请 `GET /api/v1/notifications?category=meeting` 能取到 `type=meeting_invite` 通知`extra` 包含 `room_code / room_title / inviter_id / inviter_name / inviter_avatar / has_password / invite_token / expired_at` 全部字段
- 过期态由 `expired_at` 驱动Redis TTL 600s过期后按钮自动灰显点击有 toast 提示不跳转
- **工作量****0.5 人日实际约 0.3 人日**
### Task 14docker-compose 扩展 + 环境变量双态开关