# Yanyuan SwapHub

**Repository Path**: zhihao2023/yanyuan-swap-hub

## Basic Information

- **Project Name**: Yanyuan SwapHub
- **Description**: 北京大学校内跳蚤市场
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-19
- **Last Updated**: 2025-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 北京大学校内跳蚤市场

## 项目wiki

[OpenDeepWiki](https://opendeep.wiki/zhihao2023/yanyuan-swap-hub)

## 项目介绍

### 目的说明

本项目是一个面向北京大学师生的校内二手交易平台，旨在为校园内二手物品的交易提供一个便捷且安全的服务环境。

### 核心目标与愿景

- 设计并实现一个响应式、用户友好的交易界面，支持按关键词搜索商品。
- 提供个人信息管理及商品发布、修改功能。
- 实现商品详情展示及评论、价格管理。
- 支持商品图片上传、发布及关注商品的信息提醒。
- 促进校园内二手物品的安全交易，提升用户体验和交互便捷性。

### 目标受众

- 北京大学在校师生。

### 技术领域

- 前端采用HTML、CSS及JavaScript技术栈。
- 后端使用Python和Flask框架。
- 以SQLite作为数据库存储。
- 具备Web应用及数据库管理技术特征。

## 主要业务流程

### 用户登录

```mermaid
flowchart LR
    K[用户点击登录/注册] --> L{新用户?}
    L -->|是| M[填写注册信息]
    M --> N[后端验证信息]
    N --> O[发送邮箱验证码]
    O --> P[用户提交验证码]
    P --> Q[验证通过]
    L -->|否| R[输入账号密码]
    R --> S[后端验证凭证]
    S --> T[生成登录态]
```

### 发布商品

```mermaid
flowchart LR
    U[用户登录] --> P[进入个人页面]
    P --> V[进入发布页面]
    V --> W[填写商品信息]
    W --> Y[后端接收提交]
    Y --> Z[校验数据完整性]
    Z --> AB[写入数据库]
    AB --> AC[返回发布结果]
	
```

### 浏览商品

```mermaid
flowchart LR
    A[用户登录] --> B[打开商品列表页面]
    B --> C[后端返回商品列表数据]
    C --> D[渲染商品列表页]
    D --> F[用户点击商品]
    F --> G[后端返回商品详情数据]
    G --> J[渲染商品详情页]
```

### 交易流程（简化版）

```mermaid
flowchart TD
    subgraph 卖家
        AA[发布商品] --> AB[联系买家] --> AC[修改商品完成信息]
    end

    subgraph 买家
        BA[浏览商品] --> BB[联系卖家]
    end
    
    AC -.-> A[新增交易记录]
    
    classDef highlight fill:#f9f,stroke:#333;
    class T,Q highlight;
```



## 功能特性

### 1. 商品列表界面

- 搜索功能：支持按关键词搜索商品
- 响应式布局：根据屏幕改变布局

![image-20250607160714370](.\documents\image-20250607160714370.png)

### 2. 个人信息界面

- 交易地址管理
- 个人信息编辑
- 发布商品管理

![image-20250607161357188](.\documents\image-20250607161357188.png)

### 3. 商品详情界面

- 商品图片展示
- 详细描述
- 评论区
- 商品信息修改（只有卖家可以修改）

![image-20250607161548153](.\documents\image-20250607161548153.png)

![image-20250607161751437](.\documents\image-20250607161751437.png)

### 4. 发布界面

- 商品图片上传
- 商品描述编辑
- 价格设置

![image-20250607161837822](.\documents\image-20250607161837822.png)

### 5. 关注界面

- 商品图片展示
- 简要描述
- 价格显示
- 新消息提醒

### 6. 发布商品列表界面

- 商品图片展示
- 简要描述
- 价格显示
- 新消息提醒

### 7. 交易记录界面

- 商品图片展示
- 简要描述
- 价格显示

![image-20250607161916600](.\documents\image-20250607161916600.png)

### 8. 登录界面

- 邮箱注册
- 邮箱登录

![image-20250607160243592](.\documents\image-20250607160243592.png)

### 9. 主页

- 介绍信息

![image-20250607160610573](.\documents\image-20250607160610573.png)

## 团队分工

### 前端开发

- kutuva：负责个人信息界面（发布修改商品）
- 张艺硕：负责主交易界面
- 唐宇：负责商品列表界面
- 潘宇辉：负责商品详情界面
- 马子豪：负责补充界面
  - 登录界面
  - 主界面

### 后端开发

- 马子豪：负责后端开发

## 技术栈

- 前端：html+css+javascript
- 后端：python+flask
- 数据库：sqlite

[二手交易平台后端 API 文档](./api_doc.md)