# 简易学情评价系统

**Repository Path**: ADStudio/LearningAssessment

## Basic Information

- **Project Name**: 简易学情评价系统
- **Description**: 使用AI协助开发的学情评价系统，简单易用。
- **Primary Language**: NodeJS
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-29
- **Last Updated**: 2025-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 使用Trae AI实现 “学生学情评价系统”
## 一、系统概述
学生学情评价系统（作业提交）是一个基于Web的应用程序，旨在简化教师发布作业、学生提交作业以及教师评分的流程。系统采用前后端分离架构：

- 前端 ：Vue.js + layui，提供友好的用户界面
- 后端 ：Node.js + Express，提供API服务
- 数据库 ：MySQL 8.0.12，存储系统数据
## 二、系统功能
### 1. 核心功能 学生端
- 学生登录认证
- 个人信息展示（班级、姓名等）
- 作业提交列表查看
- 提交新作业（支持文本内容和图片上传/粘贴）
- 年级排名查看（前10名）
- 班级排名查看（前20名）
- 密码修改功能 教师端
- 教师登录认证
- 个人信息展示
- 作业发布（支持文本内容和图片上传/粘贴）
- 作业提交列表查看（支持班级和作业筛选）
- 学生作业评分（0-5分，支持评价文字）
- 年级排名查看
- 班级排名查看
- 班级管理（增删改查）
- 学生管理（增删改查、密码重置）
- 密码修改功能
## 三、安装部署
### 1. 环境要求
- Node.js 16+
- MySQL 8.0.12
- Nginx（生产环境部署）
### 2. 数据库配置

```
# 创建数据库
CREATE DATABASE studentdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 创建用户并授权
CREATE USER 'adong'@'localhost' IDENTIFIED BY 'adpassword';
GRANT ALL PRIVILEGES ON studentdb.* TO 'adong'@'localhost';
FLUSH PRIVILEGES;
```

### 3. 初始化数据库

```
# 导入数据库结构和初始数据
mysql -u adong -p studentdb < backend/scripts/init.sql
```

### 4. 后端部署
```
cd backend
cp .env.example .env  # 复制环境变量文件并配置
npm install           # 安装依赖
node app.js           # 启动服务（开发环境）
# 或使用PM2管理（生产环境）
pm install -g pm2
pm start
```

### 5. 前端部署

```
cd frontend
npm install           # 安装依赖
npm run build         # 构建生产版本
```

### 6. Nginx配置

```
server {
    listen 80;
    server_name your_domain_or_ip;

    # 前端静态文件
    location / {
        root /path/to/StudentProject/frontend/dist;
        index index.html;
        try_files $uri $uri/ /index.html;
    }

    # 后端API代理
    location /api {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }

    # 文件上传目录
    location /uploads {
        alias /path/to/StudentProject/backend/uploads;
        autoindex off;
    }
}
```

## 四、使用指南
### 1. 用户登录
- 系统默认提供以下账号：
  - 教师账号：admin/123456, teacher1/123456, teacher2/123456
  - 学生账号：2023001/123456, 2023002/123456 等
### 2. 学生使用流程
1. 
   登录系统 ：输入学号和密码，角色选择"学生"
2. 
   查看个人信息 ：页面顶部显示班级和姓名信息
3. 
   查看作业列表 ：左侧面板显示已提交的作业记录
4. 
   提交新作业 ：
   - 点击"新增作业提交"按钮
   - 选择要提交的作业
   - 输入作业内容
   - 可粘贴截图（使用Shift+Win+S组合键截图后粘贴）
   - 点击"提交"按钮
5. 
   查看排名 ：右侧面板显示年级排名和班级排名
6. 
   修改密码 ：点击个人信息栏的"修改密码"按钮
### 3. 教师使用流程
1. 
   登录系统 ：输入用户名和密码，角色选择"教师"
2. 
   管理功能 ：
   - 点击顶部的管理按钮可进入班级管理、学生管理和作业管理页面
3. 
   发布作业 ：
   - 点击"发布作业"按钮
   - 选择班级（可为空表示全年级）
   - 输入作业名称和要求
   - 设置截止日期
   - 可上传附件或粘贴图片
   - 点击"发布"按钮
4. 
   查看作业提交 ：
   - 使用班级和作业筛选器过滤作业列表
   - 点击"查看"按钮查看学生提交详情
5. 
   评分作业 ：
   - 在作业详情页面或通过"评分"按钮
   - 输入评分（0-5分）和评价文字
   - 点击"保存"按钮
6. 
   查看统计信息 ：右侧面板显示年级排名和班级学生提交情况
## 五、注意事项
1. 
   图片上传 ：
   - 粘贴图片时建议使用Windows截图工具（Shift+Win+S）
   - 大文件可能需要更长的上传时间，请耐心等待
2. 
   跨机访问配置 ：
   - 如需在其他电脑访问系统，需要在浏览器控制台设置API地址
   - 执行： localStorage.setItem('apiBaseUrl', 'http://服务器IP:3000'); location.reload();
3. 
   系统性能 ：
   - 系统支持60个并发用户同时使用
   - 数据库可处理1000条以上的作业提交记录
4. 
   常见问题 ：
   - 登录失败：检查用户名、密码和角色选择
   - WebSocket连接失败：检查防火墙设置或使用正确的IP地址配置
   - 文件上传失败：检查文件大小是否超限（最大50MB）
## 六、维护与更新
1. 
   数据备份 ：定期备份MySQL数据库
2. 
   日志查看 ：后端日志可通过控制台或日志文件查看
3. 
   系统更新 ：
   - 后端：更新代码后重启服务
   - 前端：重新构建并部署静态文件
## 七、技术支持
如有任何问题或建议，请联系系统管理员。