# GIEP-FRONT

**Repository Path**: askanuo/giep-front

## Basic Information

- **Project Name**: GIEP-FRONT
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-13
- **Last Updated**: 2026-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SYSU-GIEP

This is a front-end project built with Vue 3, TypeScript, and Vite. It primarily supports the GIEP (Graduate Innovation and Entrepreneurship Program) platform of the School of Software, Sun Yat-sen University (SYSU). The project provides fully functional interfaces for different roles (such as administrator, mentor, enterprise, and student), supporting features like project management, topic posting, application management, and more.

---

## 🛠 Recommended Development Environment Configuration

- **IDE**: VS Code (recommended to install Vue, TypeScript, and Vite plugins)
- **TypeScript Support**: The project is configured to support type imports in `.vue` files
- **Build Tool**: Vite

---

## 📦 Project Setup

### Install Dependencies

```bash
npm install
```

---

## 🚀 Running in Development Environment

```bash
npm run dev
```

Compiles and starts the development server with hot-reload support.

---

## 🧹 Build for Production

```bash
npm run build
```

Compiles and minifies the code for production.

---

## 🧪 Run Unit Tests

Unit tests are conducted using [Vitest](https://vitest.dev/):

```bash
npm run test
```

---

## 📌 Code Linting and Formatting

Code style checks are performed using [ESLint](https://eslint.org/):

```bash
npm run lint
```

---

## 📁 Project Structure Overview

- **`src/views`**: Page components, categorized by role (administrator, mentor, enterprise, student, etc.)
- **`src/api`**: API request modules, categorized by role and functionality
- **`src/stores`**: State management using Pinia (e.g., user information, counters)
- **`src/router`**: Routing configuration
- **`src/utils`**: Utility functions (e.g., request wrappers)
- **`src/assets`**: Static resources (e.g., images)

---

## 🧩 Main Functional Modules

- **Login and Registration**
- **Administrator Module**
  - Project Management
  - User Management
  - Application Management
  - Dashboard
- **Mentor Module**
  - Project Posting and Management
- **Enterprise Module**
  - Topic Posting and Application
- **Student Module**
  - Topic Browsing and Application

---

## 🐳 Docker Support

The project includes complete Docker configurations for quick deployment in both production and development environments.

- **Production Environment**: Use `Dockerfile` and `docker-compose.yml`
- **Development Environment**: Use `Dockerfile.dev` and `docker-compose.dev.yml`

For detailed deployment instructions, please refer to [DOCKER_README.md](DOCKER_README.md)

---

## 📝 Technical Support

For assistance, please refer to the project documentation or contact the project maintainers.