🎓 学生扣分管理系统

基于 Vue3 + Flask 的班级学生行为量化管理系统，提供扣分记录、数据统计、公告发布等功能

API文档: q573zqg6s1.apifox.cn

🌟 功能特性

📊 核心功能

功能模块	功能描述
扣分记录管理	增删查改学生扣分记录，支持模糊搜索
数据可视化	折线图展示扣分趋势，TOP榜显示重点学生
公告系统	Markdown格式公告弹窗，支持多端展示
权限验证	API密钥验证机制保障数据安全

🛠 技术亮点

📦 前端技术栈
- Vue3 + Composition API
- Ant Design Vue 组件库
- VueUse / Axios / Marked
- 响应式布局（适配PC/移动端）

⚙️ 后端技术栈
- Flask RESTful API
- PyMySQL 数据库操作
- JWT 令牌验证
- Nginx 反向代理配置

📂 项目结构

.
├── fronted                # 前端项目
│   ├── src
│   │   ├── assets        # 静态资源
│   │   ├── components    # 通用组件
│   │   ├── electeon      # 客户端
│   │   └── index.js      # 核心逻辑
│
├── backend               # 后端项目
│   ├── app
│   │   ├── routes        # 路由模块
│   │   ├── utils         # 工具函数
│   │   └── __init__.py   # 应用工厂
│   ├── student.sql       # 数据库初始化文件
│   └── requirements.txt  # Python依赖

🚀 快速开始

环境要求

• Node.js 16+
• Python 3.9+
• MySQL 8.0+

📥 安装步骤

# 克隆项目
git clone https://github.com/ischenyu/FlaskStudentManager.git
cd FlaskStudentManager

# 前端依赖
cd fronted
npm install

# 后端依赖
cd ../backend
pip install -r requirements.txt

🛠 数据库配置

1. 创建MySQL数据库

CREATE DATABASE student DEFAULT CHARSET=utf8mb4;

2. 导入初始化数据

mysql -u root -p student < backend/student.sql

⚙️ 配置文件

在 backend 目录创建 .env 文件：

# MySQL 配置
PROD_DATABASE_URI=mysql+pymysql://student:Dingtalk1234561017@192.168.10.115:3306/student?charset=utf8mb4
ADMIN_API_KEY=1017

DB_HOST=192.168.10.115
DB_USER=student
DB_PASSWORD=Dingtalk1234561017
DB_NAME=student

🖥 运行项目

后端服务

cd backend
flask run --host=0.0.0.0 --port=5000

前端服务

修改 fronted/src/index.js:13中的 http://192.168.10.115:5000 改为开发服务器地址

10| export const api = axios.create({
11|     baseURL: import.meta.env.PROD
12|         ? '/api'
13|         : 'http://192.168.10.115:5000/api'
14| })

cd fronted
npm install
npm run dev

访问地址：http://localhost:3000

部署建议

后端生产环境部署使用gunicorn 启动命令：

../venv/bin/python3 -m gunicorn -w 4 -b <adderss>:<port> wsgi:app

📌 注意事项

1. 首次运行前需确保：

   • MySQL服务已启动并开放3306端口
   • 已安装所有依赖包（前端npm / 后端pip）
   • 数据库账号有建表权限

2. 生产部署建议：

   • 使用Gunicorn部署Flask应用
   • 配置Nginx反向代理
   • 启用HTTPS加密传输
   • 定期备份数据库

🤝 贡献指南

欢迎提交 Issue 或 PR，请遵循以下规范：

1. 新功能开发请新建分支（feat/xxx）
2. Bug修复请关联具体Issue编号
3. 提交前执行代码格式化（前端ESLint / 后端Black）

📄 许可证

MIT License © 2025 Shan Chenyu