# student-system

**Repository Path**: job-ego/student-system

## Basic Information

- **Project Name**: student-system
- **Description**: AI辅助工具改变程序猿一生
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-18
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# student-system

#### 介绍
{**以下是 Gitee 平台说明，您可以替换此简介**
student-system 是 使用deepseek自主设计的学生管理系统的代码托管平台，采用TRAE CN AI 工具自主编码生成的项目。

设计目的
”我要开发一个学生管理系统 前端用vue3 vite 服务端采用springboot3 mybatis-flex 给我TRAE CN提示词“

举例：
提示词1：
```
# 智能体名称：学生管理系统全栈开发助手

## 角色设定
你是一位顶级的全栈开发专家，精通Vue3、Spring Boot 3和MyBatis-Flex技术栈。你专门在TRAE CN IDE中工作，负责帮助学生开发者构建完整的学生管理系统。

## 核心使命
根据用户需求，生成高质量、可运行的学生管理系统代码，确保：
- 前端符合Vue3 + Vite + Element Plus最佳实践
- 后端符合Spring Boot 3 + MyBatis-Flex规范
- 代码结构清晰、可维护、无硬编码
- 遵循RESTful API设计原则

## 工作流程（自适应模式）
根据任务复杂度自动选择以下模式之一并声明：

### [简单模式] 直接回答
- 特征：单一技术问题、概念解释、语法查询
- 行动：直接给出简洁答案

### [标准模式] 分析-解决流程
- 特征：需要2-3步分析的任务（如接口设计、组件开发）
- 行动：
  1. 理解需求并分析技术可行性
  2. 设计方案并生成核心代码
  3. 验证代码完整性

### [深度模式] 完整三阶段协议
- 特征：复杂功能模块、系统架构设计、多文件协作
- 阶段：
  **Phase 1: 理解与规划**
  - 分解用户需求，明确技术约束
  - 识别关键模块和依赖关系
  - 评估实现方案可行性
  
  **Phase 2: 设计与决策**
  - 制定详细的技术实现方案
  - 权衡不同方案的利弊
  - 定义接口规范和数据结构
  
  **Phase 3: 实施与验证**
  - 生成完整代码（含必要注释）
  - 解释关键实现逻辑
  - 提出测试和优化建议

## 工具使用规范
- **文件操作**：使用`文件系统`工具读写项目文件
- **命令执行**：使用`终端`工具运行构建、测试命令
- **预览功能**：生成前端页面后使用`预览`工具展示效果
- **联网搜索**：遇到不确定的技术问题时使用`联网搜索`查询最新文档

## 代码质量标准
1. **绝对禁止**：
   - ❌ 硬编码（如写死的数据库连接、密钥）
   - ❌ 魔法值（如直接出现的数字、字符串常量）
   - ❌ 未使用的变量、函数、导入
   - ❌ 安全漏洞（如SQL注入、XSS）

2. **必须遵循**：
   - ✅ 所有公共API添加中文文档注释
   - ✅ 复杂逻辑添加行内注释（解释"为什么"）
   - ✅ 代码块标注语言和文件路径（如 ```java:src/main/...）
   - ✅ 遵循各技术栈的官方命名规范
   - ✅ 异常处理完善，有明确的错误提示

## 交互规范
- 默认使用中文回复，技术术语保持准确
- 复杂操作前输出思考过程
- 对模糊需求主动提问澄清
- 使用Markdown格式化输出
```


#### 软件架构
student-system/
├── pom.xml                                    # Maven配置文件
├── src/main/
│   ├── java/com/sms/
│   │   ├── StudentSystemApplication.java     # 主启动类
│   │   ├── common/                           # 公共模块
│   │   │   ├── result/Result.java           # 统一返回结果
│   │   │   └── exception/                   # 异常处理
│   │   │       ├── BusinessException.java
│   │   │       └── GlobalExceptionHandler.java
│   │   ├── controller/                       # 控制器层
│   │   │   ├── HealthController.java        # 健康检查接口
│   │   │   ├── StudentController.java       # 学生管理
│   │   │   ├── TeacherController.java       # 教师管理
│   │   │   ├── CourseController.java        # 课程管理
│   │   │   ├── ScoreController.java         # 成绩管理
│   │   │   └── UserController.java          # 用户管理
│   │   ├── service/                          # 服务层
│   │   │   ├── IStudentService.java
│   │   │   ├── ITeacherService.java
│   │   │   ├── ICourseService.java
│   │   │   ├── IScoreService.java
│   │   │   ├── IUserService.java
│   │   │   └── impl/                        # 实现类
│   │   │       ├── StudentServiceImpl.java
│   │   │       ├── TeacherServiceImpl.java
│   │   │       ├── CourseServiceImpl.java
│   │   │       ├── ScoreServiceImpl.java
│   │   │       └── UserServiceImpl.java
│   │   ├── mapper/                           # 数据访问层
│   │   │   ├── StudentMapper.java
│   │   │   ├── TeacherMapper.java
│   │   │   ├── CourseMapper.java
│   │   │   ├── ScoreMapper.java
│   │   │   └── UserMapper.java
│   │   └── entity/                           # 实体类
│   │       ├── Student.java
│   │       ├── Teacher.java
│   │       ├── Course.java
│   │       ├── Score.java
│   │       └── User.java
│   └── resources/
│       ├── application.yml                   # 应用配置
│       └── sql/
│           └── init.sql                      # 数据库初始化脚本



5张核心表：

1. student - 学生表（学号唯一、姓名、性别、年龄、班级、联系方式等）
2. teacher - 教师表（工号唯一、姓名、性别、年龄、所授科目等）
3. course - 课程表（课程编号唯一、课程名称、学分、课时、授课教师）
4. score - 成绩表（学生ID、课程ID、成绩、考试日期、学期）
5. user - 用户表（用户名唯一、密码、角色、关联人员ID）

User (1) ← (1) Student
User (1) ← (1) Teacher
Teacher (1) —— (N) Course
Student (1) —— (N) Score —— (1) Course

移动端项目结构

mobile/
├── package.json              # 项目依赖配置
├── vite.config.js           # Vite构建配置
├── manifest.json            # App配置
├── pages.json               # 页面路由配置
├── main.js                  # 入口文件
├── App.vue                  # 根组件
├── utils/
│   └── api.js              # API请求封装
├── store/
│   └── user.js              # 用户状态管理(Pinia)
└── pages/
├── login/login.vue      # 登录页面
├── index/index.vue      # 首页仪表盘
├── students/students.vue # 学生管理
├── teachers/teachers.vue # 教师管理
├── courses/courses.vue  # 课程管理
├── scores/scores.vue    # 成绩管理
└── profile/profile.vue  # 个人中心


#### 安装教程

1.  初始化数据库

```
mysql -u root -p < src/main/resources/sql/init.sql
```

2.  配置数据库连接 修改 application.yml 中的数据库密码：

```
spring:
  datasource:
    password: 你的数据库密码

```

3.  编译运行

```
cd /Users/ego/Documents/IDEA/student-system
mvn clean install
mvn spring-boot:run

```

4.  访问API


```
- 测试接口: http://localhost:8080/api/health
- API文档: http://localhost:8080/api/doc.html

```


#### 移动端配置

1.  运行方式
```
cd mobile
npm install
npm run dev:h5      # 运行H5网页版
npm run dev:mp-weixin  # 运行微信小程序

```

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)