# e-shop

**Repository Path**: henlf/e-shop

## Basic Information

- **Project Name**: e-shop
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-12
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# E-Shop 项目

前后端分离的电商管理系统

## 技术栈

### 后端
- Spring Boot 3.3.0
- Spring Security 6.3.0
- MyBatis 3.5.13
- MyBatis Plus 3.5.13
- PostgreSQL 15+
- Redis 7.0.14
- FastExcel (EasyExcel 3.3.2)
- JDK 17
- Maven 3.9.6
- Swagger/Knife4j 4.4.0

### 前端
- Vue 3.3.0
- Vue Router 4.3.0
- Vuex 4.3.0
- Element-Plus 2.3.14
- Axios 1.6.0
- Pinia 2.1.7
- Vite 5.0.0

## 项目结构

```
eshop-project/
├── backend/          # 后端项目
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/eshop/
│   │   │   │   ├── controller/    # 控制器
│   │   │   │   ├── service/       # 服务层
│   │   │   │   ├── mapper/        # 数据访问层
│   │   │   │   ├── entity/        # 实体类
│   │   │   │   ├── config/        # 配置类
│   │   │   │   └── common/        # 公共类
│   │   │   └── resources/
│   │   │       └── application.yml
│   │   └── test/
│   └── pom.xml
└── frontend/         # 前端项目
    ├── src/
    │   ├── components/   # 组件
    │   ├── views/        # 页面
    │   ├── router/       # 路由
    │   ├── store/        # 状态管理
    │   ├── api/          # API接口
    │   └── utils/        # 工具类
    ├── package.json
    └── vite.config.js
```

## 环境要求

- JDK 17+
- Maven 3.9.6+
- Node.js 16+
- PostgreSQL 15+
- Redis 7.0+

## 快速开始

### 1. 数据库准备

创建数据库：
```sql
CREATE DATABASE eshop WITH ENCODING 'UTF8';
```

### 2. 后端启动

1. 修改数据库配置（如需要）：
   编辑 `backend/src/main/resources/application.yml`，修改数据库连接信息

2. 启动后端：
```bash
cd backend
mvn clean install
mvn spring-boot:run
```

后端启动后访问：
- API地址: http://localhost:8080/api
- Swagger文档: http://localhost:8080/doc.html

### 3. 前端启动

1. 安装依赖：
```bash
cd frontend
npm install
```

2. 启动开发服务器：
```bash
npm run dev
```

前端启动后访问：http://localhost:3000

### 4. 测试前后端连接

1. 打开浏览器访问 http://localhost:3000
2. 点击页面上的"测试后端接口"按钮
3. 如果看到成功消息和返回数据，说明前后端连接成功

## API 接口

### 测试接口
- GET `/api/test/hello` - 测试接口，返回Hello消息

## 开发说明

### 后端开发
- 控制器放在 `controller` 包下
- 服务层放在 `service` 包下
- 数据访问层放在 `mapper` 包下
- 实体类放在 `entity` 包下

### 前端开发
- 页面组件放在 `views` 目录
- 公共组件放在 `components` 目录
- API接口定义在 `api` 目录
- 路由配置在 `router/index.js`

## 注意事项

1. 确保PostgreSQL和Redis服务已启动
2. 后端默认端口：8080
3. 前端默认端口：3000
4. 前端通过Vite代理访问后端API，无需配置CORS（开发环境）