# student-web

**Repository Path**: xhyyxl/student-web

## Basic Information

- **Project Name**: student-web
- **Description**: 基于vue+go的学生管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-12
- **Last Updated**: 2025-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学生管理系统

一个基于Vue 3 + Go的学生管理系统，提供完整的学生信息管理功能。

## 技术栈

### 前端
- Vue 3
- TypeScript
- Element Plus
- Vite
- Pinia (状态管理)
- Vue Router

### 后端
- Go 1.21+
- Gin (Web框架)
- GORM (ORM)
- JWT (认证)
- MySQL 8.0

## 项目结构

```
student-web/
├── frontend/          # Vue前端项目
├── backend/           # Go后端项目
├── docs/             # 项目文档
└── docker-compose.yml # Docker编排文件
```

## 快速开始

### 环境要求
- Node.js 18+
- Go 1.21+
- MySQL 8.0
- Docker (可选)

### 1. 克隆项目
```bash
git clone <repository-url>
cd student-web
```

### 2. 启动后端服务
```bash
cd backend
go mod tidy
go run cmd/main.go
```

### 3. 启动前端服务
```bash
cd frontend
npm install
npm run dev
```

### 4. 访问系统
- 前端地址: http://localhost:3000
- 后端API: http://localhost:8080

## Docker部署

```bash
# 构建并启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 停止服务
docker-compose down
```

## 开发指南

### 后端开发
1. 进入backend目录
2. 修改配置文件 `config/config.yaml`
3. 运行 `go run cmd/main.go`

### 前端开发
1. 进入frontend目录
2. 安装依赖 `npm install`
3. 启动开发服务器 `npm run dev`

## API文档

启动后端服务后，访问 http://localhost:8080/swagger/index.html 查看API文档。

## 功能特性

- ✅ 用户认证与授权
- ✅ 学生信息管理
- ✅ 课程信息管理
- ✅ 成绩管理
- ✅ 班级管理
- ✅ 数据导入导出
- ✅ 权限控制

## 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

## 许可证

MIT License