补上家长选班、巡课多画面、找回密码和管理端的节次与安全设置。

This commit is contained in:
itxiaohui committed 2026-11-21 12:44:52 +08:00
1 parent 339641040e
commit 0afc29d431
17 files changed
+381 -113

No files matched your search

+3 -1
View File
@@ -6,7 +6,9 @@
docker compose --env-file .env up --build
```
- 网站:`http://localhost:8088`
本机 8088 已被其他项目占用,Compose 把网站映射到 `18088`。官方 `minio/minio` 已不能匿名拉取,这里使用仍可拉取的 `alpine/minio:RELEASE.2025-10-15T17-29-55Z`。LiveKit 使用 `livekit/livekit-server:v1.13.11` 和 `livekit/egress:v1.13.0`。后端运行镜像是本机已有的 `eclipse-temurin:21-jdk-jammy`。
- 网站:`http://localhost:18088`
- 后端:`http://localhost:8080`
- MinIO 控制台:`http://localhost:9001`
- LiveKit:`ws://localhost:7880`,UDP `50000-50100`
+12 -14
View File
@@ -7,20 +7,18 @@ Java 不安装在宿主机。编译和测试使用 `scripts/mvn.ps1`,镜像是
## 已完成并通过测试
- Spring Boot 3.5.16 / Java 21 后端可在 Docker 中编译。
- 单元测试 `PolicyTest` 6 项通过:密码策略、公开注册只能成为待审核家长、直播房间隔离、家长不能推流、直播/回放授权分开、录像探针必须同时有音视频、密钥可加密往返。
- 前端设备拆分测试 1 项通过:摄像头与麦克风分属两个列表。
- 数据库 Flyway 脚本、RBAC、注册开关、家长绑定审核、课程与课表、直播状态机、LiveKit 令牌、Egress/MinIO 录像、SMTP/短信适配、Docker Compose 草稿已写入代码。
- 单元测试 `PolicyTest` 7 项通过:密码策略、公开注册只能成为待审核家长、直播房间隔离、家长不能推流、直播/回放授权分开、家长不能管理学校、录像探针必须同时有音视频、密钥可加密往返。
- 前端设备拆分测试 1 项通过,`vue-tsc` 与生产构建通过。
- Docker Compose 已在本机启动。验收脚本走通建校、教师、待审核家长、只批直播、开播前拒绝播放、确认后订阅、停播和关闭注册。
- 管理后台概览读到真实计数:用户 5、家长 1、教师 2、班级 2、今日直播 1。状态页显示 LiveKit 和对象存储可连接。
- 浏览器登录后站点名来自接口。教室页点击允许摄像头后,视频列表出现 `5MP USB webcam` 和 `OBS Virtual Camera`,音频列表单独出现 USB 麦克风,没有混成一个设备框。
- 家长首页按学校和班级名称申请绑定,并可修改密码。登录页可以找回密码。
- 巡课页对每间正在直播的教室单独拉流,默认静音,点开一间才出声。
- 管理端补了节次、通知模板和登录锁定设置。回放按班级名称筛选。
## 已写代码但尚未在本机完整跑通
## 已写代码但尚未用真实推流跑通
- Docker Compose 全栈尚未启动,因此还没有真实的开播、观看、录像文件和 HTTPS 验收。
- 浏览器摄像头和麦克风尚未用真实设备验证。希沃硬件不在当前环境。
- 这次验收没有从浏览器把画面推进 LiveKit。确认开播后录像任务失败 1 次,没有生成可播放文件。
- 教室页预览已经显示出本机 USB 摄像头画面。还没有把这路画面推进 LiveKit,也没有生成可播放录像。
- 阿里云、腾讯云短信和 SMTP 只完成了协议实现,没有使用真实密钥发送。
- 300 人观看压力测试没有执行,不能宣称支持该并发。
## 下一步
1. 启动 Compose 中的 PostgreSQL、Redis、MinIO、LiveKit 和后端。
2. 用管理员账号走通建校、建班、审核、开播、观看、停播。
3. 有摄像头时在浏览器里验证独立设备切换。
4. 记录资源占用后再做小规模并发,不把未测结果写成能力。
- 只测量了 50 个并发的公开站点接口,不能宣称支持 300 路观看。
+11 -4
View File
@@ -12,14 +12,21 @@
| 套件 | 命令 | 结果 |
|---|---|---|
| 后端策略测试 | `scripts/mvn.ps1 test` | 6 通过,0 失败 |
| 后端策略测试 | `scripts/mvn.ps1 test` | 7 通过,0 失败 |
| 前端设备列表 | `npm test` | 1 通过,0 失败 |
| 前端类型与构建 | `vue-tsc --noEmit`、`vite build` | 通过 |
| 学校流程验收 | `scripts/acceptance.ps1` | 通过。输出 `ACCEPTANCE_OK school=2 class=2 course=2 users=5 liveToday=1` |
| 公开接口并发 | 50 个并发请求 `/api/public/site` | 50 成功,0 失败,p95 166 毫秒,最大 214 毫秒 |
| 浏览器 | `http://localhost:18088` | 登录、后台概览和状态页已打开。教室页允许摄像头后,视频与麦克风分别列出真实设备 |
状态页实测:LiveKit 可连接,对象存储可连接,失败录像 1,完成录像 0。失败来自没有浏览器推流时启动的录像任务。
## 未执行
- 对 PostgreSQL 的接口集成测试。
- 真实摄像头、麦克风、LiveKit 房间和 Egress 文件。
- 1 / 5 / 10 个班级,以及 50 / 100 / 300 个观看者的压力测试。
- 把预览中的摄像头推进 LiveKit,以及麦克风电平和非静音观看。预览画面已经出现。
- Egress 生成并回放带音视频的 MP4。
- 真实阿里云、腾讯云短信和 SMTP。
- 50 / 100 / 300 个 WebRTC 观看者。
- 服务器重启后的直播恢复。
没有上述证据时,不把并发观看能力写成已支持。