技术栈设计

后端技术栈

• Spring Boot 2.7.x：核心框架，提供快速开发能力。
• Spring Security：负责权限认证与授权。
• MyBatis-Plus：简化数据库操作，支持CRUD封装。
• Redis：缓存教室状态、用户会话等高频数据。
• MySQL 8.0：主数据库，存储教室、用户、预约等结构化数据。
• Swagger/Knife4j：生成API文档，便于前后端联调。

前端技术栈

• Vue 3 + Composition API：前端框架，实现响应式界面。
• Element Plus：UI组件库，提供表格、表单等基础组件。
• Axios：处理HTTP请求，与后端交互。
• Vue Router：管理前端路由，支持动态权限路由。
• ECharts：可视化教室使用率、预约统计等数据。

---

功能模块设计

1. 教室管理模块

• 基础信息管理：教室编号、位置、容量、设备类型（多媒体/实验室）等字段维护。
• 状态实时更新：通过WebSocket推送教室占用/空闲状态。

2. 预约管理模块

• 预约规则：支持按课时、日期范围预约，冲突检测（同一教室同一时间不可重复预约）。
• 审批流程：教师预约自动通过，学生需管理员审核。

3. 用户权限模块

• RBAC模型：角色分为管理员、教师、学生，权限粒度细化到按钮级别。
• JWT认证：前端存储Token，后端校验权限。

4. 统计报表模块

• 数据看板：按日/周/月统计教室使用率、预约成功率。
• 导出功能：支持Excel、PDF格式导出报表。

---

数据库设计（关键表）

1. 教室表（classroom）

CREATE TABLE `classroom` (
  `id` int NOT NULL AUTO_INCREMENT,
  `room_no` varchar(20) NOT NULL COMMENT '教室编号',
  `building` varchar(50) NOT NULL COMMENT '所属楼栋',
  `capacity` int DEFAULT NULL COMMENT '容纳人数',
  `equipment_type` enum('MULTIMEDIA','LAB','BASIC') DEFAULT 'BASIC',
  `status` tinyint(1) DEFAULT '0' COMMENT '0空闲 1占用',
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_room_no` (`room_no`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

2. 预约记录表（reservation）

CREATE TABLE `reservation` (
  `id` int NOT NULL AUTO_INCREMENT,
  `user_id` int NOT NULL COMMENT '预约人ID',
  `classroom_id` int NOT NULL COMMENT '教室ID',
  `start_time` datetime NOT NULL COMMENT '开始时间',
  `end_time` datetime NOT NULL COMMENT '结束时间',
  `status` enum('PENDING','APPROVED','REJECTED') DEFAULT 'PENDING',
  `reason` varchar(255) DEFAULT NULL COMMENT '用途说明',
  PRIMARY KEY (`id`),
  KEY `idx_user` (`user_id`),
  KEY `idx_time_range` (`start_time`,`end_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3. 用户表（user）

CREATE TABLE `user` (
  `id` int NOT NULL AUTO_INCREMENT,
  `username` varchar(50) NOT NULL COMMENT '学工号',
  `password` varchar(100) NOT NULL COMMENT '加密存储',
  `role` enum('ADMIN','TEACHER','STUDENT') NOT NULL,
  `real_name` varchar(50) DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_username` (`username`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

---

系统测试设计

1. 单元测试

• 使用JUnit 5 + Mockito测试Service层逻辑，如预约冲突检测、权限校验。
• 覆盖率要求：核心业务方法覆盖率≥80%。

2. API测试

• Postman自动化测试集：覆盖所有RESTful接口，包括异常场景（如未授权访问、参数缺失）。

3. 前端测试

• Jest + Vue Test Utils：组件渲染测试、Axios请求模拟。
• Cypress：端到端测试关键流程（如登录→预约→取消）。

4. 性能测试

• JMeter模拟高并发场景：1000+用户同时查询教室列表，响应时间≤500ms。

---

源码结构示例（后端）

src/main/java
├── com.example.classroom
│   ├── config       # 安全、Swagger配置
│   ├── controller   # 暴露API接口
│   ├── dto          # 数据传输对象
│   ├── entity       # 数据库实体
│   ├── service      # 业务逻辑层
│   └── mapper       # MyBatis映射文件

前端项目通常采用Vue CLI结构，区分views（页面）、router（路由）、store（Pinia/Vuex状态管理）。

如需完整源码，可通过GitHub搜索关键词springboot vue classroom management获取开源参考项目。