智慧校园综合管理平台，面向高校师生提供课表管理、比赛评分、文件共享、
AI 辅助等一站式服务。
核心使用场景：
1. 教务处/学生会批量导入课表，OCR 识别纸质课表照片自动转电子版，学生按
班级/教师/教室多维度查询
2. 校园比赛评委在线打分，系统自动去掉最高最低分排名，实时出成绩
3. 文件中心支持阿里云OSS云存储，按活动分类、文件夹管理、推文发布
4. AI日程规划根据课表+活动自动生成个人日程
5. AI心理陪伴助手提供7×24小时在线聊愈服务
已上线稳定运行，日均访问量稳定。部署于云服务器，Docker容器化管理。
一、课表管理模块
- Excel批量导入/导出，支持按班级、教师、教室、时间多维度查询
- OCR识别：上传课表照片自动识别转电子课表（PyMuPDF + AI视觉）
- 课表中心：可视化周视图，颜色区分课程类型
二、比赛评分系统
- 自定义评分模板（维度/子维度/权重）
- 评委在线打分，去掉最高最低分自动计算
- 实时排名发布，支持导出成绩单
三、文件中心
- 阿里云OSS云存储，支持大文件上传（预签名URL直传）
- 按活动分类 → 文件夹树 → 文件管理
- 推文发布功能，支持权限控制（管理员/创建者）
四、AI日程规划
- 基于课表+活动数据，AI自动生成个人日程安排
- 支持自然语言输入调整（如"周五下午空出来"）
五、AI心理陪伴"小暖"
- 7×24小时在线对话，危机检测自动预警
- 基于学校官方心理服务知识库
- 对话记录加密存储，保护隐私
六、用户与权限
- JWT认证 + RBAC角色权限（学生/教师/管理员）
- 部门化管理，数据按权限隔离
技术架构：
- 前端：React 19 + TypeScript + Vite构建，Zustand状态管理，Tailwind CSS布局，
响应式适配桌面/平板/手机
- 后端：Express (Node.js) REST API，路由模块化设计，JWT认证中间件，
bcrypt密码哈希
- AI服务：Flask (Python) + PyMuPDF OCR + Dify知识库 + DeepSeek大模型
- 数据库：MySQL 8.0，连接池管理，20+核心表，支持JSON字段存储
- 存储：阿里云OSS，V4签名预签名URL直传，服务端代理下载
- 部署：Docker Compose 容器化（nginx + backend + ai-service + mysql），
云服务器运行
开发实践：
- 完整TypeScript严格模式，零 as any
- Vitest单元+集成测试 + Playwright E2E测试
- 16项布局健康检查（溢出/重叠/截断 × 4分辨率）
- Git版本管理，分支开发合并
性能优化：
- OSS预签名URL直传，服务器零内存消耗
- DB连接池复用，索引优化高频查询
- nginx反向代理 + gzip压缩 + 静态资源缓存
团队角色：独立全栈开发（需求分析→架构设计→前后端开发→部署运维）
评论