# java-ai

**Repository Path**: cwxue/java-ai

## Basic Information

- **Project Name**: java-ai
- **Description**: 从0开始使用ai搭建一个java+前端配套项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-24
- **Last Updated**: 2026-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学生管理系统

本仓库为一个 **Spring Boot + MyBatis-Plus + MySQL** 的学生管理系统示例，包含后端接口与前端管理端（Vite + Vue3 + TS + Element Plus）。

- **后端接口**：默认端口 `9090`（本项目开发时占用冲突后改为 9090）
- **前端开发**：默认 `5173`，若占用会自动递增（例如 `5174`）
- **接口文档**：`http://localhost:9090/`（会跳转 Swagger UI）

---

# 学生管理系统 完整标准功能清单（通用版，做课程设计/毕设/后台都够用）
按 **五大模块** 拆分，全覆盖，可直接作为需求文档/架构分解。

> 标注说明：
> - ✅ 已完成
> - 🟡 部分完成（仅后端/仅基础 CRUD/缺前端页面等）
> - ⬜ 未开始

## 一、登录 & 权限模块（必备）
1. ⬜ 管理员登录、退出
2. ⬜ 角色权限分离：**超级管理员、老师、学生**
3. ⬜ 密码修改、找回密码
4. ⬜ 登录日志、操作日志记录

## 二、学生信息管理（核心）
1. 🟡 学生 **新增、查询、编辑、删除**
   - ✅ 后端：`/api/students`
   - ✅ 前端：学生管理页
2. ✅ 自动生成 **学号**
   - ✅ 后端自动生成（前端不再填写）
3. 🟡 学生信息录入（扩展字段）
   - ✅ 已有：姓名、性别、出生日期、班级
   - ⬜ 待补：年龄、身份证、籍贯、入学时间、专业、头像等
   - ⬜ 手机号、邮箱：已从前端移除（如需要可恢复并补校验）
4. ⬜ 批量导入 Excel、批量导出 Excel
5. 🟡 条件筛选：按年级、班级、姓名搜索
   - ✅ 已支持：姓名、学号、班级（年级通过“年级→班级”选择体现）
   - ⬜ 待补：专业筛选
6. ⬜ 学生状态管理：正常、休学、退学、毕业

## 三、班级 & 专业 & 年级管理
1. ⬜ 年级管理：新增、编辑、停用（当前用 `classes.grade` 文本表达年级）
2. ⬜ 专业管理：专业名称、所属学院
3. ✅ 班级管理：基础 CRUD
   - ✅ 后端：`/api/classes`
   - ✅ 前端：班级管理页（按年级分组展示）
4. ⬜ 学院管理（高校版需要）

## 四、教师管理
1. 🟡 教师信息增删改查
   - ✅ 后端：`/api/teachers`
   - ⬜ 前端页面
2. ⬜ 教师编号自动生成
3. ⬜ 绑定授课班级、任教专业
4. ⬜ 教师账号分配、权限设置

## 五、课程 & 成绩管理（必做）
1. 🟡 课程信息管理：课程名、课程编号、学分、课时
   - ✅ 后端：`/api/courses`
   - ⬜ 前端页面
2. 🟡 排课管理：班级-课程-教师关联（当前以选课/关联为雏形）
   - ✅ 后端：`/api/enrollments`（学生选课关联）
   - ⬜ 完整排课：班级-课程-教师
3. 🟡 成绩录入、修改
   - ✅ 后端：`/api/grades`
   - ⬜ 前端页面、批量导入
4. ⬜ 成绩查询、按班级/学生统计
5. ⬜ 平均分、最高分、不及格统计

---

## 六、考勤管理（可选，加分功能）
1. ⬜ 学生考勤签到、缺勤、请假
2. ⬜ 考勤记录查询、统计报表
3. ⬜ 请假申请、审批流程

## 七、系统基础设置
1. ⬜ 菜单管理、角色权限配置
2. ⬜ 数据字典（性别、状态等）
3. ⬜ 系统参数配置、重置数据
4. ⬜ 图片上传、文件管理

## 八、统计报表（毕设加分项）
1. ⬜ 各专业/班级人数统计
2. ⬜ 男女比例图表
3. ⬜ 成绩分布柱状图、折线图
4. ⬜ 毕业、休学人数统计

---

# 最简版本（课程设计低配版，够用就能过）
只做这 6 个核心即可：
1. ⬜ 登录权限
2. ✅ 学生信息 CRUD + 学号自动生成
3. ✅ 班级管理（专业管理待补）
4. 🟡 课程管理（后端已完成）
5. 🟡 成绩录入与查询（后端已完成）
6. ⬜ Excel 导入导出

---

## 运行说明（开发）
### 后端
在项目根目录：

```bash
.\mvnw.cmd "-Dspring-boot.run.arguments=--server.port=9090" spring-boot:run
```

### 前端

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