# Shopping

**Repository Path**: wyc2211/shopping

## Basic Information

- **Project Name**: Shopping
- **Description**: 简单的商城系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-17
- **Last Updated**: 2025-12-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 商城项目 (Shopping Project)

这是一个基于 Spring Boot 和 Vue.js 构建的全栈分离电商项目。

## ✨ 项目简介

本项目是一个功能完善的在线商城，实现了从用户注册登录、商品浏览、购物车、下单到后台管理等一系列核心电商功能。

- **后端** 采用 Java Spring Boot 技术栈，保证了服务的稳定和高效。
- **前端** 采用现代化的 Vue 3 和 Vite，为用户提供了流畅和响应式的操作体验。

## 🚀 技术栈

### 后端

- **核心框架**: Spring Boot 3.2
- **安全认证**: Spring Security, JWT (jjwt)
- **数据存储**: MySQL, Redis, MyBatis
- **项目管理**: Maven
- **开发语言**: Java 17

### 前端

- **核心框架**: Vue 3
- **构建工具**: Vite
- **路由**: Vue Router
- **状态管理**: Pinia
- **UI 组件库**: Element Plus
- **HTTP 通信**: Axios
- **开发语言**: TypeScript

## 📦 功能列表

- 用户注册与登录
- 商品分类展示
- 商品列表与搜索
- 商品详情展示
- 购物车管理 (添加、删除、修改数量)
- 创建订单
- 订单列表与详情查看
- 用户个人中心
- (管理员) 用户管理
- (管理员) 数据库初始化

## 🛠️ 快速开始

请确保您的开发环境中已安装以下软件：

- JDK 17+
- Maven 3.6+
- Node.js 18+
- MySQL 8.0+
- Redis

### 1. 后端启动

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

# 2. 进入后端目录
cd Shopping-master/backend

# 3. 配置数据库
#    - 创建一个名为 `store` 的数据库。
#    - 导入 `src/main/resources/db/` 目录下的 `init.sql` 和 `data.sql` 文件。
#    - 修改 `src/main/resources/application.yml` 文件，更新您的 MySQL 和 Redis 连接信息（地址、用户名、密码）。

# 4. 使用 Maven 安装依赖并启动项目
mvn spring-boot:run
```

后端服务默认运行在 `http://localhost:8080`。

### 2. 前端启动

```bash
# 1. 进入前端目录
cd Shopping-master/frontend

# 2. 安装依赖
npm install

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

前端开发服务器默认运行在 `http://localhost:5173`。现在您可以通过浏览器访问该地址来查看商城页面。

> **注意**: 前端项目已通过 Vite 配置了代理，所有对 `/api` 的请求都会自动转发到 `http://localhost:8080/api`，无需手动处理跨域问题。

## 📁 项目结构

```
Shopping-master/
├── backend/         # 后端 Spring Boot 项目
│   ├── src/
│   └── pom.xml
├── frontend/        # 前端 Vue 项目
│   ├── src/
│   └── package.json
└── README.md        # 项目说明
```

## 📄 API 文档

详细的后端 API 接口说明请参考 `backend/API文档.md` 文件。