hrz
5b0de039c9
* 让 CI 真正跑起三类测试并修掉挡路的测试缺陷 之前 CI 只跑了一小部分，Java 那边的测试被 pom 里的开关整个跳过了。 这条把它打开，并补上 MySQL、Redis 两个容器，Java、契约、Python 三类 测试都在 CI 里真跑起来。 另外修了两个挡路的地方：一条 Java 用例单跑会因为实体信息没注册而报错， 现在自己注册；Python 的假网络层把整个 httpx 类换掉了，第三方库拼请求 时报错，改成只换发请求那一步。 * 给 runner 补上 libopus，修掉音频用例报错 opuslib_next 是 ctypes 绑定，真正编解码靠系统里的 libopus。runner 上默认 没有，import 失败后测试里换上的是自己写的桩，桩里的编码器只有构造方法， 一调就报错。正式镜像里是装了这个库的，CI 少了这一步。 顺手把桩的报错改成一句人话，别再让人对着缺方法的报错猜根因。 * 本地没起库也能构建，CI 里集成测试不许跳过 三个要连 MySQL 和 Redis 的集成测试加了守卫：依赖连不上就整类跳过，日志写明缺什么，构建照样是绿的；CI 上依赖不通就直接失败。另外加了一个门禁检查脚本和 CI 步骤，盯住这三个类有没有真跑，守卫哪天手滑把它们全跳过了，CI 必须变红。README 里补了本地怎么起依赖、怎么只编译不跑测试。
本文档是开发类文档，如需部署小智服务端，点击这里查看部署教程
项目介绍
manager-api 该项目基于SpringBoot框架开发。
开发使用代码编辑器，导入项目时，选择manager-api文件夹作为项目目录
开发环境
JDK 21 Maven 3.8+ MySQL 8.0+ Redis 5.0+ Vue 3.x
接口文档
启动后打开：http://localhost:8002/xiaozhi/doc.html
跑测试
测试分两种：纯单元测试，和要真连 MySQL、Redis 的集成测试（DeviceTest、loginControllerTest、ModelConfigPersistenceTest）。
集成测试需要先起好 MySQL 8 和 Redis 8。没起的时候这类测试整类跳过，不会让构建变红，日志里会写明缺的是哪个依赖。CI 上不一样：依赖连不上就直接让构建失败，不许跳过，免得门禁被悄悄掏空。
本地用 Docker 起这两个依赖：
docker run -d --name xiaozhi-mysql -p 3306:3306 \
-e MYSQL_ROOT_PASSWORD=123456 -e MYSQL_DATABASE=xiaozhi_esp32_server mysql:8.0
docker run -d --name xiaozhi-redis -p 6379:6379 redis:8.0
跑全部测试：
mvn -B test -DskipTests=false
只想编译、不跑测试：
mvn -B package -DskipTests=true