# EliteRepair **Repository Path**: chenshaogui/elite-repair ## Basic Information - **Project Name**: EliteRepair - **Description**: 同城快捷维修 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-31 - **Last Updated**: 2026-07-31 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 同城快捷维修（EliteRepair） > 基于 RuoYi-Cloud-Plus 微服务框架打造的同城维修服务平台，提供从用户报修到师傅上门维修的全流程闭环服务。 ## 项目简介 本项目是一个同城快捷维修服务平台，围绕「搜索匹配 → 极速下单 → 师傅接单上门 → 现场勘验报价 → 施工留痕结算 → 自动保修」形成完整业务闭环。平台采用 **0 抽成** 模式，订单收入 100% 归师傅所有，提升师傅接单积极性。 ## 技术栈 ### 后端（eliterepair-cloud） - **基础框架**：Spring Boot 4.1.0 / Spring Cloud 2025.1.2 - **Java 版本**：JDK 21（支持虚拟线程） - **微服务治理**：Nacos（注册中心 + 配置中心） - **服务网关**：Spring Cloud Gateway - **服务通信**：Apache Dubbo - **安全认证**：Sa-Token + JWT - **持久化**：MyBatis-Plus + Dynamic Datasource - **数据库**：MySQL - **缓存**：Redis + Redisson（分布式锁） - **工作流**：WarmFlow + LiteFlow - **任务调度**：SnailJob - **对象存储**：AWS S3 兼容（MinIO/阿里云 OSS/腾讯云 COS 等） - **监控**：Spring Boot Admin + Prometheus + Grafana - **链路追踪**：SkyWalking - **日志收集**：ELK（Elasticsearch + Logstash + Kibana） ### 后台管理端（eliterepair-system-web） - **框架**：Vue 3 + TypeScript - **UI 库**：Element Plus - **构建工具**：Vite - **状态管理**：Pinia - **HTTP 请求**：Axios - **其他**：Vue Router、Vue I18n、TailwindCSS ### 移动端（eliterepair-app-web） - **框架**：uni-app（Vue 2） - **UI 组件**：uni-ui - **支持平台**：微信小程序、App（iOS/Android）、H5 - **状态管理**：Vuex ## 项目结构 ``` EliteRepair/ ├── eliterepair-cloud/ # 后端微服务（Java） │ ├── eliterepair-auth/ # 认证中心 │ ├── eliterepair-gateway/ # 网关服务 │ ├── eliterepair-modules/ # 业务模块 │ │ ├── eliterepair-system/ # 系统模块（用户/角色/菜单/部门等） │ │ ├── eliterepair-gen/ # 代码生成器 │ │ ├── eliterepair-job/ # 定时任务 │ │ ├── eliterepair-resource/ # 资源服务（OSS/SMS/邮件/消息） │ │ ├── eliterepair-workflow/ # 工作流 │ │ ├── eliterepair-ai/ # AI 服务 │ │ └── eliterepair-business/ # 维修业务模块（核心） │ ├── eliterepair-api/ # 远程接口定义 │ ├── eliterepair-common/ # 通用模块（35 个子模块） │ ├── eliterepair-visual/ # 可视化（监控中心） │ ├── eliterepair-example/ # 示例 │ └── script/ # 脚本与配置 │ ├── config/nacos/ # Nacos 配置文件 │ ├── docker/ # Docker 部署 │ └── sql/ # 数据库脚本 │ ├── ry-cloud.sql # 系统基础表 │ ├── biz-repair.sql # 维修业务表（16 张） │ └── biz-menu.sql # 业务菜单权限 │ ├── eliterepair-system-web/ # 后台管理端（Vue 3） │ └── src/ │ ├── api/business/ # 业务 API（用户/师傅/订单/服务/优惠券） │ └── views/business/ # 业务页面 │ ├── user/ # 用户管理 │ ├── technician/ # 师傅管理 │ ├── order/ # 订单管理 │ ├── service/ # 服务分类管理 │ └── coupon/ # 优惠券管理 │ └── eliterepair-app-web/ # 移动端（uni-app） ├── api/business/ # 业务 API └── pages/ ├── repair/ # C 端用户页面 │ ├── index.vue # 首页（定位/分类/搜索/附近师傅） │ ├── order-create.vue # 下单 │ ├── order-list.vue # 订单列表 │ ├── order-detail.vue # 订单详情 │ ├── order-quote.vue # 报价确认 │ ├── address-list.vue # 地址管理 │ ├── my-coupon.vue # 我的优惠券 │ ├── my-warranty.vue # 我的保修卡 │ └── review-create.vue # 发表评价 └── technician/ # B 端师傅页面 ├── work/index.vue # 工作台 ├── order-hall.vue # 抢单大厅 ├── order-detail.vue # 师傅订单详情 ├── create-quote.vue # 创建报价 ├── finish-order.vue # 竣工确认 ├── my-wallet.vue # 我的钱包 └── cert-submit.vue # 资质提交 ``` ## 核心业务模块 ### 数据库表（16 张核心业务表） | 模块 | 表名 | 说明 | |------|------|------| | 用户 | `biz_user` | C 端用户信息 | | 师傅 | `biz_technician` | 师傅信息（资质/信用分/评分） | | 师傅 | `biz_technician_cert` | 师傅资质证件 | | 服务 | `biz_service_category` | 服务分类（家电维修/管道疏通等） | | 服务 | `biz_service_standard` | 标准服务一口价 | | 订单 | `biz_order` | 订单主表（核心） | | 订单 | `biz_order_quote` | 订单报价 | | 订单 | `biz_order_photo` | 施工留痕照片 | | 售后 | `biz_warranty` | 电子保修卡 | | 售后 | `biz_review` | 评价 | | 营销 | `biz_coupon` | 优惠券 | | 营销 | `biz_user_coupon` | 用户优惠券 | | 用户 | `biz_address` | 地址簿 | | 保险 | `biz_insurance` | 保险记录 | | 钱包 | `biz_wallet` | 师傅钱包 | | 钱包 | `biz_wallet_flow` | 钱包流水 | ### 订单状态流转 ``` 10 待接单 → 20 待报价 → 30 待支付 → 40 施工中 → 50 待结算 → 60 已完成 ↓ ↓ ↓ ↓ 70 已取消 70 已取消 70 已取消 70 已取消 ``` ### 业务闭环 ``` 用户搜索/直达 → 下单与发布 → 智能派单与响应 → 现场勘验与电子报价 ↓ 自动保修与卡券 ← 施工留痕与结算 ← 用户授权支付 ← 师傅导航上门 ``` ## 快速开始 ### 环境要求 - JDK 21 - Maven 3.9+ - MySQL 8.0+ - Redis 7.0+ - Nacos 2.x - Node.js 18+ / pnpm - HBuilderX（移动端开发） ### 1. 后端启动 ```bash # 1. 初始化数据库 mysql -u root -p < eliterepair-cloud/script/sql/ry-cloud.sql mysql -u root -p < eliterepair-cloud/script/sql/biz-repair.sql mysql -u root -p < eliterepair-cloud/script/sql/biz-menu.sql # 2. 导入 Nacos 配置 # 将 eliterepair-cloud/script/config/nacos/ 下的配置文件导入 Nacos 控制台 # 修改 datasource.yml 中的数据库连接信息 # 3. 启动基础服务（按顺序） # Nacos → Redis → MySQL → Seata（可选）→ RabbitMQ（可选） # 4. 编译后端项目 cd eliterepair-cloud mvn clean install -DskipTests # 5. 启动各微服务（建议在 IDE 中启动） # 优先启动：eliterepair-gateway → eliterepair-auth → eliterepair-system # 然后启动：eliterepair-business（业务模块，端口 8089） ``` ### 2. 后台管理端启动 ```bash cd eliterepair-system-web pnpm install pnpm dev ``` 访问地址：http://localhost:80 ### 3. 移动端启动 1. 使用 HBuilderX 打开 `eliterepair-app-web` 目录 2. 修改 `config.js` 中的 `baseUrl` 为后端网关地址 3. 点击「运行」→ 选择「运行到小程序模拟器」或「运行到浏览器」 ## 服务端口说明 | 服务 | 端口 | 说明 | |------|------|------| | eliterepair-gateway | 8080 | 网关（统一入口） | | eliterepair-auth | 9200 | 认证中心 | | eliterepair-system | 9201 | 系统模块 | | eliterepair-resource | 9203 | 资源服务 | | eliterepair-business | 8089 | 维修业务模块 | | eliterepair-monitor | 9100 | 监控中心 | | MySQL | 3306 | 数据库 | | Redis | 6379 | 缓存 | | Nacos | 8848 | 注册/配置中心 | ## 后端业务模块（eliterepair-business）说明 ### 包结构 ``` com.eliterepair.business ├── controller/ # 控制层（9 个 Controller） │ ├── UserController # 用户管理 │ ├── TechnicianController # 师傅管理 │ ├── OrderController # 订单管理（核心） │ ├── ServiceController # 服务分类 │ ├── CouponController # 优惠券 │ ├── AddressController # 地址簿 │ ├── WalletController # 师傅钱包 │ ├── WarrantyController # 保修卡 │ └── ReviewController # 评价 ├── domain/ # 实体与视图对象 │ ├── Biz*.java # 16 个数据库实体 │ ├── bo/ # 业务请求对象 │ └── vo/ # 视图对象（13 个 VO） ├── mapper/ # 数据访问层（16 个 Mapper） ├── service/ # 服务层 │ ├── IBiz*Service.java # 10 个服务接口 │ └── impl/ # 服务实现 └── EliteRepairBusinessApplication.java # 启动类 ``` ### API 接口前缀 所有业务接口统一前缀：`/business/` | 模块 | 路径 | 说明 | |------|------|------| | 用户 | `/business/user/**` | C 端用户管理 | | 师傅 | `/business/technician/**` | 师傅管理与认证 | | 订单 | `/business/order/**` | 订单全生命周期 | | 服务 | `/business/service/**` | 服务分类与标准服务 | | 优惠券 | `/business/coupon/**` | 优惠券管理 | | 地址 | `/business/address/**` | 地址簿管理 | | 钱包 | `/business/wallet/**` | 师傅钱包与流水 | | 保修 | `/business/warranty/**` | 电子保修卡 | | 评价 | `/business/review/**` | 评价管理 | ## 部署 ### Docker 部署 ```bash cd eliterepair-cloud/script/docker docker-compose up -d ``` 详细部署请参考 `eliterepair-cloud/script/docker/docker-compose.yml` ## 后续迭代计划 - [ ] 微信小程序授权登录（集成微信 SDK） - [ ] LBS 实时定位（高德/腾讯地图 SDK） - [ ] 微信支付对接 - [ ] 第三方保险 API 集成 - [ ] 消息推送（uni-push / 腾讯云 IM） - [ ] 师傅端语音播报 - [ ] 五金配件采购商城 - [ ] 订单实时监控大屏 ## License 本项目基于 MIT 协议开源