EchoChat/.playwright-mcp/task16/scenarios/04-host-toolkit-and-transfer.md

场景 04：主持人四件套 + 宽限期自动转让

目标

• 验证 Task 15 主持人四件套：请他静音、请他开麦、转让主持人、踢出会议
• 验证 Task 8 host 宽限期状态机（P1-1 原子转让 + P1-7 处理锁）：
  • host 主动断开 WS → 宽限期内重连 → 撤销转让
  • host 宽限期到期 → 自动转让给最早加入的参会人
• 覆盖设计 §6.5（生命周期状态机）、§6.6（权限矩阵）

前置条件

依 ../README.md 通用前置；需 3 个账号 Alice/Bob/Carol 同时入会。

MCP 执行脚本 A：主持人四件套

步骤 1：三人入会

1. Alice 创建即时会议 → $ROOM_CODE
2. Bob 用会议号加入
3. Carol 用会议号加入
4. 截图 → 01-three-joined.png

步骤 2：Alice 请他静音 Bob

1. Alice tab 打开成员面板 → Bob 右侧 「⋯」 菜单 → 「请他静音」
2. Bob tab 期望：
   • Toast：「主持人已将你的麦克风关闭」
   • localAudioEnabled=false
   • 成员面板自己的 AV 图标变灰
3. Alice tab 期望：Bob 行 AV 图标变灰
4. 截图 → 02-bob-muted-by-host.png

步骤 3：Alice 请他开麦 Bob

1. Alice tab → Bob 「⋯」菜单 → 「请他开麦」
2. Bob tab 期望：
   • 弹窗请求确认「主持人请你开启麦克风，是否同意？」
   • 点「同意」后 localAudioEnabled=true
3. 截图 → 03-bob-ask-unmute.png

步骤 4：Alice 踢出 Carol

1. Alice tab → Carol 「⋯」菜单 → 「踢出会议」
2. 弹窗确认「踢出 Carol？」→ 确认
3. Carol tab 期望：
   • 收到 meeting.member.kicked 广播
   • Toast：「主持人已将你移出会议」
   • 跳回会议首页
4. Alice / Bob tab 期望：Carol 行从成员列表消失
5. 截图 → 04-carol-kicked.png

步骤 5：Alice 转让主持人给 Bob

1. Alice tab → Bob 「⋯」菜单 → 「转让主持人」
2. 弹窗确认 → 确认
3. 原子性验证（P1-1）：

   mysql -e "SELECT host_id, (SELECT role FROM meeting_participants WHERE room_id=r.id AND user_id=55) AS alice_role, \
             (SELECT role FROM meeting_participants WHERE room_id=r.id AND user_id=56) AS bob_role \
             FROM meeting_rooms r WHERE room_code='$ROOM_CODE'" echochat
   

   期望同时满足：host_id=56 + alice_role=participant + bob_role=host（同一事务原子更新）
4. Alice tab / Bob tab 工具栏切换（Alice 看到"结束会议"按钮消失，Bob 看到它出现）
5. 截图 → 05-host-transferred.png

MCP 执行脚本 B：宽限期自动转让

前置：接续场景 A 的会议；此时 Bob 是主持人，Alice 是参会人

步骤 6：Bob 断开 WS（模拟网络断开）

1. Bob tab DevTools → Network 面板 → Throttling 切换到 Offline
2. 等待 WS 心跳超时（~15s），Bob 客户端 _onWsDisconnected 触发
3. 期望 Redis 立即写入 echo:meeting:host_grace:$ROOM_CODE：

   redis-cli GET "echo:meeting:host_grace:$ROOM_CODE"
   # 期望：JSON {host_id:56, started_at:..., grace_until:...}
   redis-cli TTL "echo:meeting:host_grace:$ROOM_CODE"
   # 期望：约 120 秒（配置 `meeting.host_grace_seconds`）
   

4. Alice tab 期望：工具栏显示「主持人掉线中（宽限期 2:00）」倒计时（若 UI 已实现）

步骤 7a：宽限期内重连（撤销转让）

1. 15 秒后 Bob tab Network 恢复 Online
2. 期望 _onWsReconnected 触发，执行 OnHostReconnect：

   redis-cli EXISTS "echo:meeting:host_grace:$ROOM_CODE"
   # 期望：0（key 已 DEL）
   

3. Alice tab 工具栏倒计时消失
4. 查日志：

   tail -50 backend/go-service/logs/*.log | grep "host 宽限期内重连"
   # 期望：`host 宽限期内重连，撤销转让计划`
   

步骤 7b：宽限期到期（自动转让）

若步骤 7a 已执行，请先让 Bob 重新 Offline 并等待整个 120s 周期完成。

1. Bob tab Offline，保持 120+s
2. 期望本地 timer 到期触发 HandleHostGraceExpired：
   • Alice tab 收到 meeting.host.changed 广播，auto_reason='host_grace_expired'
   • 工具栏/成员面板 Alice 头像变为主持人标识
   • meeting_rooms.host_id=55 + meeting_participants.role 原子变更
3. 处理锁验证（P1-7）：

   # 宽限期到期瞬间抓一下处理锁
   redis-cli GET "echo:meeting:host_grace_handling:$ROOM_CODE"
   # 期望：`1`（SETNX 成功 60s TTL），60s 后自然过期
   

4. 截图 → 06-host-auto-transferred.png

步骤 8：清理

Alice（现任主持人）结束会议，走场景 01 的资源清理断言。

预期结果汇总

断言	预期
请他静音	Bob localAudioEnabled=false + toast
请他开麦	Bob 弹窗确认后 localAudioEnabled=true
踢出	Carol 跳首页 + 成员列表移除
主动转让原子性	host_id + 两行 role 同事务更新
host 宽限期 Redis	key 写入 + TTL≈120s
宽限内重连	key DEL + 本地 timer cancel
宽限到期自动转让	最早加入者成为新 host + 广播 host.changed
处理锁 SETNX	host_grace_handling:* 存在 60s

失败排查

现象	定位
转让后 host_id 和 role 不一致	P1-1 回归：检查 TransferHost 是否包在单事务
宽限到期但 host 不变	看 handling 锁是否被"自然过期 + DEL=0"误拦（P1-7 应已修）
多节点部署下双重转让	SETNX 处理锁应保证单节点唯一处理