- 修复: 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>
41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
# XH巡课
|
|
|
|
校园课堂直播、巡课和回放。Java 只在 Docker 里编译和运行,不要在 Windows 上安装 JDK。
|
|
|
|
## 本地开发(热更新预览)
|
|
|
|
```powershell
|
|
copy .env.example .env
|
|
docker compose --env-file .env up -d # 起后端、数据库、LiveKit、Egress、MinIO
|
|
docker compose stop web # 18088 改用 Vite 开发服务器
|
|
cd frontend
|
|
npm install
|
|
npm run dev # http://localhost:18088,改动即时生效
|
|
```
|
|
|
|
- 后端测试:`.\scripts\mvn.ps1 test`
|
|
- 前端测试:`cd frontend && npm test`
|
|
- API 验收:`.\scripts\acceptance.ps1`(建校、审核、开播、权限隔离)
|
|
- 浏览器端到端(真实推流+观看+录像+回放,需本机 Chrome):`node scripts\e2e-browser.mjs`
|
|
|
|
角色入口(登录后自动跳转):
|
|
|
|
- 管理端 `/admin`(超级管理员/学校管理员/巡课)
|
|
- 教师端 `/teacher`(选摄像头、麦克风,开播/停播)
|
|
- 家长端 `/parent`(绑定班级、看直播、看回放)
|
|
- 落地页 `/`,观看页 `/watch/:id`
|
|
|
|
## 生产构建
|
|
|
|
```powershell
|
|
docker compose --env-file .env up --build
|
|
```
|
|
|
|
网站入口 `http://localhost:18088`。初始管理员来自 `.env` 的 `ADMIN_USERNAME` / `ADMIN_PASSWORD`,示例口令只能用于本机;首次部署请更换全部密钥并把 `APP_PROD_GUARD` 设为 `true`。
|
|
|
|
## 注意事项
|
|
|
|
- 浏览器访问摄像头/麦克风必须用 `localhost`(或 HTTPS)这类安全上下文。
|
|
- 跨公网观看 WebRTC 时,需要把 LiveKit 的节点 IP、`rtc` 端口段和 TURN 配到学校网络,不能只开放一个 HTTPS 端口。
|
|
- 录像保存在 MinIO 私有桶,回放通过带权限校验的短期预签名链接访问,默认不提供下载。
|