# Mall

**Repository Path**: kule111/mall

## Basic Information

- **Project Name**: Mall
- **Description**: 这是一个完整的小型商场系统，包含用户端和管理端。
用户端 ：首页、商品浏览、搜索，商品详情、收藏商品，购物车、订单管理，用户注册/登录、个人中心
管理端 ：用户管理、商品管理、分类管理，订单管理、库存管理，促销管理、评价管理，公告管理、轮播图管理，数据统计
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 商城系统 (Online Mall)

## 项目简介

这是一个基于 Vue 3 + Spring Boot 的在线商城系统，前后端分离，前端统一入口登录后自动识别身份，用户进入商城页面，后台进入管理页面。

## 技术栈

### 后端
- Spring Boot 3.2.0
- MyBatis-Plus 3.5.5
- MySQL 8.0+
- Spring Security + JWT
- Hutool
- Apache POI

### 前端
- Vue 3
- Element Plus
- Pinia
- Vue Router
- Axios
- ECharts
- Sass

## 目录结构

```
ss/
├─ frontend/                # 前端（用户端 + 管理端合并）
│  ├─ src/
│  │  ├─ portal/            # 用户端（商城）
│  │  ├─ views/             # 管理端页面
│  │  ├─ components/        # 管理端组件
│  │  ├─ router/            # 路由与登录分流
│  │  └─ store/             # 管理端状态
│  └─ package.json
└─ backend/                 # 后端服务
   └─ src/main/java/com/mall/
      ├─ entity/
      ├─ mapper/
      ├─ service/
      ├─ controller/
      ├─ dto/
      ├─ vo/
      ├─ config/
      └─ common/
```

## 功能模块

### 用户端（商城）
- 首页展示、商品列表与搜索
- 商品详情、购物车、收藏
- 用户中心、登录/注册

### 管理端（后台）
- 仪表盘统计
- 用户管理、商品管理、分类管理
- 订单与退款处理
- 库存预警、促销、评价审核
- 公告、Banner、操作日志、管理员管理

## 快速开始

### 环境要求
- JDK 17+
- Node.js 18+
- MySQL 8.0+

### 后端启动

```bash
cd backend
# 配置 application.yml 中的数据库连接
mvn spring-boot:run
```

### 前端启动

```bash
cd frontend
npm install
npm run dev
```

### 访问入口
- 统一登录页：`http://localhost:5173/login`
- 管理后台：`http://localhost:5173/admin`
- 商城用户端：`http://localhost:5173/`

## 认证接口

- 用户登录：`POST /api/portal/auth/login`
- 用户注册：`POST /api/portal/auth/register`
- 后台登录：`POST /api/auth/login`
- 退出登录：`POST /api/auth/logout`

## License

MIT