# SYSU-GIEP.

**Repository Path**: askanuo/sysu-giep.

## Basic Information

- **Project Name**: SYSU-GIEP.
- **Description**: 前后端调联后的仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-09-06
- **Last Updated**: 2025-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 中山大学研究生院校企对接平台 (SYSU-GIEP)

一个基于Golang Gin框架和Vue.js的全栈校企对接平台，为中山大学研究生院提供企业需求与研究生匹配服务。

## 🚀 项目简介

本项目是一个完整的校企对接平台，包含：
- **后端服务** (`back/`): 基于Golang Gin框架的高并发API服务
- **前端界面** (`front/`): 基于Vue.js 3 + TypeScript的现代化Web界面

## 📋 主要功能

### 用户管理
- 企业端注册认证
- 导师/学生端注册认证  
- 高校管理端账号审核
- 角色权限管理(RBAC)

### 课题管理
- 课题发布与编辑
- 课题检索与筛选
- 课题申请与审批
- 智能匹配算法

### 匹配管理
- 双向匹配算法
- 申请记录管理
- 匹配确认流程
- 手动匹配功能
- 数据统计分析

## 🛠 技术栈

### 后端技术
- **Web框架**: Gin
- **数据库ORM**: GORM
- **数据库**: MySQL/PostgreSQL
- **缓存**: Redis
- **认证**: JWT
- **API文档**: Apifox + OpenAPI 3.0
- **配置管理**: Viper
- **日志**: Zap
- **容器化**: Docker + Docker Compose

### 前端技术
- **框架**: Vue.js 3
- **语言**: TypeScript
- **构建工具**: Vite
- **UI组件库**: Element Plus
- **状态管理**: Pinia
- **路由**: Vue Router
- **图表**: ECharts
- **HTTP客户端**: Axios

## 📦 项目结构

```
sysu-giep/
├── back/                    # 后端服务
│   ├── cmd/                # 应用程序入口
│   ├── internal/           # 内部包
│   │   ├── api/           # API层
│   │   ├── config/        # 配置管理
│   │   ├── database/      # 数据库相关
│   │   ├── service/       # 业务逻辑层
│   │   └── util/          # 工具函数
│   ├── pkg/               # 可导出的包
│   ├── docs/              # API文档
│   ├── scripts/           # 脚本文件
│   ├── configs/           # 配置文件
│   └── README.md          # 后端详细文档
├── front/                  # 前端应用
│   ├── src/               # 源代码
│   │   ├── api/           # API接口
│   │   ├── views/         # 页面组件
│   │   ├── stores/        # 状态管理
│   │   ├── router/        # 路由配置
│   │   └── utils/         # 工具函数
│   ├── public/            # 静态资源
│   └── README.md          # 前端详细文档
└── README.md              # 项目总览
```

## 🚀 快速开始

### 环境要求

- Go 1.24+
- Node.js 20.19.0+ 或 22.12.0+
- MySQL 8.0+
- Redis 7.0+
- Docker & Docker Compose (可选)

### 克隆项目

```bash
git clone https://gitee.com/askanuo/sysu-giep.git
cd sysu-giep
```

### 后端启动

```bash
cd back
# 安装依赖
go mod tidy

# 配置数据库
# 编辑 configs/config.yaml

# 运行应用
go run cmd/server/main.go
```

### 前端启动

```bash
cd front
# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

### Docker部署

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

## 📚 详细文档

- [后端API文档](back/README.md)
- [前端开发文档](front/README.md)
- [API接口文档](back/docs/api-overview.md)

## 🔧 配置说明

### 后端配置
编辑 `back/configs/config.yaml` 文件，配置数据库连接、Redis连接等信息。

### 前端配置
前端配置通过环境变量管理，详见 `front/README.md`。

## 🧪 测试

### 后端测试
```bash
cd back
make test
```

### 前端测试
```bash
cd front
npm run test:unit
```

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](back/LICENSE) 文件了解详情。

## 📞 联系方式

- 项目维护者: askanuo
- 项目地址: [https://gitee.com/askanuo/sysu-giep](https://gitee.com/askanuo/sysu-giep)

## 🙏 致谢

感谢所有为这个项目做出贡献的开发者和用户。