--- description: XH巡课架构、代码规范与虚拟 Java 环境 alwaysApply: true --- # XH巡课核心规则 - 项目是校园直播、巡课、回放的前后端分离网站。默认名称「XH巡课」,页面名称只读站点配置。 - 技术栈:Vue 3 + TypeScript + Vite;Java 21 + Spring Boot 3.5;PostgreSQL、Redis、LiveKit、MinIO。 - **禁止在宿主机安装 JDK 或修改系统 PATH。** Java 只存在于 Docker 镜像中。编译和测试用 `scripts/mvn.ps1`,运行用 `docker compose`。 - 分层:Controller 只做入参和响应,业务在 Service,数据访问在 Repository。 - 新功能必须接到现有权限模型。注册账号只能是家长,不能自动获得直播权限。 - 关键业务数据进 PostgreSQL。Redis 只放验证码、刷新令牌、限流、短缓存和在线状态。 - 不要提交密钥。本地口令只写在 `.env.example`,并标明必须更换。 - 完成一个模块后更新 `docs/IMPLEMENTATION_STATUS.md`。未跑通的功能不能标成完成。 - 改代码前先看真实文件。不要覆盖无关改动,不要删用户数据。