家政多商户系统技术架构与二次开发实践指南引言家政多商户平台的核心价值与技术挑战家政多商户平台是指在一个系统内同时支持多个家政服务商家入驻、多个师傅接单、多个用户下单的综合性同城服务预约系统。与单商户家政系统不同多商户模式需要解决商家隔离、订单路由、分账结算、权限分级等核心问题同时还要兼顾用户端、商家端、师傅端三端协同。从技术选型上看当前主流方案普遍采用 Java 后端 UniApp 跨端框架管理端使用 Vue Element UI数据库以 MySQL 为主并配合 Redis 做缓存与分布式锁。本文基于实际开发经验梳理家政多商户系统的典型架构、关键模块实现思路以及二次开发中的常见坑点希望对正在选型或准备自研的技术团队有所帮助。一、家政多商户系统的整体架构设计一个完整的家政多商户系统包含四个端用户端小程序/APP/H5、师傅端接单工具、商家端店铺管理后台、平台管理端超级后台。知识库中提到的独立用户端、师傅端和商家端正是多商户模式的基本形态。从后端服务角度看建议采用微服务或模块化单体架构。如果团队规模不大模块化单体即可满足需求后续再按需拆分。核心模块包括用户中心注册登录、地址管理、会员等级、积分优惠券商户中心商家入驻审核、店铺信息、员工管理、服务项目配置师傅中心师傅入驻、技能标签、接单/抢单/派单状态机、行程轨迹订单中心订单创建、支付、分配、执行、完成、售后全流程支付结算/支付宝支付、商家分账、师傅佣金结算消息中心站内信、短信、订阅消息、在线聊天IM典型技术栈可参考以下组合后端Spring Boot MyBatis Plus MySQL Redis RabbitMQ 前端UniAppVue语法构建用户端/师傅端/商家端H5与小程序复用 管理端Vue 3 Element UI Axios 部署Docker Nginx 云服务器不限制IP/域名二、核心功能模块的实现思路2.1 多商户入驻与权限隔离商家入驻流程通常为提交资料 → 平台审核 → 开通店铺 → 配置服务项目。实现时需注意两点审核流程后台需要提供待审核列表、驳回理由、重新提交能力状态字段建议用int类型0待审1通过2驳回不要用布尔值。数据隔离商家端的所有查询必须强制带上merchant_id条件。建议在 MyBatis Plus 中配置TenantLineInnerInterceptor多租户插件通过上下文自动注入商家ID避免开发者漏写造成数据越权。2.2 员工管理与订单派发知识库特别提到了「员工订单」和「快速任务」这是家政多商户区别于普通预约平台的重要能力。商家可以为自己的师傅设置“员工账号”然后手动派单给指定师傅。实现上需要区分两种派单模式抢单模式订单创建后进入公共订单池师傅端实时刷新或通过 WebSocket 接收新订单通知先到先得。派单模式商家在订单列表中选择师傅生成派单记录师傅端收到强制指派提醒。推荐采用状态机管理订单流转待支付 → 待接单可抢/可派 → 已接单 → 服务中 → 待验收 → 已完成 └→ 取消/售后为了防止并发抢单需要使用 Redis 分布式锁或数据库乐观锁。简单做法UPDATE orders SET master_id?, status已接单 WHERE id? AND status待接单通过受影响行数判断是否抢单成功。这类功能本质上是对标准化订单的扩展。实现方案是在订单表增加task_type字段并扩展订单属性表一口价用户按商家定价直接下单金额固定。悬赏任务设定悬赏金额完成任务后资金从客户冻结流转至师傅账户。以上类型都需要在订单结算时单独处理佣金计算规则。建议将计算规则抽离为策略类避免大量if-else。2.4 消息推送与隐私通话家政场景中用户地址、是敏感信息。知识库提到了「虚拟」和「阿里云隐私」实现方案如下在用户和师傅之间通话时通过云通信平台获取一个虚拟中间号双方显示该号码通话结束后自动失效。消息推送统一封装PushService对接订阅消息、APP 推送如极光/个推、短信服务根据用户端类型自动选择通道。三、二次开发中的关键要点与避坑指南很多团队会基于开源源码进行二次开发以下是实际项目中容易踩坑的地方3.1 保持多端业务逻辑一致性家政系统通常同时支持小程序、APP、公众号、H5。前端共用 UniApp 代码但各端的登录、支付、定位 API 存在差异。建议在common/api.js中做平台判断// #ifdef MP-WEIXINuni.login({provider:weixin});// #endif// #ifdef APP-PLUSuni.login({provider:apple});// #endif后端接口设计时建议统一返回{ code, msg, data }结构并在网关层处理 token 校验不要在业务代码写重复的登录判断。3.2 商户结算与分账设计多商户系统必然涉及平台、商家、师傅三方分账。处理原则是在订单完成后生成冻结账单再按周期结算。不要直接在订单表里写死分成比例而是维护一张settlement_rule表按服务类目区分平台佣金比例、商家抽成比例、师傅到手金额。使用定时任务每日汇总生成对账单便于人工核对。3.3 性能优化与并发处理家政预约场景有一个高峰期节假日保洁、年底大扫除。此时订单量可能达到平时十倍。建议订单创建接口使用 Redis 预扣库存模式不直接操作数据库。热点数据如师傅当前位置、是否在线使用 Redis 哈希存储过期时间设置 5 分钟。列表页查询必走索引订单表需要联合索引(merchant_id, status, create_time)。把抢单的秒杀式请求接入 MQ 削峰例如 RabbitMQ 或 RocketMQ消费者负责异步写入订单状态。3.4 源码交付后的部署文档与运维知识库中反复提到「提供源码文档、支持二次开发」以及「不限制IP和域名」。作为技术团队拿到源码后应当首先核对以下内容环境要求JDK 版本一般 1.8、MySQL 版本5.7/8.0、Redis 版本。配置文件application.yml中的数据库连接、Redis 连接、小程序 appid/secret、支付证书路径。前端构建UniApp 项目需要npm install然后分别执行npm run dev:mp-weixin和npm run build:app。部署顺序先启动后端再启动管理端静态文件后上传小程序代码。建议将部署过程写成 Shell 脚本或 Docker Compose 文件避免人工操作遗漏环境变量。四、家政多商户系统的常见 FAQ问家政多商户系统和普通家政单商户系统的技术区别是什么答多商户的核心在于数据隔离和分账逻辑。单商户只需处理用户和平台的交互而多商户必须在所有业务链路中引入merchant_id维度并设计商家、师傅、员工之间的隶属关系。此外多商户模式下订单分配更复杂因为存在平台派单、商家派单、师傅抢单三种来源。问知识库中提到的「快速任务」和「悬赏任务」有什么区别问二次开发时容易忽略哪些功能问家政多商户系统能不能支持多城市运营答可以。只需在商户表中增加city_code字段并在下单接口中根据用户定位的城市过滤商家和师傅。注意城市数据建议用行政区域编码存储不要用城市名称文本避免后续城市改名或合并导致数据混乱。问做多商户系统后端必须用 Java 吗答不是必须的PHP、Go 等也可实现。但 Java 生态的 Spring Boot MyBatis Plus 在快速开发、事务管理、权限框架如 Sa-Token/Shiro方面比较成熟且市面上的家政多商户源码大多基于 Java二次开发资料多适合对稳定性要求高的同城服务平台。问如果没有技术团队拿到源码后可以自己部署吗答如果只是按照文档部署到服务器有一定 Linux 基础就可以完成。但后续要修改界面、增加功能则至少需要熟悉 Vue 和 Java 的开发者。建议在购买源码前确认是否提供部署文档和二次开发技术文档知识库中提到的免费业务咨询和技术支持在实际开发中会很有帮助。
