同城上门维修业务系统上门回收系统

是一套同城上门维修业务系统，采用前后端分离架构，服务端、管理端、用户端全套代码开源。

服务端基于 Spring Boot 2.6.11（Java 8）构建，负责接口、数据库，以及支付、短信、地图等外部能力。启动后控制台会打印「上门维修项目启动成功」。 管理端基于 Vue 3 开发，供运营人员在电脑浏览器中使用。 用户端基于 uni-app 开发，覆盖手机网页和微信小程序。用户可以预约手机、平板、电脑维修，也可以发起旧机回收；商户在同一个应用里处理订单和门店。

2. 移动端界面预览

首页	选择机型	选择故障	确认订单	个人中心

3. 开源说明

本项目采用 Apache 2.0 许可协议，源码供学习、技术研究、商业使用、二次开发与参考使用。
开源为生态，服务才是根基； 欢迎各位开发者一同交流。

4. 快速开始

建议顺序：先服务端，再管理端，最后用户端。 管理端和用户端都要等服务端已经启动，才能登录和加载数据。

4.1 服务端

安装 JDK 8、Maven、MySQL 8、Redis。新建数据库 smwx，导入 shangmenweixiu_server/db/smwx.sql，再启动服务端。默认环境是 prod，数据库写在 application-prod.yml，本机 127.0.0.1:3306/smwx，账号 root，密码 123456。你的 MySQL 密码不同时，只改这一处。Redis 要先在本机 6379 端口运行。
服务端口 9166，上下文路径 /sqx_fast。接口文档：http://127.0.0.1:9166/sqx_fast/doc.html。
详细步骤见 服务端运行教程。

4.2 管理端

安装 Node.js 18 或更高版本，在 shangmenweixiu_admin 里执行安装并启动。开发站点默认端口 5173。
详细步骤见 管理端运行教程。

4.3 用户端

用 HBuilderX 打开 shangmenweixiu_uniapp，运行到浏览器。H5 开发端口是 5052。
详细步骤见 用户端运行教程。

管理端账号以导入后的数据库为准。地图、短信、微信、支付宝等密钥需要自行申请，再填进管理端「系统配置」。申请入口写在 用户端功能说明 末尾。

5. 文档

6. 目录结构

仓库根目录只放三端代码、说明和协议。编译出来的 target、dist、unpackage、node_modules 是运行时生成的，不需要改。

6.1 仓库根目录

6.2 服务端 shangmenweixiu_server

6.3 管理端 shangmenweixiu_admin

6.4 用户端 shangmenweixiu_uniapp

界面组件使用 uView Plus。执行安装后，scripts/sync-uview-uni-modules.cjs 会把组件同步到 uni_modules。

7. 核心特性与技术栈

7.1 核心特性

· 一个用户端同时服务用户和维修商户
· 手机、平板、电脑按机型和故障预约上门
· 支付订金锁定预约，检测后再结算余款
· 旧机回收估价与回收订单
· 门店导航、优惠券、积分、余额 / 微信 / 支付宝付款
· 钱包、邀请分销、在线客服
· 商户入驻、服务发布、接单和商户钱包
· 后台统计、审核、上下架和权限配置
· 服务端统一处理登录、订单和支付结果

每项怎么用，见 用户端功能说明、管理端功能说明、服务端功能说明。

版本以仓库里的配置文件为准。没写死版本号的，按运行教程安装对应大版本即可。

7.2 服务端

7.3 管理端

7.4 用户端