中小学及高校教务排课是教育机构的核心管理痛点。传统人工排课需教务人员在Excel中手工协调教师时间、教室资源和班级课表，耗时数天且极易产生冲突——教师时间重叠、教室占用冲突、约束条件无法满足等问题频发，排课完成后还需人工逐一核验。
本项目旨在用 AI Agent 替代人工排课全流程：管理员在系统中配置学期、课程、教师、教室及排课约束条件后，AI Agent 自主调用工具函数拉取基础数据、逐课检测冲突、写入排课结果，全过程异步执行无超时风险。排课完成后系统自动执行冲突检测（5分类：教师时间/班级时间/教室时间/约束违反），生成课表版本并发布。
同时提供三端实时查看：教务管理端进行全量管理，教师端查看个人周课表与教学评价，学生端自动加载班级课表。系统还包含教学评教（4维度打分+自动综合分）和 AI 教学质量分析报告，形成"排课-查看-评教-分析"的完整闭环。适用于中小学、培训机构、高校教务场景。
系统包含三端角色，共30+功能模块：
【教务管理端】
· 首页Dashboard：9项数据卡（排课任务数/AI调用次数/待处理冲突/课程教师班级教室学生总数）+快捷入口+最近动态
· 基础数据管理：学期/校区/教师/班级/课程/教室/时间段共7张表完整CRUD
· 排课约束配置：教师可用时间/教室可用时间，8条硬软约束校验规则
· AI模型配置：配置SiliconFlow API（base_url/model/apiKey），enabled=1才生效
· 智能排课任务：新建任务→异步执行→状态机(PENDING→RUNNING→COMPLETED)→幂等防重复提交
· 冲突检测：3统计卡（检测总数/冲突数/通过率）+5分类Tabs（教师/班级/教室时间/约束违反）
· 课表版本管理：版本号生成→发布→查看26节完整明细弹窗
· 教学质量分析：多维度评教数据→AI生成分析报告
· 公告发布/用户管理：账号CRUD/角色切换/密码重置
【教师端】周课表（周一~周五×6时段，含课程名/时间段/教室/班级）、教学评价统计（4统计卡+筛选+分页）、可用时间提交
【学生端】班级课表自动加载（Alert提示班级ID+3门主课含具体时间）、教务公告、教学评教（4维度打分+自动算综合分）
【安全加固】JWT角色权限拦截、CORS白名单、图形验证码+双维度限流、40条数据库外键约束、@Async双线程池
本人独立完成全栈开发，负责需求分析、数据库设计（20+表/40条外键）、后端API、前端界面、AI Agent集成及Docker部署。
技术栈：后端 Java 17 + Spring Boot 3.3.5 + MyBatis + MySQL 8 + Spring AI 1.0（SiliconFlow/DeepSeek-V3）；前端 Vue 3 + Vite 5 + Element Plus + Pinia + Axios；部署 Docker Compose 三容器（Nginx + Spring Boot + MySQL）。
架构亮点与难点：
①AI Agent异步排课引擎——自定义@Async双线程池（scheduleExecutor core=1/max=2/CallerRunsPolicy + sysExecutor），HTTP立即返回+前端3s轮询，解决长排课任务HTTP超时难题。Agent通过Spring AI Function Calling自主调用查课程/查教师/查冲突/写课表等工具函数，每步记录args/result/duration四要素日志。
②排课数据完整性——写入操作三层防护：参数校验→INSERT返回值检查→回查二次验证，确保AI生成的排课数据100%可靠。
③AI限流自适应——工具调用间sleep 1.5s降低TPM，遇到429自动等待65s重试最多4轮，保证Agent在API限流下仍能完成全量排课。
④生产级安全7项加固——角色权限拦截器（STUDENT/TEACHER/ADMIN三级隔离）、CORS白名单（非*+allowCredentials）、Caffeine验证码（180s TTL一次性）+双维度限流（IP 60s/30次+用户名180s/5次）、40条数据库外键约束（CASCADE/SET NULL/RESTRICT三级策略）
评论