src/code/README.md

@@ -0,0 +1,87 @@
+# 校园二手交易小程序
+
+## 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：运行项目
+
+完成以上所有步骤后，点击开发者工具顶部的“编译”按钮。如果一切顺利，您应该可以在模拟器中看到小程序的启动界面。
+
+至此，项目已成功在您的开发环境中运行起来。祝您使用愉快！