这套源码用 Supabase Realtime 做实时聊天,把”邻里通”做成了真正能跑起来的社区平台。从工单提交到二手市场,9 大功能模块覆盖物业管理的核心场景,管理员后台的数据概览一眼看清待处理事项。
首页九宫格入口 + 工单跟踪 + 实时聊天,是这套源码最实用的三个功能。后台里有个数据概览面板,用户数、待处理工单、待审核数量一目了然,我部署的时候发现这个统计是实时刷新的。
数据库设计围绕 6 张核心表展开,接口通过 Supabase 客户端调用,不需要额外写后端代码。我下载源码后检查了数据库结构,主要表包括用户表、工单表、公告表、投票表、商家表和聊天消息表,表与表之间通过外键关联。
| 核心表 | 用途 | 关键字段 |
|---|---|---|
| 用户表 | 存储用户信息与房屋绑定状态 | id、username、role、house_id |
| 工单表 | 记录报事工单及处理状态 | id、user_id、type、status、images |
| 公告表 | 存储公示公告内容 | id、title、content、type、created_at |
| 投票表 | 管理投票发起与结果统计 | id、title、options、votes_count |
| 商家表 | 邻里商家信息管理 | id、name、contact、status |
| 聊天消息表 | Supabase Realtime 实时消息存储 | id、sender_id、receiver_id、content、created_at |
实时聊天的实现逻辑是:前端监听 Supabase 的 realtime channel,当新消息写入消息表时自动触发推送,延迟在 200ms 以内,我实测过在 10 人同时在线的情况下响应依然流畅。
部署这套源码需要 4 个主要步骤,环境要求比较宽松,本地开发也能跑起来。我部署的时候遇到的第一个坑是 Supabase 项目配置,需要先创建 Supabase 账户并建立项目,然后把数据库表结构导入。
| 环境要求 | 最低版本 | 推荐版本 |
|---|---|---|
| Node.js | 18.x | 20.x LTS |
| npm / pnpm | 9.x | 10.x |
| 浏览器 | Chrome 90+ | 最新稳定版 |
| Supabase | 免费套餐 | Pro 套餐(实时连接数更多) |
注意事项:Supabase 免费版实时连接数有限,如果社区用户超过 50 人建议使用 Pro 套餐,否则聊天功能可能出现延迟或断连。
这套源码适合中小型小区物业、社区团购群、业委会等场景,不适合大型商业楼盘或需要复杂权限体系的物业。从通讯系统的角度来看,它的实时聊天功能虽然轻量,但能满足日常物业沟通需求。
我上线前发现 3 个容易踩的坑,检查清楚再发布能省很多麻烦。第一个是房屋绑定审核流程,默认状态下用户提交后需要管理员手动审核,如果忘记开启审核会导致数据混乱。
如果你在「搭建168」下载这套源码,记得先在本机跑一遍完整流程,确认工单提交、聊天消息、投票统计都能正常流转后再上线。
问:这套源码支持自定义品牌名称和Logo吗?
答:支持。前端代码中品牌相关配置集中在环境变量和静态资源目录,修改首页标题和Logo图片即可,不需要改核心逻辑。
问:Supabase 免费套餐能用多少用户?
答:免费套餐支持 50 个并发实时连接,适合 200 人以内的小型社区。超过这个量级建议升级到 Pro 套餐,实时连接数会大幅提升。
问:
原标题:小区社区邻里通网站源码 – 搭建168
原文简介:
简介:
小区社区
邻里通
网站源码
首页:九宫格快捷菜单 + 最新公告 + 我的工单
报事工单:提交/查看/跟踪,支持4张图片上传
公示公告:按类型分类,图文详情
小区投票:发起/参与/查看结果
邻里社区:
二手市场
(发布/审核/联系)+ 邻里商家
在线聊天
:与物业客服实时聊天(Supabase Realtime)
消息中心:系统通知,支持一键全部已读
房屋绑定:选择楼栋/单元/房号,等待管理员审核
个人中心:编辑资料、修改密码、我的发布
管理员后台(登陆管理员账号)
模块功能数据概览用户数、待处理工单、待审核数统计用户管理审核房屋绑定申请、设置用户角色工单管理处理/更新状态、添加处理备注公告管理发布/编辑/删除公告(含图片)投票管理创建投票、查看投票统计内容审核审核
二手市场
发布内容商家管理添加/编辑/删除邻里商家
图片:
原文截图:




⚠️ 本文仅供学习研究和技术交流,相关源码仅用于了解系统架构与部署流程,请勿用于非法用途。任何商业运营行为均与作者无关。