ARTICLE · 1375681
JAVA同城服务同城社区家政服务系统源码支持小程序+公众号+APP+H5

同城家政的难点从来不是「做一个下单页面」,而是把服务品类、社区网格、师傅供给和三层分销关系放进同一套数据模型里。客户要能按品类、价格、距离快速筛选;师傅要能按距离和空闲抢单报价;运营要能按社区看单量、按团长结算佣金。
这套系统用 SpringBoot + MyBatisPlus + MySQL 做服务端,uni-app 一套代码出用户端与师傅端两个独立小程序,管理后台用 Vue + ElementUI。源码交付,支持小程序、公众号、APP、H5 四端。功能上分八块:精准筛选、社区管理、社区服务、小区家政服务、用户分销、师傅分销、社区分销,以及独立的用户端 / 师傅端。下文每个模块都按「谁在用 → 关键字段 → 出问题从哪退」写清楚,配七段可直接落地的代码。
文中截图为演示数据,姓名、手机号、头像、地址均已替换为虚构内容。
OVERVIEW / 功能总览
八个模块,一条履约链
从客流入口到供给履约再到分销裂变,八块能力拼成一套完整的社区家政系统。

01精准筛选
输入客户在首页按品类、价格区间、距离与可上门时间组合筛选;服务端接收筛选条件与客户定位。
状态筛选条件归一成结构化查询,价格/距离走索引字段,命中结果按距离与评分排序;空结果回落到热门品类。
输出返回可预约的服务项目与师傅列表,客户点进详情即可下单,搜索与筛选全程不阻塞。

【同城社区家政】实拍 01|用户端首页服务分类、我的订单入口、消息通知;发布服务页三种下单方式;截图数据为演示数据
02社区管理
输入运营在后台维护城市/片区/社区三级档案,绑定grid网格与站点负责人;下单时客户选择所在社区。
状态社区档案与订单通过 community_id 关联;一个社区可有多个推广码与团长,社区停用后新单不再归属。
输出后台按社区维度看单量、履约率与团长佣金;社区维度成为分销结算与运营分析的基本单位。
03社区服务
输入运营发布社区服务项目,配置一口价、报价、悬赏三种模式与标准服务内容、上门时段。
状态项目状态在草稿/上架/下架间流转;一口价固定金额,报价由师傅竞价,悬赏由客户出价,三种模式共用一张项目表。
输出前台按社区展示可服务项目,客户按模式选择下单方式;下架项目的历史订单仍可查看与售后。
04小区家政服务
输入客户提交家电清洗、日常保洁、维修疏通等具体需求,填写地址、上门时间与备注。
状态订单在待付款/待接单/待服务/进行中/已完成之间流转;每一跳写状态流水,师傅接单与改约都有记录。
输出客户在订单列表看实时状态与师傅信息,服务完成后可评价;异常订单走后台撤销并原路退款。

【同城社区家政】实拍 02|我的订单四种状态、发布服务的师傅覆盖与一口价/报价/悬赏下单、服务分类页;截图数据为演示数据
05用户分销
输入客户在订单详情或会员卡页生成专属推广码,分享给邻居;好友通过该码下单。
状态推广关系在首单时绑定到分销人,佣金按订单实付金额的固定比例计提;退款订单自动冲回未结算佣金。
输出分销人在我的钱包看到可提现佣金与冻结金额,订单核销完成后进入可提现余额。
06师傅分销
输入已入驻师傅邀请同行注册,被邀请师傅完成首单后,邀请人获得一次性分成。
状态邀请关系用 invite_by 记录,分成在首单核销后结算;同一手机号与设备只计一次有效邀请。
输出师傅端展示邀请名单与累计分成,后台可查每条邀请链路,防止刷单与自邀请。

【同城社区家政】实拍 03|师傅端首页今日收益与服务清单、接单池报价抢单、报价详情服务内容;截图数据为演示数据
07社区分销
输入社区团长/站点申请专属推广码,在本社区内推广;客户下单选择社区并命中该团长。
状态团长与社区一对一绑定,订单按 community_id 找到归属团长,核销后按比例结算;跨社区下单不计佣金。
输出后台按社区输出团长佣金报表,团长端看本社区订单与待结算金额,结算周期可配置。

【同城社区家政】实拍 04|订单详情的服务信息与确认码、悬赏下单表单、黑金会员卡与卡券支付;截图数据为演示数据
08独立用户端/师傅端
输入客户装用户小程序下单,师傅装师傅小程序接单;两端分别注册、分别登录。
状态两端共用一套服务端与数据库,但账号体系、菜单与权限隔离;师傅需实名与资质审核后才能抢单。
输出用户端专注下单、支付、评价与分销;师傅端专注接单池、报价、服务清单与收益,互不干扰。

【同城社区家政】实拍 05|师傅端我的订单与工具栏、消息列表、一口价详情服务图片与联系客户;截图数据为演示数据
ARCHITECTURE / 三端分工
ARCHITECTURE / 三端分工

用户端、师傅端、后台各司其职,价格与结算逻辑一律收在服务端。
CODE / 数据库与核心代码
数据库与核心代码
七段代码覆盖建表、下单、接单、核销结算与分销,字段前后一致,可直接对照落地。
以下均为示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
01建表:社区、订单、师傅与佣金
一张社区表、一张订单表、一张师傅表、一张佣金流水表,订单用 community_id 关联社区,佣金引用订单号保证可追溯。
| SQL |
| -- 社区家政:社区/订单/师傅/佣金四张主表CREATE TABLE community ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(64) NOT NULL, city VARCHAR(32) NOT NULL, leader_id BIGINT, status TINYINT DEFAULT 1);CREATE TABLE orders ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL, community_id BIGINT NOT NULL, user_id BIGINT NOT NULL, master_id BIGINT, mode TINYINT NOT NULL, amount DECIMAL(10,2) NOT NULL, status TINYINT DEFAULT 0, version INT DEFAULT 0, created_at DATETIME NOT NULL, UNIQUE KEY uk_no (order_no), KEY idx_com (community_id,status));CREATE TABLE master ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(32) NOT NULL, mobile VARCHAR(20) NOT NULL, category VARCHAR(32) NOT NULL, invite_by BIGINT, status TINYINT DEFAULT 0, UNIQUE KEY uk_mobile (mobile));CREATE TABLE commission ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL, role TINYINT NOT NULL, user_id BIGINT NOT NULL, amount DECIMAL(10,2) NOT NULL, status TINYINT DEFAULT 0, UNIQUE KEY uk_or (order_no,role, user_id)); |
要点:一张社区表、一张订单表、一张师傅表、一张佣金流水表。
02下单:一口价/报价/悬赏统一入口
三种模式共用 orders 表,mode 字段区分;下单即写状态流水,并锁定服务时段防止重复预约。
| JAVA |
| /** 下单:一口价/报价/悬赏统一入口 */public Long createOrder( OrderCmd cmd) { Community c = communityDao.get(cmd.getCid()); if (c == null || c.getStatus() != 1) { throw new BizException( "社区不可用"); } String no = noGen.next("JZ"); Order o = new Order(); o.setOrderNo(no); o.setCommunityId( cmd.getCid()); o.setUserId(cmd.getUid()); o.setMode(cmd.getMode()); o.setAmount( priceService.calc(cmd)); o.setStatus(0); o.setCreatedAt(new Date()); orderDao.insert(o); logDao.add(no,"CREATED", cmd.getUid()); lockService.hold( cmd.getSlotId(),no); return o.getId();} |
要点:三种模式共用 orders 表。
03接单:抢单用乐观锁防超卖
多个师傅同时抢一单,用 version 乐观锁保证只有一个成功,others 直接返回已接单。
| JAVA |
| /** 抢单:乐观锁防重复接单 */public boolean grab( Long orderId,Long mid) { Master m = masterDao.get(mid); if (m == null || m.getStatus() != 1) { throw new BizException( "师傅未审核"); } Order o = orderDao.get( orderId); if (o.getStatus() != 1) { return false; } int n = orderDao.grab( orderId,mid, o.getVersion()); if (n == 0) { return false; } logDao.add(o.getOrderNo(), "GRABBED",mid); return true;} |
要点:多个师傅同时抢一单。
04核销结算:核销后佣金才入账
服务完成核销后触发结算,用户/师傅/社区三层佣金一次事务写入,退款订单冲回未结算佣金。
| JAVA |
| /** 核销结算:三层佣金一次事务 */@Transactional( rollbackFor = Exception.class)public void settle( String orderNo) { Order o = orderDao.byNo( orderNo); if (o.getStatus() != 3) { throw new BizException( "未核销"); } BigDecimal base = o.getAmount(); Long cid = o.getCommunityId(); Long uid = o.getUserId(); Long mid = o.getMasterId(); addFee(orderNo,1,uid, base.multiply(RATE_U)); addFee(orderNo,2,mid, base.multiply(RATE_M)); Community c = communityDao.get(cid); addFee(orderNo,3, c.getLeaderId(), base.multiply(RATE_C)); orderDao.markDone(orderNo);} |
要点:服务完成核销后触发结算。
05社区维度数据权限
团长账号只能看本社区订单,权限在 MyBatisPlus 的拦截器按 community_id 注入,不靠前端隐藏菜单。
| JAVA |
| /** 数据权限:团长只看本社区单 */public class CommunityHook implements InnerInterceptor { @Override public void beforeQuery( Executor ex,Ms mp, BoundSql bs) { Long cid = DataScope.communityId(); if (cid == null) { return; } // 解析器追加 community_id=? // 参数在 DataScope 注入 bs.getSql().insert(0, "/*cid=" + cid + "*/"); }} |
要点:团长账号只能看本社区订单。
06用户端下单请求封装
uniapp 端统一封装请求,带 token 与幂等号 requestNo,网络重试不产生重复订单。
| JAVASCRIPT |
| // uniapp:请求封装 + 幂等号const request = (url,data,method='POST') =>{ let no = uni.getStorageSync('no'); if (!no) { no = Date.now() + '' + Math.floor(Math.random()*1e4); uni.setStorageSync('no',no); } return new Promise( (resolve,reject) =>{ uni.request({ url: BASE + url, method, data: {...data, requestNo: no}, header: {Authorization: 'Bearer ' + uni.getStorageSync('t')}, success: res =>{ if (res.data.code === 0) resolve(res.data.data); else reject(res.data.msg); }, fail: reject }) })}export default request |
要点:uniapp 端统一封装请求。
07后台社区订单表格
Vue + ElementUI 的分页、状态标签、筛选与导出,社区列按后台账号的数据权限渲染。
| VUE |
| < |
要点:Vue + ElementUI 的分页、状态标签、筛选与导出。
COMPLIANCE / 合规与上线
合规与上线前须知
个人信息与实名客户地址、手机号与师傅身份证属个人信息,采集需明示用途并最小化;展示层一律脱敏,数据库落库加密。
资金与结算佣金提现涉及资金结算,需接入合规支付渠道并留存结算流水;冻结期与退款冲回规则要在用户协议里写清。
服务资质与安全家电维修、高空作业等品类需核验师傅资质与保险;上门服务建议留服务前中后照片与行程记录。
数据隔离社区团长与师傅按各自维度隔离数据,接口层强制校验归属,避免越权查看他人订单与佣金。
上线前建议逐项打勾

FIT / 适合谁
这套系统适合谁
适合想做本地社区生活服务平台的团队,需要把品类、社区网格与师傅供给统一建模。
不太适合已有家政门店、想自建小程序与师傅端的运营商,希望把分销裂变留在自有体系。
二次开发需要可二开源码的开发者,想在标准履约链上扩展自家品类与结算规则。
FAQ / 常见问题
常见问题
Q:一口价、报价、悬赏能同时开吗?A:可以,三种模式共用订单表,按 mode 字段区分,项目级配置。
Q:用户端和师傅端必须分成两个小程序吗?A:源码里是两个独立端,也可按渠道合并,账号与权限仍隔离。
Q:佣金什么时候结算?A:订单核销完成后进入可提现余额,冻结期与退款冲回规则可配置。
Q:社区团长能看到别的社区订单吗?A:不能,接口层按 community_id 强制过滤,前端隐藏只是辅助。
Q:支持哪些端?A:小程序、公众号 H5、APP 四端共用服务端,前端用 uni-app 多端编译。
LAST / 写在最后
同城社区家政的核心,是把社区网格、服务供给和三层分销放进同一条履约链。这套源码把订单状态机、抢单并发、核销结算与数据权限都落到了可运行的代码里,在此基础上有二开空间。
需要演示环境、部署清单或源码结构说明,可以进一步沟通。
如果你正在做本地生活或社区服务,或想基于 SpringBoot + uniapp 做一套可二开的家政系统,欢迎找我领取演示资料和部署说明。
文中截图均为演示数据,界面与文案随版本可能调整;具体功能以实际交付版本为准。















































































