教室班级检查系统产品系统

立项原因 ：旨在解决传统教室安全检查依赖人工登记、纸质记录易丢失、数据无法实时汇总分析的痛点，实现检查过程电子化、记录云端化、统计自动化，保障校园教室设施安全隐患排查的可追溯性与高效性。

行业场景 ：面向各类中高职院校、中小学及培训机构的后勤与安全管理部门，日常开展教室卫生巡查、设施损坏登记、班级轮值考核、安全隐患排查等工作。业务流程涉及检查人员拍照上传、管理员审核归档、数据按月/学期维度自动生成考勤与设备完好率报表，支撑校区后勤管理从被动响应向主动预防转变。

本系统面向校园后勤安全管理场景，围绕教室检查全流程打造一站式电子化管理平台。具体功能模块包括：①检查记录管理：支持按教学楼/教室上传检查记录并拍照留痕，管理员可对记录进行审核、编辑、删除与归档；②多角色权限控制：内置超级管理员、普通管理员、巡检员等角色，细分查看、录入、编辑、删除、导出、用户管理、日志查看等十余项权限；③数据分析：自动按班级、教学楼、时间段汇总生成出勤统计、设备完好率报表、检查完成率图表，支撑学期维度的量化考核；④备份与恢复：支持定时全量备份及手动一键恢复，保障数据可追溯；⑤日志审计：完整记录所有登录行为与关键操作；⑥多教学楼SMB共享配置：支持按建筑独立配置照片存储路径，适配分布式部署场景；⑦数据导出：支持将检查记录批量导出为Excel格式用于离线归档或上报。

我独立负责了该系统从需求拆解、架构设计到部署运维的全流程开发，具体任务包括：① 设计并实现细粒度 RBAC 权限体系，内置超级管理员+普通角色及查看/录入/编辑/删除/导出/用户管理等 10 项可配置权限；② 开发检查记录上传模块，集成 SMB 共享存储支持多教学楼照片分布式保存与运行时热更新配置；③ 构建基于 APScheduler 的定时全量备份（数据库 SQL+照片 zip 打包）与手动恢复机制，解决 Windows 服务器大 SQL 导入超时问题；④ 完成数据分析看板（班级出勤统计、设备完好率报表、检查完成率可视化图表）；⑤ 搭建登录日志+操作日志双轨审计追踪；⑥ 编写 PyInstaller 打包脚本，完成服务器端部署上线与运维排障。

项目技术栈：后端 Python 3.12 + Flask + SQLAlchemy ORM + PyMySQL；密码加密采用 bcrypt（兼容旧 MD5 哈希自动升级）；定时任务 APScheduler；照片存储对接 SMB 共享服务；打包工具 PyInstaller；前端为 Flask 模板+原生 JS+Chart.js 实现图表可视化。

实现亮点：密码平滑升级（MD5 登录成功自动迁移 bcrypt）、双策略恢复备份（mysql 命令行优先+SQLAlchemy 回退，兼顾效率与兼容性）、SMB 路径动态热配、会话双重校验（Cookie 有效期+无操作 30 分钟过期）。核心难点为 Windows 环境下 mysql 导入大文件超时，通过恢复前暂停应用写操作、拆分备份分批导入、超时自动重试机制解决；以及照片与数据库恢复的原子性保障，采用 zip 统一打包 SQL 与 uploads 目录，恢复时先 DB 后文件保证一致性。