# gra_test

**Repository Path**: xia-hongcheng/gra_test

## Basic Information

- **Project Name**: gra_test
- **Description**: 写着玩1111111111111111111
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-30
- **Last Updated**: 2025-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 成绩管理系统 - 成绩分析功能

## 一、成绩分析相关接口

成绩分析模块主要包括以下API接口：

### 1. 基础统计分析
- **接口地址**: `/analysis/basic-stats`
- **请求方式**: GET
- **参数**:
  - `exam_id`: 考试ID（必填）
  - `subject_id`: 科目ID（可选）
  - `class_id`: 班级ID（可选）
- **功能**: 获取特定考试、科目、班级的基本统计数据，包括平均分、最高分、及格率等。

### 2. 排名分析
- **接口地址**: `/analysis/ranking`
- **请求方式**: GET
- **参数**:
  - `exam_id`: 考试ID（必填）
  - `subject_id`: 科目ID（可选）
  - `class_id`: 班级ID（可选）
- **功能**: 获取学生在特定考试、科目范围内的排名数据。

### 3. 分数分布分析
- **接口地址**: `/analysis/distribution-chart`
- **请求方式**: GET
- **参数**:
  - `exam_id`: 考试ID（必填）
  - `subject_id`: 科目ID（可选）
  - `class_id`: 班级ID（可选）
- **功能**: 获取特定范围内的分数段分布数据。

### 4. 科目对比分析
- **接口地址**: `/analysis/subjects-comparison`
- **请求方式**: GET
- **参数**:
  - `exam_id`: 考试ID（必填）
  - `class_id`: 班级ID（可选）
  - `student_id`: 学生ID（可选）
- **功能**: 获取同一考试下不同科目的对比数据。

### 5. 学生进步情况分析
- **接口地址**: `/analysis/student-progress`
- **请求方式**: GET
- **参数**:
  - `student_id`: 学生ID（必填）
  - `subject_id`: 科目ID（可选）
- **功能**: 获取学生在多次考试中的成绩变化趋势。

### 6. 学生优劣势科目分析
- **接口地址**: `/analysis/student-strengths`
- **请求方式**: GET
- **参数**:
  - `student_id`: 学生ID（必填）
  - `exam_id`: 考试ID（可选）
- **功能**: 获取学生在各科目的强弱项分析。

## 二、前端API调用

前端通过封装好的API模块调用这些接口：

```javascript
// 成绩分析相关接口
export const analysisApi = {
  // 获取基本统计数据
  getBasicStats(params) {
    return api.get('/analysis/basic-stats', { params })
  },
  
  // 获取排名数据
  getRanking(params) {
    return api.get('/analysis/ranking', { params })
  },
  
  // 获取分数分布数据
  getDistributionChart(params) {
    return api.get('/analysis/distribution-chart', { params })
  },
  
  // 获取科目对比数据
  getSubjectsComparison(params) {
    return api.get('/analysis/subjects-comparison', { params })
  },
  
  // 获取学生进步情况数据
  getStudentProgress(params) {
    return api.get('/analysis/student-progress', { params })
  },
  
  // 获取学生优劣势科目分析
  getStudentStrengths(params) {
    return api.get('/analysis/student-strengths', { params })
  }
}
```

## 三、前端页面

成绩分析模块包含以下页面：

1. **BasicAnalysis.vue**: 基础统计分析，提供特定考试、科目的整体分析数据
2. **ComparisonAnalysis.vue**: 班级对比分析，比较不同班级在同一考试中的成绩差异
3. **StudentAnalysis.vue**: 学生个人分析，分析单个学生的成绩情况和进步趋势
4. **TrendAnalysis.vue**: 趋势分析，分析多次考试的成绩变化趋势

## 四、前端调用示例

### 获取基础统计数据
```javascript
async fetchAnalysisData() {
  this.loading = true
  try {
    const response = await this.$api.analysis.getBasicStats({
      exam_id: this.filterForm.examId,
      subject_id: this.filterForm.subjectId,
      class_id: this.filterForm.classId
    })
    
    if (response.success) {
      // 处理响应数据
      this.statisticsData = response.data
      this.hasData = true
    } else {
      this.$message.error(response.message || '获取分析数据失败')
    }
  } catch (error) {
    this.$message.error('获取分析数据失败: ' + error.message)
  } finally {
    this.loading = false
  }
}
```

### 获取学生进步分析
```javascript
async fetchStudentProgressData() {
  this.loading = true
  try {
    const response = await this.$api.analysis.getStudentProgress({
      student_id: this.form.student_id,
      subject_id: this.form.subject_id
    })
    
    if (response.success) {
      // 处理学生进步数据
      this.progressData = response.data
      this.generateTrendChart(this.progressData)
    } else {
      this.$message.error(response.message || '获取学生进步数据失败')
    }
  } catch (error) {
    this.$message.error('获取学生进步数据失败: ' + error.message)
  } finally {
    this.loading = false
  }
}
```

## 五、数据可视化

前端使用图表来直观展示分析结果：

1. **分数分布图**: 显示不同分数段的人数分布
2. **班级对比图**: 比较不同班级的平均分、及格率等
3. **成绩趋势图**: 显示学生成绩随时间的变化趋势
4. **科目雷达图**: 展示学生在各科目的相对优势

实际项目中，可以使用ECharts、Chart.js等图表库进行数据可视化。