直播观看与录像链路真实验证通过,前端 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>
This commit is contained in:
xhgitandClaude Code committed 2026-11-22 15:08:36 +08:00
1 parent 0afc29d431
commit ed55053b10
66 files changed
+7048 -1028

No files matched your search

+49 -16
View File
@@ -1,24 +1,57 @@
# 实现状态
更新时间:2026-11-21
更新时间:2026-11-22
Java 不安装在宿主机。编译和测试使用 `scripts/mvn.ps1`,镜像是 `maven:3.9.11-eclipse-temurin-21`。
## 已完成并通过测试
## 真实媒体链路已验证(scripts/e2e-browser.mjs,无头 Chrome + 虚拟设备)
- Spring Boot 3.5.16 / Java 21 后端可在 Docker 中编译。
- 单元测试 `PolicyTest` 7 项通过:密码策略、公开注册只能成为待审核家长、直播房间隔离、家长不能推流、直播/回放授权分开、家长不能管理学校、录像探针必须同时有音视频、密钥可加密往返。
- 前端设备拆分测试 1 项通过,`vue-tsc` 与生产构建通过。
- Docker Compose 已在本机启动。验收脚本走通建校、教师、待审核家长、只批直播、开播前拒绝播放、确认后订阅、停播和关闭注册。
- 管理后台概览读到真实计数:用户 5、家长 1、教师 2、班级 2、今日直播 1。状态页显示 LiveKit 和对象存储可连接。
- 浏览器登录后站点名来自接口。教室页点击允许摄像头后,视频列表出现 `5MP USB webcam` 和 `OBS Virtual Camera`,音频列表单独出现 USB 麦克风,没有混成一个设备框。
- 家长首页按学校和班级名称申请绑定,并可修改密码。登录页可以找回密码。
- 巡课页对每间正在直播的教室单独拉流,默认静音,点开一间才出声。
- 管理端补了节次、通知模板和登录锁定设置。回放按班级名称筛选。
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 画面正常。
- 这次验收没有从浏览器把画面推进 LiveKit。确认开播后录像任务失败 1 次,没有生成可播放文件。
- 教室页预览已经显示出本机 USB 摄像头画面。还没有把这路画面推进 LiveKit,也没有生成可播放录像。
- 阿里云、腾讯云短信和 SMTP 只完成了协议实现,没有使用真实密钥发送。
- 只测量了 50 个并发的公开站点接口,不能宣称支持 300 路观看。
说明:以上为**虚拟设备测试**。真实摄像头、真实麦克风和希沃一体机的兼容性仍需在实机上验证,未验证前不得宣称通过。
## 本次修复的问题
- 回放地址 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 主色。
## 本地开发预览
```powershell
docker compose stop web # 停掉静态容器
cd frontend
npm run dev # 18088,改动即时热更新,API 代理到 8080
```
生产镜像仍是 `docker compose up -d --build web`(静态构建,nginx 托管)。
## 尚未验证
- 阿里云、腾讯云短信和真实 SMTP 只完成协议实现,未用真实密钥发送。
- 压力测试只测过 50 并发的公开接口,未做 100/300 路观看的直播压测。
- 真实摄像头/麦克风/希沃一体机设备兼容性未在实机验证。
- 站内消息收件箱(用户端通知列表)尚未实现。
- 直播趋势图等历史统计曲线需要后端新增聚合接口,目前概览只有当前计数。