# small-project **Repository Path**: xinglanget/small-project ## Basic Information - **Project Name**: small-project - **Description**: No description available - **Primary Language**: Java - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-15 - **Last Updated**: 2026-11-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 宿舍管理系统 面向在校学生场景的宿舍管理系统:**Spring Boot 后端 + Swing 桌面客户端**,内置演示数据,开箱即用。 ## 功能 | 模块 | 说明 | | --- | --- | | 人员管理 | 学生档案(学号/学院/专业/班级/辅导员等)、入住/退宿办理(自动校验床位与性别)、搜索 | | 宿舍管理 | 楼栋、宿舍(床位/类型/启用停用)、入住成员查看 | | 水电管理 | 按房间按月抄表,自动按「本期-上期」用量 × 单价生成水/电账单,缴费标记,单价可配置 | | 维修管理 | 学生报修 → 管理员指派维修人员 → 维修完成 → 学生评价 的完整闭环 | | 大屏统计 | 入住率、楼栋入住对比、报修状态分布、近 6 月水电趋势、账单缴费情况、最新工单 | | 账号权限 | 管理员 / 学生 / 维修人员 三种角色,会话登录,接口级权限控制 | ## 技术栈 - 后端:Spring Boot 3.3 / Spring Security / Spring Data JPA / **MySQL 8**(本地免安装二进制包运行,库 `dorm`,用户 `dorm/dorm123`) - 客户端:Java Swing + FlatLaf 外观;大屏为独立 JavaFX 窗口内嵌 WebView 渲染 ECharts - 构建:Maven 多模块(`server` / `client`),JDK 17+ ## 快速开始(Windows) 已适配 Windows 的启动脚本(`.sh` 为 macOS 版,保留不动): ```bat start-mysql.bat :: 准备 MySQL:检查服务、创建 dorm_app 库与 dorm/dorm123 账号(需输入 root 密码) start-server.bat :: 启动后端 http://localhost:8080(jar 不存在时自动构建) start-client.bat :: 启动 Swing 客户端,可加 --demo / --dashboard / --smoke 等参数 ``` 要点: - 工具链在 `.tools/` 内(Temurin JDK 21 + Maven 3.9),脚本自动探测并优先使用;系统未装 JDK 21 时也能跑。**不要用 JDK 25 构建**,Lombok/ByteBuddy 不兼容会失败。 - 数据库用本机已安装的 MySQL 8 服务(非内嵌二进制包)。Windows 侧库名是 `dorm_app`,由 `start-server.bat` 以 `--spring.datasource.url` 参数注入;`application.yml` 保持原样(默认 `dorm`),所以 macOS 流程完全不受影响,两边数据互不干扰。 - `start-server.bat --build` 可强制重新构建;`start-client.bat --smoke` 是不开界面的连通性测试。 - `.tools/bat-src/` 存放脚本的 UTF-8 源码,改完执行 `python .tools/make_bats.py` 重新生成根目录的 GBK 编码 bat(cmd 只按 GBK 正确解析中文)。 ## 快速开始(macOS,原有流程) ```bash ./start-mysql.sh # 终端 0:启动本地 MySQL(首次自动初始化,幂等) ./start-server.sh # 终端 1:启动后端(http://localhost:8080,会自动确保 MySQL 就绪) ./start-client.sh # 终端 2:启动 Swing 客户端 ``` 首次运行会自动构建。也可以手动构建后运行: ```bash mvn -DskipTests package java -jar server/target/dorm-server.jar java -jar client/target/dorm-client.jar ``` 客户端参数:`--server=http://主机:8080` 指定后端地址;`--demo` 免输入直接以管理员登录;`--dashboard` 登录后自动打开大屏。 ## 默认账号(首次启动自动初始化演示数据) | 角色 | 用户名 | 密码 | | --- | --- | --- | | 管理员 | admin | admin123 | | 维修人员 | repair / repair2 | 123456 | | 学生 | 2024001 ~ 2024006 | 123456 | 演示数据:3 栋楼、36 间宿舍、80 名学生、近 6 个月抄表与账单、12 条报修工单。 重置数据:停止后端,清空 MySQL 的 `dorm` 库(`DROP DATABASE dorm;`)再启动,后端会自动重建表并灌入演示数据。 ## 验证 ```bash python3 scripts/test_api.py # 后端 27 项接口冒烟测试(登录/CRUD/抄表算费/缴费/报修闭环/权限) java -jar client/target/dorm-client.jar --smoke # 客户端连通性冒烟测试 java -jar client/target/dorm-client.jar --snapshot=/tmp/dash.png --snapshot-main=/tmp/main.png # 界面离屏快照 ``` ## 说明 - 大屏窗口基于 JavaFX 21(JavaFX 17 在较新 macOS 上有原生崩溃问题);若 JavaFX 不可用会自动改用系统浏览器打开同一页面。 - 抄表首期用量按 0 计(无上期读数),之后自动与上期读数差值算费;修改某月抄表会重新生成该月账单。 - 数据库连接:`jdbc:mysql://127.0.0.1:3306/dorm`,用户 `dorm`,密码 `dorm123`,可用任意 MySQL 客户端连接查看。 - 本地 MySQL 为免安装二进制包(8.0.28),运行时在 `/Users/mac/mysql-dorm`(数据 `data/`、日志 `mysqld.log`、socket `/tmp/mysql-dorm.sock`),由 `start-mysql.sh` 初始化并启动。如需改用其它 MySQL,修改 `server/src/main/resources/application.yml` 的 `spring.datasource` 即可。 ## 在其它电脑部署 仓库附带数据库 SQL,目标机器装好 MySQL 后手动导入即可: ```bash mysql -u root -p < sql/schema.sql # 建库 + 建表 mysql -u root -p < sql/data.sql # 演示数据 ``` 再按需修改 `application.yml` 的数据源账号,构建并启动后端/客户端。详见 [sql/README.md](sql/README.md)。