GO多城市家政上门预约系统源码架构拆解与二开部署指南

一套面向多城市家政、维修、保洁类上门业务的商业系统，后端采用Go语言编写，前端基于uni-app构建用户端与技师端，管理后台单独用Vue3实现。整套源码完整交付，没有加密和编译依赖，技术负责人可以直接拿到全部前后端代码，评估架构可维护性和二次开发成本。以下从承接的实际技术角度，拆解这套GO上门预约系统的核心路线。

整体架构：三端分离，Go微服务为核心

系统分成用户端、技师端、管理后台三个独立前端应用，共用一套Go编写的后端API服务。后端全部基于Gin框架，路由层、中间件、业务逻辑按模块拆分，没有滥用框架，代码目录清晰。前端采用uni-app配合Vue3，一套代码可发行H5、微信小程序以及App，多端适配不靠条件编译硬撑，通过配置与分包策略降低维护负担。

通信层使用标准RESTful接口，全部通过JWT做身份鉴权。实时消息需求（例如订单状态变更通知）通过Gorilla WebSocket实现，后端与客户端建立长连接，避免短轮询带来的资源浪费。整体上没有引入Redis、消息队列等外部中间件，部署依赖极少，这对中小团队快速启动是有利条件，后期也可以按需叠加缓存层。

后端设计：Gin + GORM + MySQL的真实落地形态

后端代码没有用复杂的微服务拆分，一个独立进程处理全部API请求，但实现了清晰的service-repository分层。GORM处理数据库操作，模型定义与业务逻辑解耦，方便在二开时调整表结构或替换ORM操作。支付模块封装了微信支付API v3、支付宝支付和余额支付三种方式，参数通过后台可视化配置注入，避免硬编码。

技师排班、服务状态流转（接单→出发→到达→服务中→完成）通过状态机控制，关键变更会写操作日志，方便对账和纠纷处理。地图能力基于腾讯位置服务，包含定位、逆地址解析、IP定位等功能，前端直接调用后端封装的接口，保证了Key的安全性。短信验证码、文件上传等通用能力也都做成独立模块，团队接手时可以快速定位代码位置。

前端跨端实现与审核友好设计

用户端和技师端共用uni-app工程，通过pages.json划分分包。首页装修、服务项目列表、技师名片等组件化程度高，大部分文案和图标都从后端接口拉取，配合后台的DIY装修功能，运营人员可以直接更换业务场景，不需要前端改版。这对家政、保洁、维修等多场景切换的二开项目尤其重要。

技师端独立分包，只加载工作台、订单操作、排班和收入提现相关页面，包体积可控，利于微信小程序审核通过。在需要上架到应用市场时，可以用同一套代码编译成App，无需单独开发原生模块。

数据库与接口扩展要点

数据库采用MySQL 8.4，表结构围绕用户、技师、服务项目、订单、分销、会员、社区等模块设计。订单表与技师表通过服务关系关联，支持多城市代理的预留字段和模型还在，但后端路由和后台菜单目前标记为暂时下线，技术团队若需要城市代理分账模式，可以基于现有模型重新启用路由，改动量不大。

接口扩展方面，所有业务API统一以/api/v1/为前缀，在Gin的路由文件中声明，添加新接口只需注册路由并实现对应的handler，不会牵动整体结构。前后端通过JWT token交互，新增的角色权限判断可以在中间件层统一处理。对第三方系统对接，比如企业内部ERP、客服系统，开放标准JSON格式接口也十分方便。

部署与上线验收清单

项目提供Docker Compose编排文件，MySQL 8.4与Go后端独立容器运行，前端H5、管理后台都可以通过Nginx代理。后端默认端口8080，管理后台开发服5888，用户端H5开发模式5173，部署时只需暴露80/443并提供SSL证书。验收上线时建议技术负责人逐项检查：

• 支付通路：微信商户号和支付宝密钥是否通过后台正确配置，实际支付回调是否可达。
• 小程序配置：request合法域名、socket域名、uploadFile域名是否已加入小程序后台白名单，业务域名是否配置正确。
• 地图与定位：腾讯位置服务Key是否绑定，H5和小程序定位权限是否正常。
• 消息推送：WebSocket服务是否随着后端启动，订单状态变更时技师端能否实时刷新。
• 文件上传：上传目录权限、静态资源访问路径是否正确，防止图片403。

部署文档和培训资料随源码交付，技术团队按目录执行docker compose up即可看到效果，不需要额外搭建复杂环境。

团队接手成本与二次开发建议

接手这套Go源码项目的团队，需要具备Go基础、Vue3开发经验以及对uniapp的熟悉度。因为代码未加密、未混淆，可读性强，后端逻辑集中在Gin路由和service层，前端组件化清晰，所以上手难度属于中等偏下。建议新团队从订单状态机、支付回调链路和技师排班逻辑三条主线切入，理解业务流程后再开始二开。

二开过程中如果要新增服务品类，只需在后台服务管理中添加项目，前端无需改动；若调整分成比例或增加营销规则，在管理后台分润配置和优惠券模板中操作即可。整个系统以商用授权方式交付，支持私有化部署，避免了SaaS平台的合规风险和按年付费成本。源码交付后，公司可以自行申请软著、进行商标注册，完全掌握代码产权。

山东壹软网络科技有限公司除了提供整套源码和部署培训，也可以承接定制开发需求，包括运营后台的Dashboard定制、多城市代理功能重新激活、对接第三方支付通道等。对技术负责人来说，这种带着完整源码和清晰文档的项目，能大幅降低选型风险和后期运维压力。