立项原因：传统高校教室与实验室场地预约依赖线下纸质审批或 Excel 登记方式，存在预约冲突频发、审批流程不透明、签到考勤难以核实、数据统计滞后等问题。本项目旨在通过数字化手段，将教室预约、审核审批、签到考勤、数据统计全流程线上化，实现场地资源的可视化调度与精细化管理，提升校园资产利用率，减少管理成本。
行业场景：面向高等院校及教育培训机构的智慧校园信息化建设领域，属于教务后勤资源管理场景。系统服务于管理员、教师、学生三类角色，覆盖教室预约申请、分级审核、现场签到、使用统计等核心业务环节。
功能模块：项目包含用户认证、教室管理、预约审核、签到考勤、课表管理、通知公告、系统设置、AI 智能问答、统计报表九大功能模块，共 12 个 Controller、9 个业务 Service。
主要功能描述：
用户认证：基于 BCrypt 加密的登录注册体系，支持管理员/教师/学生三角色权限隔离，通过 Session + ThreadLocal 维护用户上下文。
教室管理：支持普通、多媒体、实验室、机房、会议室五类教室的增删改查与逻辑删除，记录容量、设备、状态等元数据。
预约审核：学生/教师提交预约申请，管理员审核。采用责任链模式串联参数校验→教室状态检查→时间冲突检测→管理员审核四个处理器，支持标准链、快速链、仅验证链三种组合。
签到考勤：支持二维码签到、预约签到、自习签到三种方式，记录正常/迟到/缺勤状态，提供按教室、按学生维度的签到统计。
课表管理：按学期、周次、星期、时间段管理教室课表，与预约记录联动避免冲突。
通知公告：基于观察者模式实现，预约创建、审核通过/拒绝、签到完成等事件自动触发系统通知推送。
统计报表：提供教室使用统计、热门教室排行、高峰时段热力图，支持 Apache POI 导出 Excel 报表。
AI 智能问答：集成智谱 AI 大模型，为用户提供智能问答服务。
系统设置：支持字符串/数字/布尔/下拉四类配置项的动态管理与批量更新。
个人负责任务：独立完成系统整体架构设计与全部功能开发，包括数据库表设计（7 张核心表）、REST API 设计（12 个 Controller、40+ 接口）、三种设计模式的编码实现、前后端交互逻辑，以及签到统计与 Excel 导出等核心业务逻辑。
技术栈：Spring Boot 4.0.5 + MyBatis-Plus 3.5.16 + MySQL 8.0 + Thymeleaf，Java 17，集成智谱 AI SDK、Apache POI、Spring Security Crypto（BCrypt）。
架构亮点与难点：
责任链模式：将预约审核流程解耦为四个独立处理器，通过工厂类灵活组合三种审核链，新增审核规则只需扩展处理器，符合开闭原则。
观察者模式：使用 CopyOnWriteArrayList 保证观察者列表并发安全，预约状态变更与通知发送解耦，支持事件类型扩展。
装饰器模式：通过 JDK 动态代理为 9 个 Service 无侵入添加统一日志增强（方法调用记录、参数打印、耗时统计、慢方法告警），结合 Spring @Primary 实现 Bean 替换，业务代码零修改。
统一异常处理与全局拦截器：GlobalExceptionHandler 统一捕获业务异常，LoginInterceptor 实现接口级权限控制，Result 封装统一响应格式。
难点：责任链处理器的上下文传递与中断控制、装饰器代理与 Spring 生命周期的兼容、签到时间冲突的多维度校验逻辑。
评论