‹ 全部项目

全栈系统

宿舍管理系统

面向高校宿舍运营的 Web 应用:不超额的床位分配、调换宿舍,以及保留完整修改记录的缺勤管理。

时间
2024.12
技术栈
  • Java 17
  • Spring Boot
  • Spring Security
  • MySQL
  • Flyway
  • Docker
  • Playwright
01 / 04角色
管理员总览:空余床位、各楼入住率与近期缺勤按楼栋政策显示各房间分配情况的房间列表宿管员缺勤记录,含一条已更正和一条已撤销的记录带住宿状态与筛选条件的学生列表
  1. 01 · 角色

    两个工作台,一套规则。

    管理员管理楼栋、房间、学生与员工账号,办理入住、调换宿舍与退宿;宿管员为其负责的楼栋登记和更正缺勤记录。

  2. 02 · 分配

    不超额,也不死锁。

    入住、调换与楼栋政策变更都按固定顺序加行锁——先学生、再房间、最后楼栋——两个争抢最后一张床位的请求不可能同时成功,各条路径也不会死锁。楼栋可设为混住、仅女生或仅男生,系统只提供符合条件的房间。

  3. 03 · 记录

    每一次修改都有据可查。

    调换宿舍在同一事务中结束旧的入住记录并开启新记录,失败时原分配保持不变;缺勤的更正与撤销会记录修改人和修改时间,日期按宿舍所在时区计算。

  4. 04 · 交付

    每一层都经过验证。

    集成测试同时在 H2 与(通过 Testcontainers)MySQL 8.4 上运行,并有覆盖率门禁与 OpenAPI 契约测试;Playwright 驱动打包后的应用,CI 部署 Docker Compose 环境并做冒烟测试,发布时自动推送镜像。会话登录配合 CSRF 防护、BCrypt 与按楼栋的权限检查保护数据。

关键结果

90%

CI 中的行覆盖率门禁(分支覆盖率 70%),并通过 Testcontainers 在 MySQL 8.4 上运行集成测试。