# 近我家-社区互助平台
**Repository Path**: wumurong/CommunityHub
## Basic Information
- **Project Name**: 近我家-社区互助平台
- **Description**: 近我家(邻聚里)· 社区互助平台 - 微信原生小程序
一、项目概述
1.1 项目名称
近我家(邻聚里) - 社区互助平台
1.2 项目定位
一款基于微信小程序的社区互助平台，通过技能交换、物品借用、信息发布和互助服务四大核心模块，让城市社区重新焕发温暖与活力，实现"人人为我，我为人人"的良性社区生态。
1.3 项目愿景
让每个社区都成为温暖的大家庭，用技术连接邻里，用互助点亮生活。
- **Primary Language**: 微信
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-27
- **Last Updated**: 2026-07-15
## Categories & Tags
**Categories**: Uncategorized
**Tags**: 吴木荣, 邻聚里, 近我家
## README
# 近我家(邻聚里) · 社区互助平台
[](https://gitee.com/)
[](https://mp.weixin.qq.com/)
[](https://nodejs.org/)
[](LICENSE)
> 让邻里重新连接，用技术点亮社区生活
## 项目简介
近我家(邻聚里)是一款基于微信小程序的社区互助平台，致力于解决现代城市社区中邻里关系疏离、技能与资源闲置、信息分散等痛点。通过技能交换、物品借用、信息发布和互助服务四大核心模块，让城市社区重新焕发温暖与活力，实现"人人为我，我为人人"的良性社区生态。
**项目愿景**：让每个社区都成为温暖的大家庭，用技术连接邻里，用互助点亮生活。
### 解决的痛点
- **邻里疏离**：同住一栋楼却形同陌路，遇到困难时不知道邻居中谁可以帮忙
- **资源闲置**：退休教师、手工艺人、技术专家住在同一社区，但技能无法共享；工具、书籍等物品利用率低
- **信息分散**：社区信息散落在微信群、公告栏、物业通知中，居民难以高效获取和发布有用信息
***
## 核心功能模块
### 🏋️ 技能交换
让每个人的特长都有用武之地，教英语换修电脑，教书法换瑜伽指导。
### 📦 物品借用
电钻、梯子、书籍、露营装备…… 邻居之间轻松借用，减少重复购买。
### 📢 信息发布
社区活动、失物招领、二手交易、拼车拼单…… 一个平台汇聚所有社区信息。
### ❤️ 互助服务
帮忙取快递、照看宠物、临时照看老人…… 微小善举，温暖整个社区。
### 小程序体验版
扫描下方二维码体验小程序：
***
## 项目进度
✅ **微信小程序端** - 功能完善完成
- 绑定社区地图显示（map组件、定位、标记点、社区选择联动）
- 图片上传功能（专属上传接口，支持JWT认证）
- 全局搜索接口
- 四个详情页收藏功能
- 意见反馈功能
- 定位权限声明配置
- 深圳社区数据支持（默认定位深圳，搜索半径20km）
✅ **后端API** - 功能完善完成
- 专属上传接口（支持单文件/批量上传，验证文件类型和大小）
- 管理后台API（8个模块完整增删改查）
- 静态文件服务（挂载在`/api/community/images/`，1天缓存）
- 意见反馈接口
- 自动建表（`ch_feedback`表）
✅ **管理后台** - 8个功能页面完成
- 数据概览、社区管理、用户管理、技能交换、物品共享、社区信息、互助服务、意见反馈
***
## 技术架构
### 三端架构
| 端 | 技术栈 | 说明 |
| -------- | --------------------------------- | -------------------------- |
| **用户端** | 微信原生小程序（WXML + WXSS + JavaScript） | 用户日常使用的小程序界面 |
| **管理后台** | Vue 3 + Element Plus | 管理员管理社区、用户、内容 |
| **后端服务** | Node.js + Fastify + TypeScript | RESTful API、WebSocket 实时通信 |
### 核心依赖
- **数据库**：MySQL 8.0+（业务数据）+ Redis（缓存）
- **认证**：JWT（jsonwebtoken）
- **实时通信**：WebSocket（ws 库）
- **部署**：Docker + Nginx
- **UI组件**：Vant Weapp（小程序端）
### 特色能力
- **LBS智能推荐**：基于地理位置推荐附近的技能、物品、互助服务
- **智能匹配算法**：根据用户技能标签和需求进行匹配推荐
- **实时消息推送**：WebSocket 实现即时聊天和消息通知
- **信用积分体系**：基于用户行为建立社区信用体系
***
## 项目目录结构
```
CommunityHub/
├── miniprogram/ # 微信小程序前端
│ ├── app.js # 小程序入口文件
│ ├── app.json # 全局配置
│ ├── app.wxss # 全局样式
│ ├── sitemap.json # 站点地图配置
│ ├── project.config.json # 项目配置
│ ├── components/ # 公共组件
│ │ ├── card-skill/ # 技能卡片组件
│ │ ├── card-item/ # 物品卡片组件
│ │ ├── card-info/ # 信息卡片组件
│ │ ├── card-help/ # 互助卡片组件
│ │ ├── empty/ # 空状态组件
│ │ ├── load-more/ # 加载更多组件
│ │ └── image-uploader/ # 图片上传组件
│ ├── pages/ # 页面目录
│ │ ├── index/ # 首页
│ │ ├── discover/ # 发现页
│ │ ├── publish/ # 发布页（含skill/item/info/help子页面）
│ │ ├── message/ # 消息页
│ │ ├── mine/ # 个人中心
│ │ ├── search/ # 搜索页
│ │ ├── skill/ # 技能交换模块（list/detail）
│ │ ├── item/ # 物品借用模块（list/detail）
│ │ ├── info/ # 信息发布模块（list/detail）
│ │ ├── help/ # 互助服务模块（list/detail）
│ │ ├── chat/ # 聊天模块
│ │ ├── auth/ # 登录授权（login/bind-community）
│ │ ├── profile/ # 个人资料编辑
│ │ ├── my-publish/ # 我的发布
│ │ ├── my-favorite/ # 我的收藏
│ │ ├── credit/ # 信用积分
│ │ ├── settings/ # 设置
│ │ ├── feedback/ # 意见反馈
│ │ └── about/ # 关于我们
│ ├── services/ # API服务层
│ │ ├── user.js # 用户相关接口
│ │ ├── skill.js # 技能相关接口
│ │ ├── item.js # 物品相关接口
│ │ ├── info.js # 信息相关接口
│ │ ├── help.js # 互助相关接口
│ │ ├── message.js # 消息相关接口
│ │ ├── community.js # 社区相关接口
│ │ ├── favorite.js # 收藏相关接口
│ │ └── upload.js # 上传相关接口
│ ├── utils/ # 工具函数
│ │ ├── request.js # 网络请求封装
│ │ ├── auth.js # 登录授权
│ │ ├── util.js # 通用工具
│ │ └── websocket.js # WebSocket封装
│ ├── images/ # 静态图片资源
│ │ ├── tabbar/ # tabbar图标
│ │ └── default-avatar.png # 默认头像
│ └── styles/ # 公共样式
│ ├── variables.wxss # 样式变量
│ └── common.wxss # 公共样式类
├── 微信小程序截图/ # 小程序页面截图和演示视频
├── 管理后台截图/ # 管理后台页面截图
├── 视频/ # 演示视频
├── 吴木荣/ # 开发者资料
├── 邻聚里.html # 产品概念展示页面
├── 邻聚里.md # 完整开发文档
├── LICENSE
└── README.md
```
***
## 快速开始
### 环境要求
- Node.js >= 18.x
- 微信开发者工具
- MySQL 8.0+（后端服务）
- Redis（后端服务）
### 小程序端运行
1. **克隆项目**
```bash
git clone
cd CommunityHub/miniprogram
```
2. **配置项目**
- 在 `project.config.json` 中配置小程序 AppID（当前使用 `wxf9b3b589673925ad`，如需替换为你自己的 AppID，请前往 [微信公众平台](https://mp.weixin.qq.com/) 注册并获取）
- 在 `utils/request.js` 中配置后端 API 地址（默认地址为 `https://server.13590202441.com/api/community`，请根据实际后端服务地址修改 `baseUrl`）
3. **下载并安装微信开发者工具**
- 前往 [微信开发者工具官网](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html) 下载对应操作系统的稳定版安装包
- Windows 系统请选择 Windows 64 位版本
- 安装时按照向导提示完成安装，建议使用默认安装路径
4. **使用微信开发者工具导入项目**
- 打开微信开发者工具，使用微信扫码登录
- 点击左侧 **"+"** 按钮（或菜单栏"项目" → "导入项目"）
- 在弹出的对话框中填写以下信息：
- **项目目录**：选择本地 `CommunityHub/miniprogram` 文件夹（项目路径下包含 `app.js`、`app.json`、`project.config.json` 等文件）
- **AppID**：点击下拉框，选择已配置的 AppID；如果使用测试号，可选择"测试号"；若没有 AppID 也可选择"使用测试号"进行本地开发调试
- **项目名称**：填写 `近我家(邻聚里)`（或其他自定义名称）
- **开发模式**：选择 **"小程序"**
- **后端服务**：选择 **"不使用云服务"**
- 点击 **"确定"** 完成项目导入
5. **启动开发环境**
- 项目导入成功后，微信开发者工具会自动加载项目并显示模拟器
- 如未自动编译，点击顶部工具栏的 **"编译"** 按钮
- 模拟器中即可预览小程序界面，左侧为模拟器预览区，右侧为代码编辑区
- 开发过程中修改代码后，模拟器会自动刷新（如未自动刷新，可手动点击"编译"）
1. **常见配置说明**
| 配置项 | 文件位置 | 说明 |
| --- | --- | --- |
| AppID | `miniprogram/project.config.json` → `appid` 字段 | 小程序唯一标识，需与微信公众平台注册的一致 |
| 后端 API 地址 | `miniprogram/utils/request.js` → `defaultBaseUrl` | 默认 `https://server.13590202441.com/api/community`，改为你的后端地址 |
| 导航栏颜色 | `miniprogram/app.json` → `window.navigationBarBackgroundColor` | 当前为 `#E8833A`（暖橙色） |
| 定位权限 | `miniprogram/app.json` → `permission` | 已声明位置权限，用于 LBS 推荐功能 |
> **提示**：若在开发调试中遇到网络请求失败，请在微信开发者工具右上角点击"详情" → "本地设置"，勾选 **"不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书"**（项目配置中 `urlCheck` 已设为 `false`，通常无需额外操作）。
### 后端服务
后端服务包含完整的 API 接口、上传服务和管理后台 API，支持 JWT 认证和 WebSocket 实时通信。
***
## API 概览
所有接口统一挂载在 `/api/community` 前缀下，采用 JWT Token 认证。
| 模块 | 主要接口 | 说明 |
| ------ | ---------------------------- | ---- |
| **用户** | `/api/user/wx-login` | 微信登录 |
|
| `/api/user/bind-community` | 绑定社区 |
| **技能** | `/api/skill/list` | 技能列表 |
|
| `/api/skill/publish` | 发布技能 |
| **物品** | `/api/item/list` | 物品列表 |
|
| `/api/item/borrow` | 申请借用 |
| **信息** | `/api/info/list` | 信息列表 |
|
| `/api/info/publish` | 发布信息 |
| **互助** | `/api/help/list` | 互助列表 |
|
| `/api/help/accept` | 接单 |
| **消息** | `/api/message/send` | 发送消息 |
|
| `/api/message/conversations` | 会话列表 |
***
## 开发规范
### 命名规范
- **页面文件**：小写，使用 kebab-case（如 `skill-detail`）
- **组件文件**：小写，使用 kebab-case，加前缀（如 `card-skill`）
- **JS变量/函数**：小驼峰命名（camelCase）
- **常量**：大写下划线（UPPER\_SNAKE\_CASE）
### 设计规范
- **主色调**：`#E8833A`（暖橙色，代表温暖、活力、互助）
- **设计风格**：简洁、温暖、现代，圆角卡片式设计
- **尺寸单位**：使用 rpx，设计稿以 750px 宽度为基准
***
## 产品展示
### 小程序截图
| 首页 | 发现页 | 技能交换 | 技能详情 |
| :---------------------: | :-------------------: | :-----------------------: | :-----------------------: |
|  |  |  |  |
| 物品借用 | 物品借用内容 | 邻里互助 | 邻里互助内容 |
| :-----------------------: | :---------------------------: | :-----------------------: | :---------------------------: |
|  |  |  |  |
| 完整首页 | 个人中心 | 发布内容 |
| :-----------------------: | :-----------------------: | :-----------------------: |
|  |  |  |
### 管理后台截图
| 数据概览 | 社区管理 | 用户管理 | 技能交换 |
| :-------------------------: | :-------------------------: | :-------------------------: | :-------------------------: |
|  |  |  |  |
| 物品共享 | 社区信息 | 互助服务 |
| :-------------------------: | :-------------------------: | :-------------------------: |
|  |  |  |
### 演示视频
[点击查看演示视频](视频/邻聚里.mp4)
查看产品概念展示页面：[近我家(邻聚里)产品展示页](邻聚里.html)
***
##
抖音
[](https://v.douyin.com/wYh13GTuQ_4/)
### 演示视频
[点击查看演示视频](视频/邻聚里.mp4)
***
## 参与贡献
1. Fork 本仓库
2. 新建 `Feat_xxx` 分支
3. 提交代码
4. 新建 Pull Request
***
## License
MIT License
***
## 联系方式
### 👤 开发者：吴木荣
📱 **电话 / 微信**：13590202441
📧 **邮箱**：<13590202441@qq.com>
### 微信二维码
.jpg)
###
> 让每个社区都成为温暖的大家庭 🏠