# 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 私有桶,回放通过带权限校验的短期预签名链接访问,默认不提供下载。