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

58 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 实现状态
更新时间: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 主色。
## 本地开发预览
```powershell
docker compose stop web # 停掉静态容器
cd frontend
npm run dev # 18088,改动即时热更新,API 代理到 8080
```
生产镜像仍是 `docker compose up -d --build web`(静态构建,nginx 托管)。
## 尚未验证
- 阿里云、腾讯云短信和真实 SMTP 只完成协议实现,未用真实密钥发送。
- 压力测试只测过 50 并发的公开接口,未做 100/300 路观看的直播压测。
- 真实摄像头/麦克风/希沃一体机设备兼容性未在实机验证。
- 站内消息收件箱(用户端通知列表)尚未实现。
- 直播趋势图等历史统计曲线需要后端新增聚合接口,目前概览只有当前计数。