更新记录

1.0.1（2026-10-22） 下载此版本

本项目仅开源 uni-app 社区康养用户端（基于 Vue3），可在电脑浏览器、手机浏览器、微信小程序、手机 App 等多端运行。用 HBuilderX 导入本目录即可本地体验，供学习研究。

平台兼容性

uni-app(3.8.7)

其他

上门维修用户端

开源说明

本项目仅开源 uni-app 用户端，适配网页和微信公众号。用 HBuilderX 导入本目录即可运行，供学习研究。

能在哪些地方使用

用户可以在电脑或手机的网页里预约上门维修、回收旧设备，也可以在微信里打开网页使用。维修商家也可以在同一套用户端里申请入驻、接单、管服务和钱包。

底部有三个主入口：首页、订单、我的。

对接了哪些第三方

下面这些是用户日常能直接感受到的外部服务：

• 腾讯地图：识别当前所在城市；在地图上选上门地址和门店位置；把省市区和经纬度记下来，方便师傅导航上门。
• 微信支付：付订金、付全款、付维修余款、钱包充值。
• 支付宝：同样用于付款和充值。
• 钱包余额：平台余额支付，钱不够会提示换微信或支付宝。
• 微信授权登录：在微信小程序里可用微信授权，并获取手机号快速登录。
• 企业微信客服：后台配好后，可跳到企业微信联系客服。
• 个人微信客服：复制客服***，或扫客服二维码添加。
• 电话客服：一键拨打客服热线。
• 平台在线客服：在软件里和平台客服发消息。
• 微信订阅消息：回收相关进度，可向用户申请接收微信通知（需后台配置模板）。
• 手机系统能力：定位、打开地图选点、拨打电话、复制***、上传收款码和现场照片。

用户能做什么

打开软件先看到什么

• 显示当前城市，可切换。
• 搜索机型或故障。
• 有轮播广告，点进去跳到对应内容。
• 有一排维修服务入口（具体名称以后台配置为准）。
• 宣传「最快约 30 分钟上门、就近派工程师」（展示文案）。
• 新用户可能看到新人优惠券，可直接领取。
• 有热门推荐服务，显示起步价，可立即预约。
• 下拉可刷新首页。

预约上门维修（从选服务到上门）

• 搜索或从服务入口进入维修服务列表。
• 选机型，再选故障类型，看故障详情和别人怎么评价。
• 确认订单：填写上门地址、联系人、预约时间、问题描述，可上传故障照片。
• 地址必须在地图上点选位置，再手补楼栋、单元，方便师傅导航；只填文字地址不够。
• 付款可以是订金或全款。付订金后，师傅检测报价，用户确认报价后再付余款；余款也可以按约定线下付给师傅，由商家确认收到。
• 支付方式：余额、微信支付、支付宝。
• 下单后可在订单里继续支付、取消订单。已付订金或已付款取消时，页面会说明钱按原路退回。

维修订单进行到哪一步

订单会跟着实际进度走，用户在订单列表和订单详情里能看到，常见操作包括：

• 还没付款：去支付、取消订单。
• 已派单、师傅正在联系或上门：可联系师傅，部分阶段仍可取消或申请取消。
• 师傅给出检测报价：确认报价，或拒绝报价。确认后如果还有余款，需先付余款再开始修。
• 维修完成后：确认验收。
• 全部完成后：给服务打分写评价，需要的话申请售后。
• 订单详情能看到订金、余款、支付方式、支付时间、师傅信息等。

旧设备回收

• 看回收门店、回收服务说明。
• 快速下单提交回收。
• 在「我的回收」里看回收订单详情。
• 回收完成后可评价。
• 部分回收付款可能要上传支付凭证（例如微信转账记录）。
• 可申请接收微信里的进度通知。

门店

• 看门店详情、用户评价。
• 打开门店导航，按地图去店里。

账号、地址、积分

• 微信授权登录（小程序里可同时拿手机号）。
• 手机号注册、登录、忘记密码。
• 管理上门地址：地图选点 + 详细门牌，可新增、编辑。
• 看我的积分。
• 看关于我们、帮助中心。

钱包和提现

• 我的钱包：余额充值（微信或支付宝）、余额提现。
• 绑定收款方式：上传微信收款码，或填写支付宝姓名和账号。
• 看资金明细、提现记录。

邀请朋友

• 邀请好友、看我的团队、看收益明细。

消息和客服

• 消息中心：系统通知（订单进度、入驻审核、提现结果等）、客服消息。
• 客服中心按后台配置，可能是：打电话、***、企业微信、或软件里在线聊。
• 帮助中心也可直接进客服消息。

商家能做什么

• 填写入驻申请：门店资料必须在地图上选位置，不能只手打地址。
• 审核通过后进入商户中心。
• 发布维修服务、管理已发布的服务。
• 看商户订单、打开维修订单详情。
• 用户地址如果没在地图上选过点，商家导航时会提示联系用户更新地址。
• 用户若约定线下付余款，商家需确认已经收到这笔钱。
• 改门店信息（位置同样用地图选点）。
• 商户钱包：提现到微信或支付宝、绑定收款账户、看资金明细、营收明细、提现明细。

体验

体验地址：https://shanxiuxia.xianmaxiong.com

技术栈

运行

这份代码已经接到线上体验环境，不用改任何配置，打开后直接运行即可。

开始前请准备

1. 一台 Windows 电脑（苹果电脑也可以，步骤差不多）。
2. 下载并安装 HBuilderX（官方用来打开这类项目的软件）：
   打开浏览器，搜索「HBuilderX 官网」，进入 https://www.dcloud.io/hbuilderx.html，下载「正式版」，安装后打开。
3. 建议再装一个 Chrome 浏览器，用来打开运行后的页面。

第一步：拿到文件夹

1. 如果你收到的是压缩包（例如 zip），先右键解压。
2. 解压后，请找到名字叫 上门维修 的文件夹。里面应该能看到 pages.json、App.vue、common 等文件。
3. 记住这个文件夹在电脑上的位置。不要只打开里面某一个文件。

第二步：用 HBuilderX 打开整个项目

1. 打开已经安装好的 HBuilderX。
2. 点左上角 「文件」→「打开目录」（有的版本也叫「从本地打开」）。
3. 选中刚才的 上门维修 文件夹，确定。
4. 左侧出现一长串文件名，就说明打开对了。如果左侧是空的，说明选错了文件夹，请重新选带 pages.json 的那一层。

第三步：用浏览器运行

1. 在 HBuilderX 顶部菜单点 「运行」→「运行到浏览器」→「Chrome」。
2. 第一次可能会提示安装浏览器运行插件，点允许或安装，等它装完再重新点一次运行。
3. 电脑会自动弹出一个网页。出现首页、底部「首页 / 订单 / 我的」，就说明运行成功了。
4. 如果浏览器问能不能获取位置，点「允许」，首页才能显示当前城市。
5. 不要关 HBuilderX，关了网页可能会断开。

常见情况说明

• 页面是空的、提示加载失败：检查电脑能否打开体验地址 https://shanxiuxia.xianmaxiong.com ；如果这个网页本身打不开，用户端也会没数据。
• 点了运行没反应：确认打开的是整个 上门维修 文件夹，不是只打开了一个页面文件。
• 浏览器打开了但是花屏、一直转圈：等十几秒；仍不行就关掉网页，在 HBuilderX 里再点一次运行。
• 地图选不了上门地址：需要腾讯地图的钥匙（项目里已预填，有过期或额度用完的可能）。学习看页面时可以先忽略地图。
• 微信支付、支付宝点了没反应：需要商家自己的支付账号，这份开源代码一般只能看到支付按钮，不能真的完成收款。
• 微信登录、短信、客服不通：这些也依赖没开源的服务端和第三方账号，界面可以点，功能不一定通。

第一次建议怎么验收

1. 按第三步在 Chrome 打开。
2. 能看到首页搜索框、服务入口、底部三个按钮。
3. 点「我的」，能看到登录入口。
4. 再点「订单」，能进入订单页。
   做到这里，就说明「这份用户端代码已经在你电脑上跑起来了」。