# mall-sim

**Repository Path**: guyongqi/mall-sim

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mall-sim 项目说明

## 项目概述

mall-sim 是一个基于 NestJS + Vue 3 的电商模拟系统，包含完整的前后端功能，支持商品管理、订单管理、用户管理、Banner 管理等核心功能。

## 技术栈

### 后端技术栈
- **框架**: NestJS
- **语言**: TypeScript
- **数据库**: MySQL
- **ORM**: TypeORM
- **缓存**: Redis
- **认证**: JWT

### 前端技术栈
- **框架**: Vue 3
- **语言**: TypeScript
- **构建工具**: Vite
- **UI 框架**: Element Plus
- **状态管理**: Pinia
- **路由**: Vue Router
- **样式**: SCSS / Less

## 项目结构

\\\
mall-sim/
├── server/              # 后端代码（单体服务）
│   ├── src/
│   │   ├── modules/     # 功能模块
│   │   │   ├── auth/    # 认证模块
│   │   │   ├── system/  # 系统管理模块
│   │   │   ├── oms/     # 订单管理模块
│   │   │   ├── pms/     # 商品管理模块
│   │   │   ├── sms/     # 营销管理模块
│   │   │   └── ums/     # 用户管理模块
│   │   ├── common/      # 公共模块
│   │   ├── app.module.ts
│   │   └── main.ts
│   ├── uploads/         # 上传文件
│   ├── .env             # 环境配置
│   └── package.json
├── front-end/           # 前端代码
│   ├── src/
│   │   ├── api/         # API 接口
│   │   ├── components/  # 组件
│   │   ├── home/        # 首页相关
│   │   ├── layout/      # 布局
│   │   ├── router/      # 路由
│   │   ├── store/       # 状态管理
│   │   ├── views/       # 页面
│   │   └── utils/       # 工具函数
│   ├── .env.development
│   └── package.json
└── README.md
\\\

## 开发环境搭建

### 前置条件

确保你的机器已安装：
- **Node.js** (建议 v18+)
- **MySQL 8.0**
- **Redis 7.0**

### 1. 启动 MySQL 和 Redis

**Docker 方式（推荐）**
\\\ash
docker-compose -f docker-compose.infrastructure.yml up -d
\\\

**本地已有服务**

确保 MySQL 在端口 3306 运行，Redis 在端口 6379 运行。

### 2. 初始化数据库

执行 server/sql/ 下的 SQL 脚本创建数据库和表结构。

### 3. 启动后端

\\\ash
cd server
pnpm install
pnpm dev    # 开发模式启动，端口 3000
\\\

### 4. 启动前端

\\\ash
cd front-end
npm install
npm run dev    # 开发服务器，默认端口 5173
\\\

## 环境变量配置

### 后端 (server/.env)

\\\env
PORT=3000

DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=123456
DB_DATABASE=mall
DB_CHARSET=utf8mb4

REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0

JWT_SECRET=mall-sim-secret-key-2026
JWT_ACCESS_EXPIRES_IN=30m
JWT_REFRESH_EXPIRES_IN=7d
\\\

### 前端 (ront-end/.env.development)

\\\env
VITE_APP_BASE_API=http://localhost:3000
\\\

## 核心功能模块

### 后端模块

1. **系统管理 (system)**
   - 用户管理
   - 角色管理
   - 菜单管理
   - 部门管理
   - 字典管理
   - 文件管理

2. **商品管理 (pms)**
   - 商品分类
   - 品牌管理
   - 商品管理
   - SKU 管理

3. **订单管理 (oms)**
   - 订单管理
   - 订单物流
   - 订单支付

4. **营销管理 (sms)**
   - Banner 管理
   - 广告管理
   - 优惠券管理

5. **用户管理 (ums)**
   - 会员管理
   - 地址管理

6. **认证 (auth)**
   - 登录/注册
   - Token 刷新
   - 验证码

### 前端模块

1. **系统管理**
   - 用户管理页面
   - 角色管理页面
   - 菜单管理页面
   - 部门管理页面
   - Banner 管理页面

2. **商品管理**
   - 商品分类页面
   - 品牌管理页面
   - 商品管理页面

3. **订单管理**
   - 订单列表页面

4. **营销管理**
   - Banner 管理页面
   - 广告管理页面
   - 优惠券管理页面

5. **首页**
   - 轮播图展示
   - 公司信息展示
   - 产品中心
   - 公司简介
   - 联系我们

## 常见问题

### 后端服务启动失败
- 检查数据库连接是否正常
- 检查端口是否被占用
- 检查环境变量配置是否正确

### 前端页面无法访问后端 API
- 检查 API 基础 URL 配置是否正确
- 检查后端服务是否正常运行
- 检查 CORS 配置是否正确

### 文件上传失败
- 检查上传路径权限是否正确
- 检查文件大小限制是否合适
- 检查文件类型是否被允许

## License

MIT License