一个基于前后端分离架构的学生管理系统，支持多角色权限管理。

更多截图请查看 项目成品展示images 目录

• Node.js + Express
• MySQL 8.0
• JWT 认证
• bcrypt 密码加密

• Vue 3 + Composition API
• Vite 构建工具
• Element Plus UI 组件库
• Pinia 状态管理
• Vue Router 路由管理
• Axios HTTP 客户端
• SCSS 样式预处理

• 学生 (student): 查看/申请加入班级、查看个人信息
• 教师 (teacher): 管理课程班级、审批学生加入申请
• 辅导员 (counselor): 管理专业班级、审批学生申请、创建学生账号
• 管理员 (admin): 系统管理、用户管理、班级管理

• 用户认证（登录、注册、找回密码、记住密码）
• 用户管理（CRUD、批量操作）
• 专业班级管理（支持按辅导员姓名搜索）
• 课程班级管理（支持按教师姓名搜索）
• 学生选课/退课
• 审批功能（学生申请加入班级需要审批）
• 班级成员管理

• 学生申请加入班级后，状态为"待审批"
• 辅导员审批专业班级的学生申请
• 教师审批课程班级的学生申请
• 支持单个审批和批量审批
• 审批通过后学生正式加入班级

• 记住密码：勾选后，用户名和密码会保存在本地，下次打开自动填充
• 会话管理：
  • 勾选"记住密码"：Token 存储在 localStorage，关闭浏览器后保持登录
  • 不勾选：Token 存储在 sessionStorage，关闭浏览器后需重新登录

student-management-system/
├── backend/                 # 后端项目
│   ├── database/           # 数据库脚本
│   │   └── init.sql       # 初始化SQL
│   ├── scripts/            # 工具脚本
│   │   ├── init-db.js     # 数据库初始化脚本
│   │   ├── init-test-db.js # 测试数据库初始化脚本
│   │   └── verify-db.js   # 数据库验证脚本
│   ├── src/
│   │   ├── config/        # 配置文件
│   │   ├── controllers/   # 控制器
│   │   ├── middlewares/   # 中间件
│   │   ├── models/        # 数据模型
│   │   ├── routes/        # 路由
│   │   ├── services/      # 业务服务
│   │   ├── utils/         # 工具函数
│   │   └── app.js         # 应用入口
│   ├── __tests__/         # 测试文件
│   ├── .env.example       # 环境变量示例
│   ├── .env.test          # 测试环境配置（需自行创建）
│   └── package.json
├── frontend/               # 前端项目
│   ├── public/
│   ├── src/
│   │   ├── api/           # API 接口
│   │   ├── assets/        # 静态资源
│   │   ├── components/    # 公共组件
│   │   ├── constants/     # 常量定义
│   │   ├── layout/        # 布局组件
│   │   ├── router/        # 路由配置
│   │   ├── store/         # 状态管理
│   │   ├── styles/        # 全局样式
│   │   ├── utils/         # 工具函数
│   │   ├── views/         # 页面组件
│   │   ├── App.vue
│   │   └── main.js
│   ├── .env.example       # 环境变量示例
│   ├── index.html
│   ├── vite.config.js
│   └── package.json
├── docs/                   # 项目文档
└── 项目成品展示images/      # 项目截图

• Node.js >= 16.0
• MySQL >= 8.0
• npm 或 yarn

git clone https://github.com/sixiaopangai/student-management-system.git
cd student-management-system

方式一：使用 Node.js 脚本（推荐）

cd backend
npm install
npm run init-db

方式二：使用 MySQL 命令行

mysql -u root -p < backend/database/init.sql

cd backend

# 安装依赖
npm install

# 复制环境变量配置
cp .env.example .env

# 编辑 .env 文件，配置数据库连接等信息

# 启动开发服务器
npm run dev

后端服务默认运行在 http://localhost:3000

cd frontend

# 安装依赖
npm install

# 复制环境变量配置
cp .env.example .env

# 启动开发服务器
npm run dev

前端服务默认运行在 http://localhost:5173

系统初始化后包含以下测试数据（所有账号密码均为 123456）：

以下账号为禁用状态，用于测试登录失败场景：

• T202403 (张秀英) - 教师
• C202403 (李国强) - 辅导员
• 23030002 (罗思琪) - 学生

• 学号格式：年级(2位) + 专业代码(2位) + 序号(4位)
  • 例：23010001 = 23级 + 01专业 + 0001号
• 教师职工号格式：T + 年份(4位) + 序号(2位)
  • 例：T202401 = 2024年入职01号教师
• 辅导员职工号格式：C + 年份(4位) + 序号(2位)
  • 例：C202401 = 2024年入职01号辅导员

• 学生：学号@stu.com（如 23010001@stu.com）
• 教师：职工号@teacher.com（如 T202401@teacher.com）
• 辅导员：职工号@counselor.com（如 C202401@counselor.com）

详细的 API 文档请参考 接口说明文档

• POST /api/v1/auth/login - 用户登录
• POST /api/v1/auth/register - 用户注册
• POST /api/v1/auth/logout - 用户登出
• GET /api/v1/auth/current-user - 获取当前用户信息

• GET /api/v1/users - 获取用户列表
• POST /api/v1/users - 创建用户
• PUT /api/v1/users/:id - 更新用户
• DELETE /api/v1/users/:id - 删除用户

• GET /api/v1/major-classes - 获取班级列表（支持按辅导员姓名搜索）
• POST /api/v1/major-classes - 创建班级
• PUT /api/v1/major-classes/:id - 更新班级
• DELETE /api/v1/major-classes/:id - 删除班级

• GET /api/v1/course-classes - 获取课程列表（支持按教师姓名搜索）
• POST /api/v1/course-classes - 创建课程
• PUT /api/v1/course-classes/:id - 更新课程
• DELETE /api/v1/course-classes/:id - 删除课程

• GET /api/v1/counselor/my-major-classes - 获取我的班级
• GET /api/v1/counselor/my-major-classes/:id/students - 获取班级学生
• PUT /api/v1/counselor/my-major-classes/:id/students/:studentId/approve - 审批通过
• PUT /api/v1/counselor/my-major-classes/:id/students/:studentId/reject - 审批拒绝

• GET /api/v1/teacher/my-course-classes - 获取我的课程
• GET /api/v1/teacher/my-course-classes/:id/students - 获取课程学生

• 使用 ESLint 进行代码检查
• 遵循 Vue 3 Composition API 风格
• 使用 SCSS 编写样式

feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 代码重构
test: 测试相关
chore: 构建/工具相关

项目使用独立的测试数据库，与开发数据库完全隔离：

cd backend

# 1. 创建测试环境配置文件
cp .env.example .env.test

# 2. 编辑 .env.test，设置测试数据库名称
# DB_NAME=student_management_test

# 3. 初始化测试数据库
npm run init-test-db

# 后端单元测试
cd backend && npm test

# 后端集成测试（自动重置测试数据库）
cd backend && npm run test:integration

# 前端测试
cd frontend && npm test

cd backend

# 初始化测试数据库
npm run init-test-db

# 重置测试数据库（删除后重新创建）
npm run init-test-db:reset

# 清理测试数据库（仅删除）
npm run init-test-db:clean

详细的测试报告请参考 测试报告

详细的部署说明请参考 部署说明文档

# 前端
cd frontend
npm run build

前端构建产物在 frontend/dist 目录，可部署到 Nginx 等静态服务器。

• GitHub: @sixiaopangai

MIT License