# 基于马尔科夫链的教学评价

**Repository Path**: Reol2022/teaching-evaluation-system

## Basic Information

- **Project Name**: 基于马尔科夫链的教学评价
- **Description**: 利用马尔科夫链+动态转移矩阵实现教学评价
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-14
- **Last Updated**: 2025-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 高校教师教学质量评价系统

面向高校教学质量评价的综合平台，提供学生评价、教师与课程排名分析、教学班与课程管理等功能。系统通过指标加权与马尔科夫链的状态转移模型，对教学质量进行当期与长期的综合评估。

## 系统简介
- 角色：管理员、教师、学生
- 核心功能：
  - 学生提交评价（10项指标，防重复评价）
  - 教师/课程/院系排名分析（支持按学期筛选）
  - 教学班、课程、学生、教师的增删改查
  - 数据可视化仪表盘与统计
- 评价计算：指标归一化加权得到基础分，映射质量状态；基于状态转移矩阵进行马尔科夫预测与稳态融合，生成最终分数与排名。

## 技术栈
- 后端：FastAPI + SQLAlchemy（SQLite/MySQL）
- 前端：Vue 3 + Vite + Element Plus
- 认证：JWT（环境变量 `TEACH_EVAL_SECRET`）

## 快速开始
- 后端开发：`python -m uvicorn backend.app:app --reload --port 8000`
- 前端开发：`cd frontend && npm run dev`
- 默认账号：管理员 `admin/123456`；示例学生 `21202001/123456`

## 目录结构
```
backend/    后端服务（FastAPI、模型与接口）
frontend/   前端应用（Vue 3、Element Plus）
document/   文档（部署、系统设计、后台开发）
```

## 文档链接
- 后端开发文档：[`document/bakend.md`](document/bakend.md)
- 部署文档：[`document/deployment.md`](document/deployment.md)
- 系统设计（马尔科夫链与状态转移）：[`document/system_design.md`](document/system_design.md)

## 系统使用
### 登录
用户选择“学生身份”或者“管理员身份”登录。学生账号21202001，密码123456，管理员账号admin,密码123456。
![alt text](document/img/image.png)
## 学生端
学生完成登录之后进入系统，系统有两个一级菜单，分别是我的选课和提交评价。
### 我的选课
学生可以在此页面查看本学期选了的课程信息，包括课程名称、教师名称、学期，并查看是否完成评价。
![alt text](document/img/image-1.png)
### 提交评价
学生在这个页面完成对老师的评价，学生选择教师、教学班以及学期，然后通过十个指标对老师进行评价，在评价完成之后提交评价即可，在评价完成之后“我的选课”页面所对应课程评价状态就变为“已评价”。
![alt text](document/img/image-2.png)

可以看到，在提交评价之后，显示了计算出的评价得分和等级。

![alt text](document/img/image-3.png)
## 管理员端
管理员在登陆之后可以查看系统数据仪表盘，进行学生管理、教师管理、课程管理、教学班管理、以及评价分析。
### 首页数据仪表盘
数据仪表盘有用户数、教师数、学生数、课程数，评价趋势、评价状态分布、教师平均得分排名、课程得分排名
![alt text](document/img/image-4.png)
![alt text](document/img/image-5.png)

### 学生管理
学生的增删改查。

![alt text](document/img/image-7.png)

### 教师管理
教师的增删改查。

![alt text](document/img/image-8.png)

### 课程管理
课程的增删改查。

![alt text](document/img/image-9.png)

### 教学班管理
教学班的增删改查。

![alt text](document/img/image-10.png)

### 评价分析
查看教师的评价。

![alt text](document/img/image-11.png)