# 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-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mall-sim 项目说明

## 项目概述

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

## 技术栈

### 后端技术栈
- **框架**: NestJS
- **语言**: TypeScript
- **数据库**: MySQL
- **ORM**: TypeORM
- **认证**: JWT
- **微服务**: 多个独立应用（mall-oms、mall-pms、mall-sms、mall-ums、youlai-system 等）

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

## 项目结构

```
mall-sim/
├── back-end/           # 后端代码
│   ├── apps/           # 微服务应用
│   │   ├── mall-oms/     # 订单管理服务
│   │   ├── mall-pms/     # 商品管理服务
│   │   ├── mall-sms/     # 营销服务
│   │   ├── mall-ums/     # 用户管理服务
│   │   ├── youlai-auth/  # 认证服务
│   │   ├── youlai-gateway/ # 网关服务
│   │   ├── youlai-system/ # 系统管理服务
│   ├── libs/            # 共享库
│   ├── docs/            # 文档
│   ├── uploads/         # 上传文件
│   ├── package.json     # 后端依赖
│   └── nest-cli.json    # NestJS 配置
├── front-end/          # 前端代码
│   ├── src/            # 源代码
│   │   ├── api/         # API 接口
│   │   ├── components/  # 组件
│   │   ├── home/        # 首页相关
│   │   ├── layout/      # 布局
│   │   ├── router/      # 路由
│   │   ├── store/       # 状态管理
│   │   ├── views/       # 页面
│   │   └── utils/       # 工具函数
│   ├── package.json     # 前端依赖
│   └── vite.config.ts   # Vite 配置
└── README.md           # 项目说明
```

## 开发环境搭建

### 后端环境

1. **安装依赖**
   ```bash
   cd back-end
   npm install
   ```

2. **配置环境变量**
   - 复制 `.env.example` 文件为 `.env`
   - 配置数据库连接等信息

3. **启动服务**
   ```bash
   # 启动所有服务
   npm run start:dev
   
   # 启动指定服务
   npm run start:dev -- youlai-system
   ```

### 前端环境

1. **安装依赖**
   ```bash
   cd front-end
   npm install
   ```

2. **配置环境变量**
   - 复制 `.env.development` 文件为 `.env.local`
   - 配置 API 基础 URL 等信息

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

## 打包部署

### 后端部署

1. **构建生产版本**
   ```bash
   cd back-end
   npm run build
   ```

2. **启动生产服务**
   ```bash
   # 启动所有服务
   npm run start:prod
   
   # 启动指定服务
   npm run start:prod -- youlai-system
   ```

### 前端部署

1. **构建生产版本**
   ```bash
   cd front-end
   npm run build
   ```

2. **部署到服务器**
   - 将 `dist` 目录下的文件复制到服务器的 web 根目录
   - 配置 Nginx 或其他 web 服务器

   **Nginx 配置示例**:
   ```nginx
   server {
       listen 80;
       server_name example.com;
       
       location / {
           root /path/to/dist;
           index index.html;
           try_files $uri $uri/ /index.html;
       }
       
       location /api {
           proxy_pass http://localhost:8200;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       }
   }
   ```

## 核心功能模块

### 后端模块

1. **系统管理 (youlai-system)**
   - 用户管理
   - 角色管理
   - 菜单管理
   - 部门管理
   - 字典管理
   - 文件管理
   - 外贸公司信息管理

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

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

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

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

### 前端模块

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

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

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

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

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

## 环境变量配置

### 后端环境变量 (`back-end/.env`)

```env
# 数据库连接信息
DATABASE_HOST=localhost
DATABASE_PORT=3306
DATABASE_USERNAME=root
DATABASE_PASSWORD=123456
DATABASE_NAME=mall-sim

# JWT 配置
JWT_SECRET=your-secret-key
JWT_EXPIRES_IN=7d

# 上传文件配置
UPLOAD_PATH=./uploads
```

### 前端环境变量 (`front-end/.env.production`)

```env
# API 基础 URL
VITE_APP_BASE_API=/api

# 上传文件路径
VITE_APP_UPLOAD_URL=/api/youlai-system/api/v1/files/upload
```

## 数据库初始化

1. **创建数据库**
   - 执行 `back-end/docs/sql/mysql8/database.sql` 创建数据库

2. **导入表结构**
   - 执行对应服务的 SQL 文件，如 `back-end/docs/sql/mysql8/youlai_system.sql`

## 常见问题

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

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

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

## 许可证

MIT License

## 联系方式

如有问题，请联系项目维护者。