2026-11-21 04:28:32 +00:00

XH巡课

校园课堂直播、巡课和回放。Java 只在 Docker 里编译和运行,不要在 Windows 上安装 JDK。

本地开发(热更新预览)

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

生产构建

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 私有桶,回放通过带权限校验的短期预签名链接访问,默认不提供下载。
S
Description
No description provided
Readme GPL-3.0
395 KiB
1 Stars 1 Watchers 0 Forks
Generate repository badges
Languages
Java 46.6%
Vue 42.9%
JavaScript 4.6%
CSS 2.3%
TypeScript 2%
Other 1.5%