# trading_platform

**Repository Path**: pearl13/trading_platform

## Basic Information

- **Project Name**: trading_platform
- **Description**: 用于开发二手交易平台
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-09-07
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 二手交易平台 - 环境安装与系统使用说明

## 项目概述
这是一个基于Vue 3 + Django的二手物品交易平台，包含前端Vue应用和后端Django REST API服务。

## 一、环境要求

### 系统要求
- **操作系统**: Windows 10/11
- **内存**: 至少4GB
- **磁盘空间**: 至少2GB可用空间

### 软件要求
- **Node.js**: LTS版本 (用于前端开发)
- **Python**: 3.8+ (用于后端开发)
- **数据库**: SQLite (默认) 或 MySQL

## 二、前端环境安装

### 1. 安装Node.js
1. 访问 [Node.js官网](https://nodejs.org/)
2. 下载LTS版本（长期支持版）
3. 运行安装程序，使用默认设置
4. 验证安装：
```bash
node --version
npm --version
```

### 2. 安装前端依赖
```bash
cd secondhand-platform
npm install
```

### 3. 启动前端开发服务器
```bash
npm run dev
```
服务器启动后访问：http://localhost:5173/

## 三、后端环境安装

### 1. 安装Python依赖
```bash
cd backend
pip install -r requirements.txt
```

### 2. 数据库迁移
```bash
python manage.py migrate
```

### 3. 创建超级用户
```bash
python manage.py createsuperuser
```

### 4. 启动后端服务器
```bash
python manage.py runserver
```
服务器启动后访问：http://localhost:8000/

## 四、项目结构

### 前端项目 (secondhand-platform/)
```
src/
├── assets/          # 静态资源
├── components/      # Vue组件
├── views/          # 页面视图
├── router/         # 路由配置
├── stores/         # 状态管理
├── api/            # API接口
└── main.js         # 应用入口
```

### 后端项目 (backend/)
```
product/            # 商品应用
├── models.py       # 数据模型
├── views.py        # 视图函数
├── serializers.py  # 序列化器
└── urls.py         # 路由配置
secondhand_market/  # 项目配置
├── settings.py     # 项目设置
└── urls.py         # 主路由
```

## 五、主要功能模块

### 1. 用户认证
- 用户注册/登录
- JWT令牌认证
- 用户信息管理

### 2. 商品管理
- 商品发布/编辑
- 商品分类浏览
- 商品搜索功能

### 3. 购物车功能
- 添加商品到购物车
- 购物车商品管理
- 订单创建

### 4. 订单管理
- 订单创建
- 订单状态跟踪
- 订单历史查看

## 六、API接口说明

### 认证接口
- `POST /api/auth/login` - 用户登录
- `POST /api/auth/register` - 用户注册
- `GET /api/user/info` - 获取用户信息

### 商品接口
- `GET /api/products` - 获取商品列表
- `GET /api/products/{id}` - 获取商品详情
- `POST /api/products` - 发布商品

### 购物车接口
- `GET /api/cart` - 获取购物车
- `POST /api/cart` - 添加商品到购物车
- `DELETE /api/cart/{itemId}` - 删除购物车商品

## 七、数据格式

### 用户信息
```javascript
{
  id: number,
  username: string,
  phone: string,
  avatar: string,
  email: string,
  bio: string
}
```

### 商品信息
```javascript
{
  id: number,
  title: string,
  price: number,
  images: string[],
  description: string,
  category: string,
  condition: string
}
```

## 八、常用命令

### 前端命令
- `npm run dev` - 启动开发服务器
- `npm run build` - 构建生产版本
- `npm run preview` - 预览生产版本

### 后端命令
- `python manage.py runserver` - 启动开发服务器
- `python manage.py migrate` - 执行数据库迁移
- `python manage.py createsuperuser` - 创建管理员

## 九、故障排除

### 常见问题
1. **端口占用**: Vite会自动选择其他端口
2. **依赖安装失败**: 删除node_modules后重新安装
3. **数据库连接错误**: 检查数据库配置

### 开发工具推荐
- **代码编辑器**: VS Code (安装Vetur插件)
- **浏览器**: Chrome/Edge (用于开发者工具)

## 十、部署说明

### 前端部署
```bash
npm run build
```
生成的文件在 `dist/` 目录中

### 后端部署
配置生产环境设置，使用WSGI服务器部署

---

按照以上步骤即可完成环境配置并运行完整的二手交易平台系统。

## 使用说明
- 访问前端页面进行用户注册或登录。
- 浏览商品列表并查看商品详情。
- 将商品加入购物车并进行下单操作。
- 查看订单状态并管理个人发布的商品。

## 参与贡献
1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 其他详细文档
- 前端相关详细文档见 [前端README](./secondhand-platform/README.md)
- gitee仓库见 https://gitee.com/pearl13/trading_platform.git