Skip to content

vancece/secondHandMiniprogram

Repository files navigation

🛒 二手购 - 校园二手交易小程序

一个功能完善的校园二手物品交易平台

License WeChat Node.js

功能特性快速开始技术栈演示视频贡献指南

系统架构图

📖 项目简介

二手购是一个基于微信小程序微信云开发的校园二手物品交易平台,专为大学生群体打造。

💡 项目亮点

  • 🎯 零服务器成本 - 基于微信云开发,无需购买服务器
  • 🚀 开箱即用 - 完整的前后端代码,快速部署上线
  • 💬 实时通信 - 基于云数据库实时推送的即时聊天系统
  • 🔒 内容安全 - 集成微信内容安全检测,自动过滤违规内容
  • 🎨 精美UI - 基于 ColorUI 组件库,界面美观流畅
  • 📱 功能完善 - 涵盖发布、搜索、聊天、订单等完整交易流程

👥 项目信息

  • 创作团队:大王叫我来巡山小组
  • 学校:广州大学
  • 开源协议:MIT License

✨ 主要功能

🎯 核心功能

  • 🏠 首页浏览

    • 瀑布流展示最新商品
    • 智能推荐算法
  • 🔍 智能搜索

    • 关键词搜索
    • 分类筛选
  • 📝 商品发布

    • 图片上传与压缩
    • 内容安全检测
  • 💬 即时聊天

    • 实时消息推送
    • 表情包支持
  • 👤 个人中心

    • 我的发布
    • 我的收藏
    • 订单管理

🌟 特色功能

  • 📊 分类浏览

    • 多级分类导航
    • 快速筛选定位
  • 收藏系统

    • 一键收藏商品
    • 收藏夹管理
  • 👣 浏览足迹

    • 自动记录浏览历史
    • 快速回溯查看
  • 🏆 热门排行

    • 浏览量排行
    • 热门商品推荐
  • 💰 租赁功能

    • 支持物品租赁
    • 租期管理
  • 🎓 学生认证

    • 实名认证
    • 提升交易信任度

🛠 技术栈

前端技术

技术 说明 版本
微信小程序 原生小程序开发 -
ColorUI UI 组件库 -
WXS 小程序脚本语言 -

后端技术

技术 说明 版本
微信云开发 Serverless 后端服务 -
云函数 Node.js 运行环境 Node.js 12+
云数据库 NoSQL 数据库 MongoDB
云存储 对象存储服务 -

核心能力

  • 🔄 实时通信 - 基于云数据库 Watch 实现的实时消息推送
  • 🛡️ 内容安全 - 集成微信内容安全检测 API
  • 📦 文件存储 - 云存储支持图片上传与管理
  • 🔐 用户认证 - 微信登录与学生认证

📦 项目结构

secondHandMiniprogram/
├── 📁 cloud/                    # 云函数目录(40+ 云函数)
│   ├── addFootPrint/           # 添加浏览足迹
│   ├── chatting/               # 聊天消息处理
│   ├── release/                # 发布商品
│   ├── search/                 # 商品搜索
│   ├── getUserInfo/            # 获取用户信息
│   └── ...                     # 更多云函数
│
├── 📁 pages/                    # 小程序页面
│   ├── home/                   # 首页 - 商品瀑布流
│   ├── detail/                 # 商品详情页
│   ├── chat/                   # 聊天列表
│   ├── chatting/               # 聊天详情
│   ├── release/                # 发布商品
│   ├── search/                 # 搜索页面
│   ├── user/                   # 个人中心
│   ├── collection/             # 我的收藏
│   ├── footprint/              # 浏览足迹
│   └── ...                     # 更多页面
│
├── 📁 components/               # 自定义组件
│   ├── goods/                  # 商品卡片组件
│   ├── searchbar/              # 搜索栏组件
│   ├── nav-bar/                # 导航栏组件
│   └── ...                     # 更多组件
│
├── 📁 utils/                    # 工具函数
├── 📁 static/                   # 静态资源(图片、图标)
├── 📁 moudles/                  # 功能模块
│   ├── database/               # 数据库操作
│   ├── evilTextCheck/          # 内容安全检测
│   └── ...
│
├── 📄 app.js                    # 小程序入口文件
├── 📄 app.json                  # 小程序全局配置
├── 📄 app.wxss                  # 全局样式
├── 📄 project.config.json       # 项目配置
├── 📄 数据库.docx                # 数据库设计文档
└── 📄 README.md                 # 项目说明文档

🚀 快速开始

📋 前置要求

在开始之前,请确保你已经准备好以下内容:

📥 安装步骤

1️⃣ 克隆项目

git clone https://github.com/vancece/secondHandMiniprogram.git
cd secondHandMiniprogram

2️⃣ 配置项目

⚠️ 重要提示:在运行项目前,必须完成以下配置

请按照 CONFIG.md 配置指南完成:

  • 📝 替换小程序 AppID(project.config.json 第 47 行)
  • 📝 替换云环境 ID(app.js 第 28 行)

💡 提示:详细的配置步骤和说明请查看 CONFIG.md 文件

3️⃣ 导入项目

  1. 打开微信开发者工具
  2. 点击导入项目
  3. 选择本项目目录
  4. 填写项目名称和你的 AppID
  5. 点击导入

4️⃣ 部署云函数

在微信开发者工具中:

  1. 点击工具栏的云开发按钮,开通云开发
  2. 右键点击 cloud 目录下的每个云函数文件夹
  3. 选择 "上传并部署:云端安装依赖"
  4. 等待所有云函数部署完成

⏱️ 首次部署可能需要 5-10 分钟,请耐心等待

5️⃣ 初始化数据库

  1. 在微信开发者工具中打开云开发控制台
  2. 进入数据库模块
  3. 参考 数据库.docx 文档创建相应的数据库集合
  4. 主要集合:usergoodschatorder

6️⃣ 运行项目

点击微信开发者工具的编译按钮,即可在模拟器中预览小程序!


🎬 快速演示

完成以上步骤后,你将看到:

  • ✨ 精美的首页商品展示
  • 🔍 强大的搜索功能
  • 💬 实时聊天系统
  • 📱 完整的交易流程

📱 功能演示

🎥 视频演示

📸 功能截图

💡 提示:由于项目开源,建议使用者自行截图展示


📄 数据库设计

数据库架构

详细的数据库设计文档请参考:数据库.docx

主要集合

集合名 说明 主要字段
user 用户信息 openid, username, avatar, phone, isAuthorize
goods 商品信息 title, price, images, category, status, publisherId
chat 聊天记录 sender, receiver, content, time, isRead
order 订单信息 goodsId, buyerId, sellerId, status, createTime
commentNotice 评论通知 userId, goodsId, commentContent, isRead

数据库特性

  • 🔐 权限控制 - 基于用户 openid 的数据访问控制
  • 📊 索引优化 - 关键字段建立索引,提升查询性能
  • 🔄 实时同步 - 利用云数据库 Watch 实现实时数据推送

🤝 贡献指南

我们欢迎所有形式的贡献!无论是新功能、Bug 修复还是文档改进。

如何贡献

  1. 🍴 Fork 本仓库
  2. 🔧 创建你的特性分支 (git checkout -b feature/AmazingFeature)
  3. 💾 提交你的改动 (git commit -m 'Add some AmazingFeature')
  4. 📤 推送到分支 (git push origin feature/AmazingFeature)
  5. 🎉 提交 Pull Request

贡献建议

  • 🐛 Bug 报告 - 发现问题请提交 Issue
  • 💡 功能建议 - 有好的想法欢迎讨论
  • 📖 文档完善 - 帮助改进文档
  • 🎨 UI 优化 - 提升用户体验

📝 开源协议

本项目采用 MIT 协议开源,详见 LICENSE 文件。

这意味着你可以:

  • ✅ 商业使用
  • ✅ 修改源代码
  • ✅ 分发
  • ✅ 私人使用

但需要:

  • 📄 保留版权声明
  • 📋 包含许可证副本

👥 联系我们

📮 联系方式

GitHub Issues Stars

问题反馈: 提交 Issue


🙏 致谢

感谢以下项目和资源:


⭐ Star History

如果这个项目对你有帮助,欢迎点个 Star ⭐ 支持一下!

Made with ❤️ by 大王叫我来巡山小组

⬆ 回到顶部

About

🛒 校园二手交易微信小程序 - 基于微信云开发,支持商品发布、实时聊天、订单管理等完整交易流程 | WeChat MiniProgram for Campus Second-hand Trading

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors