docs(phase2e-2): 同步 Task 5/6 落地到总 API 索引 + 总 WS 协议 + 设计文档变更记录

- docs/api/README.md:frontend/meeting.md 状态从"📋 设计阶段"升为" Task 5/6",
  补全 12 REST + 13 WS 事件描述;目录结构表 meeting.md/notify.md 同步标记完成
- docs/api/websocket.md:会议信令章节从设计阶段草稿重写为事件总览表 + SSOT 引用
  (移除与 Task 6 实际实现不一致的旧事件名 meeting.member.mute/video/produce.stop
  /room.info/consume.resume;明确 C→S 白名单与 ACK/资源追踪约定)
- docs/plans/2026-04-21-phase2e-2-design.md:§十六 变更记录追加 Task 5 + Task 6
  两条偏离说明,完整记录事件合并/重命名/白名单/Redis 资源追踪等实施级决策

Made-with: Cursor
This commit is contained in:
bujinyuan
2026-04-21 17:14:14 +08:00
parent 096563d3ea
commit dfd9b6011c
3 changed files with 34 additions and 164 deletions

View File

@@ -1088,6 +1088,8 @@ TabBar 「我的」红点逻辑不变Phase 2e-1 已实现 `unreadTotal > 0`
| 日期 | 作者 | 变更内容 |
|---|---|---|
| 2026-04-21 | Agent | 首版落盘16 章节完整撰写16 章节含 4 mermaid 3 DDL1 REST API 清单11 项关键决策记录 |
| 2026-04-21 | Agent | Task 5 落地偏离记录`meeting_rooms.password` 字段改名为 `password_hash`bcrypt 哈希DAO `GetByID/GetByCode` `ErrRecordNotFound` 统一返回 `(nil, nil)`路径微调 `GET /rooms/mine` + `POST /invite-tokens/:token/redeem``kick` 请求体字段统一为 `user_id`而非 `target_user_id`新增 `MediaOrchestrator` 接口Task 5 Noop 占位Task 7 真实实现WS 广播 Task 5 阶段暂用 `PublishToUser` 循环Task 6 已替换为 `BroadcastToMeeting` |
| 2026-04-21 | Agent | Task 6 落地偏离记录:§6.3 11 事件扩展为 **13 事件**实际 16 含广播回包新增 `meeting.chat`REST 聊天广播+ `meeting.member.producer.new`produce.start / producer.close 的统一广播`meeting.member.mute` + `meeting.member.video` 合并为 `meeting.member.state.changed` `hand_raised` 举手字段 + `target_user_id` host 操作字段 + `actor_id``meeting.produce.stop` 重命名为 `meeting.producer.close``meeting.consume.resume` 暂时不落地Consumer 创建时 `paused=true`前端自己调 `/resume` 内部 REST`meeting.room.info` 不落地REST `/rooms/:code` 已覆盖CS 事件引入白名单常量 `MeetingWSClientEvents` 防伪造新增 Redis 资源追踪 `echo:meeting:resources:{room_id}:{user_id}`Set, TTL 1h用于 WS 断开时自动清理 mediasoup 资源新增 `MeetingBroadcaster` 统一广播层供 REST / WS 共用 |
---