Files
XH-XunKe/docs/IMPLEMENTATION_STATUS.md
T
xhgitandClaude Code ed55053b10 直播观看与录像链路真实验证通过,前端 UI 全面重做,分角色控制台
- 修复: LiveKit 回环候选生效(宿主机浏览器可直连推流)
- 修复: 回放预签名 URL 403(公开端点直接签名,SignedHeaders=host)
- 修复: 录像探针补 fileSize/durationSeconds
- 修复: 家长录像列表被权限过滤误伤为 0 条;教师/家长列表按角色精确隔离
- 修复: 巡课静音失效(LiveKit attach 强制 unmute,静音时不挂载音轨)
- 修复: 教室页自动请求摄像头/麦克风权限,分辨率失败自动降级
- 新增: 浏览器端到端验证脚本 scripts/e2e-browser.mjs(9 项断言全过:
  教师推流/家长观看含音频电平实测/巡课默认静音/Egress 录像双轨齐全/
  DPlayer 回放/录像权限隔离)
- 新增: /parent/today 家长今日课程表、网站 Logo 上传与公开读取
- UI 重做: 虎牙风直播播放器 + DPlayer 回放播放器(视觉统一)
- 分角色控制台: 管理端 /admin(16 模块)、教师端 /teacher、家长端 /parent
- 直播/录像列表返回班级、课程、教师名称与在线人数
- 18088 本地预览改为 Vite 热更新,README/实现状态文档同步更新

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-11-22 15:08:36 +08:00

3.7 KiB
Raw Blame History

实现状态

更新时间:2026-11-22

Java 不安装在宿主机。编译和测试使用 scripts/mvn.ps1,镜像是 maven:3.9.11-eclipse-temurin-21。

真实媒体链路已验证(scripts/e2e-browser.mjs,无头 Chrome + 虚拟设备)

2026-11-22 用真实浏览器跑通完整链路,8 项断言全部通过:

  1. 教师端自动请求摄像头/麦克风权限,设备独立枚举。
  2. 教师从浏览器把 720p 视频 + 音频推到 LiveKit,会话进入 LIVE。
  3. 家长端收到 1280x720 画面(解码 300+ 帧)并实测到远程音频电平(RMS 25)。
  4. 巡课页多教室同时拉流,默认全部静音,点选一间才出声。
  5. 管理后台概览显示真实统计与服务状态。
  6. 结束直播后 Egress 生成 MP4 到 MinIO,ffprobe 探针确认 h264 视频轨 + aac 音频轨齐全(如 6.8MB / 44s)。
  7. 回放地址(公开端点预签名)浏览器可直连播放。
  8. 回放页用 DPlayer 播放,1280px 画面正常。

说明:以上为虚拟设备测试。真实摄像头、真实麦克风和希沃一体机的兼容性仍需在实机上验证,未验证前不得宣称通过。

本次修复的问题

  • 回放地址 403:MinIO 预签名之前用内部端点签名后改写主机,SignedHeaders=host 使签名失效。改为用公开端点客户端直接签名(客户端显式设置 region,签名过程不再访问服务器)。
  • 录像 fileSize/durationSeconds 为空:探针补 -show_format 并回写对象大小。
  • 巡课/观看静音失效:LiveKit SDK attach 会强制 element.muted=false,改为静音时不挂载音轨、取消静音时再挂载。
  • 教室页不弹权限询问:进入教室页自动 getUserMedia 请求权限并枚举设备,分辨率默认“自动”,指定分辨率失败自动降级。
  • SMTP 支持免认证服务器(本地 MailHog 联调用)。
  • 直播列表/详情、录像列表返回班级、课程、教师名称与在线人数。
  • 家长首页:今日课程表接口 /parent/today(含节次时间与进行中状态)。
  • 网站 Logo 上传(/admin/site-logo)与公开读取(/api/public/site-logo)。
  • 订阅端身份唯一化(u-{id}-watch-{nano}),同一家长多端观看互不挤下线;撤销绑定时按前缀移除全部观看会话。

前端结构(2026-11-22 重做)

  • 角色控制台:管理员 /admin、教师 /teacher、家长 /parent、巡课 /inspect,登录后按角色跳转,/ 为落地页。
  • 播放器:回放用 DPlayer(样式内置 src/assets/dplayer.css),直播用自定义虎牙风播放器 components/LivePlayer.vue,两套控制条视觉一致。
  • 管理后台拆分为 views/admin/* 16 个模块:概览/学校/年级/班级/课程/课表/用户/绑定审核/直播/录像/巡课记录/邮件短信/通知模板/存储/日志/系统设置(网站、Logo、注册审核、安全、节次、服务状态)。
  • 主题:浅色/深色跟随站点设置,用户可本机覆盖(localStorage),主题色后台可改并同步到 Element Plus 主色。

本地开发预览

docker compose stop web        # 停掉静态容器
cd frontend
npm run dev                    # 18088,改动即时热更新,API 代理到 8080

生产镜像仍是 docker compose up -d --build web(静态构建,nginx 托管)。

尚未验证

  • 阿里云、腾讯云短信和真实 SMTP 只完成协议实现,未用真实密钥发送。
  • 压力测试只测过 50 并发的公开接口,未做 100/300 路观看的直播压测。
  • 真实摄像头/麦克风/希沃一体机设备兼容性未在实机验证。
  • 站内消息收件箱(用户端通知列表)尚未实现。
  • 直播趋势图等历史统计曲线需要后端新增聚合接口,目前概览只有当前计数。