# 项目1

**Repository Path**: dream-returns/project-1

## Basic Information

- **Project Name**: 项目1
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-22
- **Last Updated**: 2026-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 社区AI智能二手交易平台

基于 FastAPI + MySQL 的二手交易平台，提供完整的商品发布、交易、客服、统计等功能。

## 项目结构

```
project-1/
├── backend/                    # 后端代码
│   ├── app/
│   │   ├── api/v1/            # API 接口
│   │   │   ├── auth.py        # 认证接口
│   │   │   ├── users.py       # 用户接口
│   │   │   ├── items.py       # 商品接口
│   │   │   ├── transactions.py # 交易接口
│   │   │   ├── ai.py          # AI 接口
│   │   │   ├── analytics.py   # 数据分析接口
│   │   │   └── admin.py       # 管理后台接口
│   │   ├── ai/                # AI 功能模块
│   │   ├── analytics/         # 数据分析模块
│   │   ├── core/              # 核心配置
│   │   ├── models/            # 数据模型
│   │   ├── schemas/           # 数据验证
│   │   ├── services/          # 业务逻辑
│   │   ├── db/                # 数据库
│   │   └── main.py            # 入口
│   ├── requirements.txt       # 依赖列表
│   └── init_mysql_data.py     # 初始化脚本
│
├── frontend/                  # 前端页面
│   ├── index.html             # 首页
│   ├── login.html             # 登录
│   ├── register.html          # 注册
│   ├── categories.html        # 分类
│   ├── category-*.html        # 分类详情
│   ├── publish.html           # 发布商品
│   ├── product-detail.html    # 商品详情
│   ├── product-edit.html      # 商品编辑
│   ├── orders.html            # 订单
│   ├── payment.html           # 支付
│   ├── favorites.html         # 收藏
│   ├── my-items.html          # 我的商品
│   ├── profile.html           # 个人资料
│   ├── wallet.html            # 钱包
│   ├── settings.html          # 设置
│   ├── notifications.html     # 通知
│   ├── search-results.html    # 搜索
│   ├── chatbot.html           # AI 客服
│   ├── analytics.html         # 数据分析
│   ├── admin.html             # 管理后台
│   ├── help.html              # 帮助中心
│   ├── about.html             # 关于我们
│   ├── privacy.html           # 隐私政策
│   └── terms.html             # 服务条款
│
└── docs/                      # 文档
```

## 快速开始

### 1. 环境要求

- Python 3.8+
- MySQL 5.7+
- Node.js (可选，用于前端开发)

### 2. 安装依赖

```bash
cd backend
pip install -r requirements.txt
```

### 3. 配置数据库

编辑 `backend/.env` 文件（参考 `.env.example`）：

```env
DATABASE_URL=mysql+pymysql://root:123456@localhost:3306/onedata?charset=utf8mb4

# OpenAI (可选)
OPENAI_API_KEY=your-api-key

# 百度 AI (可选)
BAIDU_API_KEY=your-baidu-api-key
BAIDU_SECRET_KEY=your-baidu-secret-key
```

### 4. 初始化数据库

```bash
cd backend
python init_mysql_data.py
```

### 5. 启动后端服务

```bash
cd backend
python main.py
```

服务将在 `http://localhost:8000` 启动。

### 6. 访问前端页面

直接在浏览器中打开 `frontend/index.html` 即可。

## 功能模块

### 开发人员A - 用户与认证模块

- ✅ 用户注册/登录/登出
- ✅ JWT 令牌生成与验证
- ✅ 用户信息管理
- ✅ 密码加密与验证
- ✅ 数据库会话管理
- ✅ 配置文件加载

### 开发人员B - 商品与交易模块

- ✅ 商品发布/编辑/删除
- ✅ 商品分类管理
- ✅ 商品搜索与筛选
- ✅ 交易流程（下单-发货-收货-评价）
- ✅ 收藏功能

### 开发人员C - AI与数据分析模块

- ✅ 智能估价
- ✅ 图像识别（支持百度 AI）
- ✅ 精准匹配
- ✅ 风险检测
- ✅ AI 客服（支持 OpenAI + 本地知识库）
- ✅ 数据收集与可视化
- ✅ 价格趋势预测

### 开发人员D - 管理与前端模块

- ✅ 管理员后台
- ✅ 用户管理
- ✅ 商品管理
- ✅ 交易管理
- ✅ 举报/申诉处理
- ✅ 知识库管理
- ✅ 系统配置
- ✅ 用户个人中心
- ✅ 通知中心
- ✅ 完整的前端页面

## API 文档

启动后端服务后，访问以下地址查看 API 文档：

- Swagger UI: `http://localhost:8000/docs`
- ReDoc: `http://localhost:8000/redoc`

## 技术栈

### 后端

- **FastAPI**: 现代 Web 框架
- **SQLAlchemy**: ORM 库
- **MySQL**: 数据库
- **PyJWT**: JWT 认证
- **Pydantic**: 数据验证

### 前端

- **原生 HTML/CSS/JavaScript**: 无需框架，简单可靠
- **ECharts**: 数据可视化

### AI 集成

- **OpenAI**: 高级对话（可选）
- **百度 AI**: 图像识别（可选）
- **本地知识库**: 兜底方案（无需配置）

## 页面列表

| 页面 | 文件 | 功能 |
|-----|-----|-----|
| 首页 | index.html | 商品列表、导航 |
| 登录 | login.html | 用户登录 |
| 注册 | register.html | 用户注册 |
| 分类 | categories.html | 分类导航 |
| 分类详情 | category-*.html | 各分类商品列表 |
| 发布 | publish.html | 发布商品 |
| 商品详情 | product-detail.html | 商品信息、联系卖家 |
| 商品编辑 | product-edit.html | 编辑商品 |
| 订单 | orders.html | 订单管理 |
| 支付 | payment.html | 支付页面 |
| 收藏 | favorites.html | 收藏管理 |
| 我的商品 | my-items.html | 发布的商品管理 |
| 个人资料 | profile.html | 个人信息编辑 |
| 钱包 | wallet.html | 资金管理 |
| 设置 | settings.html | 账户设置 |
| 通知 | notifications.html | 消息通知 |
| 搜索 | search-results.html | 搜索结果 |
| AI客服 | chatbot.html | 智能客服对话 |
| 数据分析 | analytics.html | 数据可视化 |
| 管理后台 | admin.html | 后台管理 |
| 帮助中心 | help.html | 帮助文档 |
| 关于我们 | about.html | 平台介绍 |
| 隐私政策 | privacy.html | 隐私声明 |
| 服务条款 | terms.html | 服务协议 |

## 配置说明

### AI 服务配置

#### 百度 AI 配置（图像识别）

1. 访问 [百度 AI 开放平台](https://console.bce.baidu.com/)
2. 创建应用，选择「图像识别」
3. 获取 API Key 和 Secret Key
4. 填入 `.env` 配置文件

#### OpenAI 配置（AI 客服）

1. 访问 [OpenAI 平台](https://platform.openai.com/)
2. 创建 API Key
3. 填入 `.env` 配置文件

**注意**: 即使不配置任何 AI 服务，项目也能正常运行（使用本地模拟方案）。

## 数据库结构

### 核心表

- **users**: 用户表
- **user_profiles**: 用户资料表
- **item_categories**: 商品分类表
- **items**: 商品表
- **transactions**: 交易表
- **reports**: 举报表
- **appeals**: 申诉表
- **knowledge_bases**: 知识库表
- **system_configs**: 系统配置表
- **data_analytics**: 数据分析表

## 常见问题

### Q: 后端启动失败怎么办？

A: 检查以下几点：
1. MySQL 服务是否启动
2. 数据库连接配置是否正确
3. 端口 8000 是否被占用
4. Python 依赖是否完整安装

### Q: 前端点击没有反应？

A: 确保以下几点：
1. 后端服务已启动
2. 浏览器控制台没有错误
3. 使用本地服务器打开（而不是直接双击文件）

### Q: AI 功能不工作？

A: AI 功能是可选的，不配置也能正常运行模拟版本。如需真实功能，请配置相应的 API 密钥。

### Q: 如何添加测试数据？

A: 运行 `python init_mysql_data.py` 即可初始化数据库和添加测试数据。

## 开发指南

### 后端开发

API 路由位于 `backend/app/api/v1/`，新增接口请参考现有文件结构。

### 前端开发

前端使用原生 HTML + JS，页面位于 `frontend/`，公共样式保持一致。

## 许可证

MIT License

---

**版权所有 © 2026 社区AI智能二手交易平台**