# gradMind

**Repository Path**: shuinan/grad-mind

## Basic Information

- **Project Name**: gradMind
- **Description**: 本科毕设实践教学
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI协助毕设实践系统

> 江西软件职业技术大学 - AI协助毕设实践系统

## 项目简介

AI协助毕设实践系统是一个面向高校毕业设计管理的综合性平台，旨在通过人工智能技术辅助学生完成毕业设计，同时为教师提供便捷的管理工具。系统包含用户管理、班级管理、学生管理、软件工程教学、AI编码辅助、毕设指导等核心模块。

## 功能模块

### 1. 数据看板
- 展示各班级毕设进度分布统计
- 可视化展示学生毕设状态（未开题、开发中、论文撰写、已答辩）
- 班级进度详情表格

### 2. 班级管理
- 班级信息的增删改查
- 支持按班级名称、专业搜索
- 分页展示

### 3. 学生管理
- 学生信息的增删改查
- 支持按姓名、学号、班级、状态筛选
- 毕设选题和指导教师管理

### 4. 用户管理
- 用户信息的增删改查
- 角色管理（管理员、教师、学生）
- 班级关联管理

### 5. 软件工程教学
- 分阶段展示软件工程开发流程
- 以图书管理系统为案例进行教学
- 包含核心定义、开发要点、案例演示、易错点

### 6. AI编码辅助
- AI辅助代码生成
- 代码优化建议
- 技术方案推荐

### 7. 毕设指导
- 毕设进度管理
- 文献资料管理
- 导师指导记录

## 技术框架

### 前端
- **框架**: Vue 3 (Composition API)
- **构建工具**: Vite 5
- **UI组件库**: Element Plus
- **图表库**: ECharts
- **HTTP客户端**: Axios
- **路由**: Vue Router
- **样式**: SCSS

### 后端
- **框架**: Express.js
- **数据库**: MySQL 8.0
- **认证**: JWT (JSON Web Token)
- **密码加密**: bcryptjs
- **环境变量**: dotenv

### 部署
- **数据库**: Docker容器
- **开发服务器**: Node.js内置HTTP服务器

## 环境要求

- Node.js >= 18.0.0
- MySQL >= 8.0 (或Docker容器)
- npm >= 9.0.0

## 项目结构

```
gradMind/
├── backend/                 # 后端代码
│   ├── config/             # 配置文件
│   │   └── database.js     # 数据库连接配置
│   ├── middleware/         # 中间件
│   │   └── auth.js         # 认证中间件
│   ├── routes/             # 路由定义
│   │   ├── auth.js         # 认证路由
│   │   ├── class.js        # 班级管理路由
│   │   ├── student.js      # 学生管理路由
│   │   ├── user.js         # 用户管理路由
│   │   ├── teaching.js     # 教学模块路由
│   │   ├── coding.js       # AI编码辅助路由
│   │   ├── graduation.js   # 毕设指导路由
│   │   └── ai.js           # AI接口路由
│   ├── .env                # 环境变量配置
│   ├── server.js           # 服务入口
│   └── package.json        # 依赖配置
├── frontend/               # 前端代码
│   ├── src/
│   │   ├── views/          # 页面组件
│   │   │   ├── Login.vue           # 登录页面
│   │   │   ├── Dashboard.vue       # 数据看板
│   │   │   ├── Classes.vue         # 班级管理
│   │   │   ├── Students.vue        # 学生管理
│   │   │   ├── Users.vue           # 用户管理
│   │   │   ├── Teaching.vue        # 软件工程教学
│   │   │   ├── Coding.vue          # AI编码辅助
│   │   │   └── Graduation.vue      # 毕设指导
│   │   ├── router/         # 路由配置
│   │   ├── utils/          # 工具函数
│   │   │   └── axios.js    # HTTP请求封装
│   │   ├── App.vue         # 根组件
│   │   ├── main.js         # 入口文件
│   │   └── style.css       # 全局样式
│   ├── index.html          # HTML模板
│   ├── vite.config.js      # Vite配置
│   └── package.json        # 依赖配置
├── database/               # 数据库脚本
│   ├── init.sql            # 数据库初始化脚本
│   └── insert_materials.js # 教学资料导入脚本
├── docs/                   # 文档
│   ├── requirements.md     # 需求文档
│   └── test_cases.md       # 测试用例文档
└── .gitignore              # Git忽略配置
```

## 安装与运行

### 1. 数据库配置

确保MySQL服务运行，创建数据库：

```sql
CREATE DATABASE gradmind CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

或使用Docker启动MySQL：

```bash
docker run -d \
  --name gradmind-mysql \
  -p 3307:3306 \
  -e MYSQL_ROOT_PASSWORD=password \
  -e MYSQL_DATABASE=gradmind \
  docker.1ms.run/library/mysql:8.0
```

### 2. 初始化数据库

```bash
mysql -h localhost -P 3307 -u root -ppassword gradmind < database/init.sql
```

### 3. 后端运行

```bash
cd backend
npm install
npm start
```

后端服务将运行在 http://localhost:3001

### 4. 前端运行

```bash
cd frontend
npm install
npm run dev
```

前端服务将运行在 http://localhost:8083

## 配置说明

### 后端环境变量 (.env)

```
PORT=3001
DB_HOST=localhost
DB_PORT=3307
DB_USER=root
DB_PASSWORD=password
DB_NAME=gradmind
JWT_SECRET=gradmind_secret_key_2024
NODE_ENV=development
```

### 前端代理配置 (vite.config.js)

```javascript
server: {
  proxy: {
    '/api': {
      target: 'http://localhost:3001',
      changeOrigin: true
    }
  }
}
```

## 默认账号

| 用户名 | 密码 | 角色 |
| :--- | :--- | :--- |
| admin | 123456 | 管理员 |
| teacher1 | 123456 | 教师 |

## 角色权限

- **管理员**: 拥有所有功能权限
- **教师**: 可管理所在班级的学生信息，查看教学内容
- **学生**: 仅能查看自己的毕设相关信息

## API接口

### 认证接口
- `POST /api/auth/login` - 用户登录
- `POST /api/auth/register` - 用户注册

### 班级管理
- `GET /api/class` - 获取班级列表
- `POST /api/class` - 创建班级
- `PUT /api/class/:id` - 更新班级
- `DELETE /api/class/:id` - 删除班级

### 学生管理
- `GET /api/student` - 获取学生列表
- `POST /api/student` - 创建学生
- `PUT /api/student/:id` - 更新学生
- `DELETE /api/student/:id` - 删除学生
- `GET /api/student/dashboard` - 获取看板数据

### 用户管理
- `GET /api/user` - 获取用户列表
- `POST /api/user` - 创建用户
- `PUT /api/user/:id` - 更新用户
- `DELETE /api/user/:id` - 删除用户

## 开发说明

### 前端开发规范
- 使用Vue 3 Composition API
- 使用Element Plus组件库
- 统一使用Axios封装进行HTTP请求
- 组件样式使用scoped属性

### 后端开发规范
- 使用Express路由模块化
- 统一错误处理
- 使用JWT进行认证
- 数据库查询使用参数化查询防止SQL注入

## 项目地址

- Gitee: https://gitee.com/shuinan/grad-mind

## License

MIT License