夜雨聆风学习资料网

ARTICLE · 1375681

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

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
<template>  <div class="page">    <el-table :data="rows"      border size="small">      <el-table-column        prop="orderNo" width="150"        label="订单号" />      <el-table-column        prop="communityName"        width="120" label="社区" />      <el-table-column prop="modeText"        width="90" label="模式" />      <el-table-column prop="amount"        width="100" label="金额" />      <el-table-column        prop="statusText" width="100"        label="状态">        <template slot-scope="s">          <el-tag :type="s.row.tag">            {{s.row.statusText}}          </el-tag>        </template>      </el-table-column>    </el-table>    <el-pagination :page-size="20"      :total="total"      layout="total,prev,pager,next" />  </div></template>

要点: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 做一套可二开的家政系统,欢迎找我领取演示资料和部署说明。

文中截图均为演示数据,界面与文案随版本可能调整;具体功能以实际交付版本为准。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料