# 校园二手交易小程序

## 1. 系统简介

本项目是一个功能完善的校园二手交易微信小程序，旨在为大学校园内的学生和教职工提供一个安全、便捷、高效的二手物品交易平台。系统不仅包含了完整的商品交易流程，还融入了丰富的社交和实用功能，构建了一个活跃的校园社区生态。

### 主要功能模块

- **商品模块**：用户可以轻松发布、编辑、下架自己的二手商品，支持图文描述、价格、分类、交易地点等信息。
- **交易流程**：实现了从创建订单、买家支付（模拟）、卖家确认、买家收货到交易完成的全闭环流程。
- **求购广场**：用户可以发布求购信息，寻找自己需要的物品，其他用户可以响应求购。
- **智能定价**：支持用户上传二手商品，生成闲置商品破损程度分析和定价建议
- **实时聊天**：买卖双方可以进行一对一的实时沟通，支持文字和图片消息。
- **校园地图模式**：以地图为载体，直观展示校园内各个交易地点的商品信息，方便用户发现附近的宝贝。
- **智能推荐**：根据用户的浏览和收藏行为，个性化推荐可能感兴趣的商品。

### 技术栈

- **前端**：微信小程序原生开发 (WXML, WXSS, JavaScript)
- **后端**：微信小程序云开发
- **数据库**：微信云开发数据库 
- **核心服务**：微信云函数、云存储

---

## 2. 环境配置与部署指南

请严格按照以下步骤进行配置，以确保项目能成功运行。

### 步骤 1：准备工作

1.  **安装微信开发者工具**：前往 [微信开放平台](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html) 下载并安装最新版的微信开发者工具。
2.  **注册小程序账号**：拥有一个自己的小程序 AppID。个人或企业主体均可。

### 步骤 2：导入项目

1.  打开微信开发者工具，点击“导入项目”。
2.  **项目目录**：选择本项目的根目录 `ruangong1`。
3.  **AppID**：填写您自己的小程序 AppID。
4.  **项目名称**：自定义即可。
5.  点击“导入”。

### 步骤 3：开通并配置云开发环境

1.  在开发者工具的顶部工具栏中，点击“云开发”按钮，打开云开发控制台。
2.  按照提示**开通云开发**，系统会自动为您创建一个云开发环境。
3.  **记住您的环境 ID**，它通常是一串类似 `your-env-id-xxxxxxxx` 的字符串。
4.  回到开发者工具的编辑器界面，打开文件 `miniprogram/app.js`。
5.  找到以下代码块（大约在第 6 行）：
    ```javascript
    this.globalData = {
      env: '' // <--- 在这里填入您的环境ID
    };
    ```
6.  将您刚刚获取的**环境 ID** 填入 `env` 字段的引号中。

### 步骤 4：部署云函数

1.  在开发者工具的左侧文件树中，找到 `cloudfunctions/quickstartFunctions` 目录。
2.  右键点击该目录，选择“**上传并部署：云端安装依赖**”。
3.  等待几分钟，直到开发者工具的控制台提示部署成功。

### 步骤 5：创建数据库集合

这是**非常关键**的一步。项目需要以下数据库集合来存储数据，您必须手动创建它们。

1.  打开云开发控制台，切换到“数据库”标签页。
2.  点击“**+**”号按钮，选择“创建集合”。
3.  依次创建以下所有集合（**集合名称必须完全一致**）：
    - `T_user`
    - `T_product`
    - `T_want`
    - `T_order`
    - `T_favorites`
    - `T_campus_landmarks`
    - `T_chat`
    - `T_message`
    - `T_notify`
    - `T_user_behavior`

4.  **设置权限**：为了方便开发和测试，您可以暂时将所有集合的权限设置为“**所有用户可读，仅创建者可读写**”。上线前请根据实际业务需求调整为更严格的权限规则。

### 步骤 6：运行项目

完成以上所有步骤后，点击开发者工具顶部的“编译”按钮。如果一切顺利，您应该可以在模拟器中看到小程序的启动界面。

至此，项目已成功在您的开发环境中运行起来。祝您使用愉快！