开源学生成绩查询管理系统 - 通用成绩管理后台与学生自助查询一体化平台

开源学生成绩查询管理系统 - 通用成绩管理后台与学生自助查询一体化平台

## 项目功能说明

### 一、学生端（H5 查询端）

学生无需注册或登录，直接在首页输入学号或姓名即可查询个人成绩。

**成绩查询与展示**

- 首页提供查询入口，系统自动识别输入内容：纯数字按学号查询，否则按姓名查询。

- 查询成功后进入成绩列表页，以卡片形式展示每门课程的成绩，包含课程名称、任课教师、学期、学分和总分。

- 列表支持按课程名称关键词搜索过滤。

- 点击任意成绩卡片进入详情页，展示完整的成绩信息：

  - 学生信息：姓名、学号、班级

  - 课程信息：课程名称、任课教师、学期、学分、考试日期

  - 成绩详情：总分以大号圆形展示，并依据分数显示对应等级（优秀/良好/中等/及格/不及格）；成绩构成细分展示平时成绩、期末成绩和考勤成绩三项分数。

  - 提供返回按钮。

**公告模块**

- 以列表形式展示所有已发布的公告，卡片包含标题、摘要、发布日期、类型标签（通知/重要/紧急）和阅读次数。

- 支持滚动到底部自动加载更多（无限滚动）。

- 点击进入公告详情页，展示完整标题、类型标签、阅读次数，以及使用富文本编辑器发布的正文内容（含图片和格式化文字）。

- 详情页还可展示附件列表（文件名和大小），供下载。

**个人中心**

- 展示当前查询学生的头像图标、姓名、学号、班级和专业信息。

- 提供"重新查询"入口，可切换查询其他学生。

- 提供"关于我们"入口，显示系统版本信息。

---

### 二、管理后台

管理后台需要登录使用，支持管理员和教师两种角色。

**登录**

- 管理员和教师通过用户名和密码登录。

- 支持"记住我"功能，下次打开页面自动填充用户名。

**控制台首页**

- 顶部展示四项统计数据卡片：学生总数、课程总数、成绩记录数、公告数量。

- 左侧展示最近发布的公告列表，置顶公告带有特殊标记。

- 右侧提供四个快捷操作按钮：添加学生、添加课程、录入成绩、发布公告。

**学生管理**

- 以表格展示所有学生，支持按学号或姓名搜索，可按学期筛选。

- 表格列：学号、姓名、性别、专业、班级、头像。

- 支持单行编辑和删除，支持多选批量删除。

- 添加/编辑学生时填写：学号、姓名、性别（单选男/女）、班级、专业，并可上传头像图片。

**课程管理**

- 以表格展示所有课程，支持按课程名称/代码搜索，可按学期筛选。

- 表格列：课程代码、课程名称、学分、学期。

- 支持添加和编辑课程，填写字段：课程代码、课程名称、学分（数值选择器，0.5 步进）、学期选择、任课教师。

- 支持删除课程。

**成绩管理**

- 提供多条件组合查询：学号、姓名、课程（下拉选择）、学期。

- 表格列：学号、姓名、课程名称、学期、成绩（带颜色区分等级）、等级标签。

- 成绩根据分数自动计算等级（优秀/良好/中等/及格/不及格）并以不同颜色标签展示。

- 支持录入新成绩：选择学生（可搜索下拉）、选择课程、选择学期、输入成绩。

- 支持编辑和删除成绩记录。

- 支持导出成绩（浏览器直接下载文件）。

- 支持从 Excel 文件导入成绩，提供下载导入模板链接。

**公告管理**

- 以表格展示所有公告，支持按标题搜索。

- 表格列：ID、标题（置顶公告特殊标记）、发布人、是否置顶。

- 支持置顶开关切换。

- 发布公告使用富文本编辑器（支持文字格式、插入图片等），可设置是否置顶。

- 支持编辑和删除公告。

**通用功能**

- 侧边栏导航可折叠展开，包含控制台、学生管理、课程管理、成绩管理、公告管理五个菜单项。

- 顶栏展示面包屑导航和当前登录用户信息，支持退出登录。

- 所有列表页均支持分页，可切换每页条数（10/20/50/100）。

---

### 三、后台接口（API）

后端提供完整的 RESTful API 支持上述所有功能：

**认证与权限**

- 登录接口验证用户名和密码，返回 JWT token，有效期 7 天。

- 修改密码接口需提供旧密码验证。

- 角色权限控制：公告的发布/撤回操作仅允许管理员和教师角色，批量导入学生仅允许管理员。

**学生接口**

- 完整的增删改查，支持多条件筛选（学号、姓名、班级、专业、性别、状态）和分页。

- 按学号查重，防止重复创建。

- 批量导入功能接收学生数组，一次插入多条记录。

**课程接口**

- 完整的增删改查，支持多条件筛选（课程编号、名称、类型、任课教师、学期、状态）和分页。

- 按课程编号查重。

**成绩接口**

- 支持多条件组合查询（学生 ID、学号、课程 ID、课程名称、学期、分数区间、班级），关联学生表和课程表。

- 录入成绩时自动查重，防止同一学生同一课程同一学期重复录入。

- 支持批量录入。

- 公开查询接口：无需认证，按学号或姓名返回学生所有成绩（用于学生端 H5）。

- 单个学生成绩统计：课程数、平均分、最1高分、最1低分、各等级数量。

- 单个课程成绩统计：学生数、平均分、最1高分、最1低分、各等级数量。

**公告接口**

- 完整的增删改查，发布/撤回功能（草稿与已发布状态切换）。

- 公开接口仅返回已发布的公告，登录后可见全部。

- 查看详情时自动增加浏览次数。

- 公告列表支持类型、是否置顶、发布状态、关键词搜索，按置顶优先级和发布时间排序。

**文件上传**

- 支持单张图片上传和多张图片上传（最多 10 张），仅允许 jpg/png/gif/webp 格式，单文件上限 5MB。

- 上传后返回可直接访问的 URL。

**通用设计**

- 所有响应统一格式：包含 success（是否成功）、message（提示信息）、data（数据体）。

- 分页响应额外包含 pagination 对象（当前页、每页条数、总条数、总页数）。

- 全局错误处理：404 路由、重复键值、文件上传尺寸超限等均有友好提示。

定制看需求，一般几小时内完成，也不贵。

【属性】

• 框架: vue
• 语言: PHP
• 数据库: Mysql
• 规格: 整站源码
• 授权: 免授权
• 源文件: 完全开源（含全部源文件）
• 大小: 1 MB
• 移动端: Wap、App、小程序、自适应、公众服务号
• 安装服务: 免费【要求说明】
• 主机类型: 独立主机（服务器、VPS、VM）
• 伪静态: 无需
• 操作系统: Linux
• 安装方式: 提供管理权限
• web服务: nginx