# tree-mall

**Repository Path**: DaFengChe856/tree-mall

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-20
- **Last Updated**: 2026-03-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tree-Mall 电商平台

全栈电商项目，采用前后端分离架构。

## 技术栈

### 后端
- **运行时**: Node.js / Bun.js
- **框架**: Nest.js
- **数据库**: MySQL (阿里云 RDS)
- **缓存**: Redis (阿里云 Redis)
- **ORM**: TypeORM
- **认证**: JWT + Passport

### 前端 Web 管理后台
- **构建工具**: Vite
- **框架**: Vue 3
- **语言**: TypeScript
- **UI 框架**: Element Plus
- **状态管理**: Pinia
- **请求**: Axios

### 微信小程序
- **框架**: Taro 4
- **Vue 版本**: Vue 3
- **语言**: TypeScript

## 项目结构

```
tree-mall/
├── server/               # 后端 Nest.js
│   ├── src/
│   │   ├── config/      # 配置模块
│   │   ├── entities/    # 数据库实体
│   │   ├── modules/    # 业务模块
│   │   │   ├── auth/    # 认证模块
│   │   │   ├── category/# 分类模块
│   │   │   ├── product/ # 商品模块
│   │   │   ├── cart/    # 购物车模块
│   │   │   ├── order/   # 订单模块
│   │   │   └── coupon/  # 优惠券模块
│   │   └── app.module.ts
│   └── config/          # 配置文件
├── admin-web/           # Web 管理后台
│   ├── src/
│   │   ├── api/        # API 请求
│   │   ├── router/     # 路由配置
│   │   ├── stores/     # Pinia 状态管理
│   │   └── views/      # 页面组件
│   └── dist/           # 构建输出
└── miniprogram/        # 微信小程序
    ├── src/
    │   ├── pages/      # 页面
    │   └── utils/     # 工具函数
    └── config/        # Taro 配置
```

## 快速开始

### 后端启动

```bash
cd server

# 安装依赖
npm install

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，配置数据库和 Redis

# 启动开发服务器
npm run start:dev
```

后端运行在 http://localhost:3000

### Web 管理后台启动

```bash
cd admin-web

# 安装依赖
npm install

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

管理后台运行在 http://localhost:5173

### 微信小程序启动

```bash
cd miniprogram

# 安装依赖
npm install

# 开发微信小程序
npm run dev:weapp

# 开发 H5
npm run dev:h5
```

## API 文档

### 认证模块

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /auth/register | 用户注册 |
| POST | /auth/login | 用户登录 |
| POST | /auth/wechat | 微信登录 |
| GET | /auth/profile | 获取用户信息 |
| PUT | /auth/profile | 更新用户信息 |

### 商品模块

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /products | 商品列表 (管理) |
| GET | /products/on-sale | 在售商品列表 |
| GET | /products/:id | 商品详情 |
| POST | /products | 创建商品 (管理员) |
| PUT | /products/:id | 更新商品 (管理员) |
| DELETE | /products/:id | 删除商品 (管理员) |

### 分类模块

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /categories | 分类列表 |
| GET | /categories/tree | 分类树形结构 |
| GET | /categories/:id | 分类详情 |
| POST | /categories | 创建分类 (管理员) |
| PUT | /categories/:id | 更新分类 (管理员) |
| DELETE | /categories/:id | 删除分类 (管理员) |

### 购物车模块

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /cart | 获取购物车列表 |
| GET | /cart/summary | 获取购物车摘要 |
| POST | /cart/items | 添加商品到购物车 |
| PUT | /cart/items/:id | 更新购物车商品 |
| DELETE | /cart/items/:id | 删除购物车商品 |
| DELETE | /cart/clear | 清空购物车 |

### 订单模块

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /orders | 创建订单 |
| GET | /orders | 订单列表 |
| GET | /orders/:id | 订单详情 |
| PUT | /orders/:id/cancel | 取消订单 |
| PUT | /orders/:id/status | 更新订单状态 (管理员) |

### 优惠券模块

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /coupons | 优惠券列表 (管理员) |
| GET | /coupons/available | 可用优惠券 |
| GET | /coupons/my | 我的优惠券 |
| POST | /coupons | 创建优惠券 (管理员) |
| POST | /coupons/:id/receive | 领取优惠券 |

## 数据库表

- `users` - 用户表
- `categories` - 商品分类表
- `products` - 商品表
- `carts` - 购物车表
- `orders` - 订单表
- `order_items` - 订单明细表
- `coupons` - 优惠券表
- `user_coupons` - 用户优惠券表

## 环境变量

### 后端 (.env)

```env
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=password
DB_DATABASE=tree_mall

REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0

APP_PORT=3000
JWT_SECRET=your-jwt-secret
JWT_EXPIRES_IN=7d

WECHAT_APP_ID=your-wechat-appid
WECHAT_SECRET=your-wechat-secret
```

## 开发计划

- [x] 项目初始化
- [x] MySQL + Redis 配置
- [x] 数据库 Schema 设计
- [x] 后端 API 开发
- [x] Web 管理后台开发
- [ ] 微信小程序开发
- [ ] 微信登录集成
- [ ] 微信支付集成

## 许可证

MIT License