更新记录

1.0.1（2026-09-24） 下载此版本

详情微信联系java_123567

平台兼容性

uniappClient · 多租户陪玩SaaS系统客户端（uni-app + Vue3）

本工程为 HBuilderX 标准 uni-app 项目（Vue3 + TypeScript），无需 npm 安装依赖，直接用 HBuilderX 打开即可运行。

一、环境要求

二、在 HBuilderX 中运行

1. HBuilderX → 文件 → 打开目录 → 选择本 uniappClient 目录。
2. 修改后端地址：打开 utils/request.ts，修改 BASE_URL：
   • 浏览器（H5）调试：保持默认 http://172.0.0.1:8080 或改为 http://localhost:8080。
   • 手机/模拟器（App、小程序真机）调试：改为电脑局域网 IP，例如 http://192.168.1.10:8080。
3. 启动后端（admin/admin-back，默认 dev 环境）。
4. 运行：
   • H5：菜单「运行 → 运行到浏览器 → Chrome」
   • 微信小程序：先在 manifest.json 的 mp-weixin.appid 填入小程序 AppID，再「运行 → 运行到小程序模拟器 → 微信开发者工具」
   • App：菜单「运行 → 运行到手机或模拟器」（需先安装 Android 模拟器或连接真机并开启 USB 调试）
5. 首次登录使用默认账号：admin / 123456（可在「我的 → 实名认证/改密」中完善资料）。

三、目录结构

uniappClient
├── api/
│   └── index.ts              # 接口层（认证/陪玩/订单/钱包/支付/打赏/工作台/提现/通知/推广）
├── pages/
│   ├── index/index.vue       # 首页：品牌装修、公告、分类、陪玩列表
│   ├── login/login.vue       # 统一登录（账号密码 / 微信一键登录占位 / 邀请码绑定）
│   ├── companion/
│   │   ├── list/list.vue     # 陪玩列表（分类筛选、昵称搜索）
│   │   └── detail/detail.vue # 陪玩详情（价格表、历史评价、下单、打赏）
│   ├── order/order.vue       # 我的订单（状态筛选、评价、申请退款、发布需求选券）
│   ├── wallet/
│   │   ├── wallet.vue        # 钱包（余额、冻结、VIP、资金流水、券入口）
│   │   ├── coupon/coupon.vue # 我的优惠券（领券中心 + 全部/待使用/已使用/已过期四页签）
│   │   └── recharge/recharge.vue  # 充值中心（满赠活动 + 充值）
│   ├── work/
│   │   ├── workbench/workbench.vue # 打手工作台（上下线、等级与提现规则、接单、任务凭证、提现申请、入驻认证）
│   │   └── orders/orders.vue       # 接单大厅（抢单）
│   └── user/
│       ├── profile/profile.vue     # 我的（实名认证、身份切换、客服、消息、退出登录）
│       └── messages/messages.vue   # 消息中心
├── static/logo.png
├── utils/request.ts          # 请求封装（BASE_URL、Token、统一错误处理）
├── App.vue                   # 应用入口（启动/前后台日志）
├── main.js                   # Vue3 应用创建
├── manifest.json             # uni-app 应用配置（各端 AppID、统计开关）
├── pages.json                # 页面路由与 tabBar
└── uni.scss                  # 全局样式变量

四、页面与需求对照（14 页）

登录态与跳转约定

• 所有受保护页面 onShow 统一 ensureLogin()（utils/auth.ts）；请求层 401 自动清缓存并 reLaunch 登录页（utils/request.ts）；
• 店铺上下文：本地 agent_id 仅作游客扫码缓存；登录后一律以服务端归属为准，登录/退出/401 均清除，避免换号残留。

五、接口约定

• 所有请求经 utils/request.ts 统一封装：
  • 自动附加 Authorization: Bearer <client_token>
  • 业务码 200 为成功；401 未登录、403 无权限，会有统一提示
  • 本地缓存键：client_token / client_role_type / client_user_id
• 后端接口前缀为 /api/*，清单见 admin/admin-back 各 Controller。

六、占位与后续替换说明

七、常见问题

1. 请求失败/跨域：确认 BASE_URL 与后端一致；后端已开启 CORS（见 WebConfig），H5 调试可直接访问。
2. 未登录自动跳转：首页 onShow 会校验 client_token，未登录时回到登录页。
3. 真机无法访问后端：手机与电脑需在同一局域网，且后端允许外部访问（防火墙放行 8080）。
4. 小程序域名校验：开发阶段保持 manifest.json 中 urlCheck: false；正式发布需在微信后台配置合法域名（HTTPS）。
5. HBuilderX 提示「请确认您的项目模板是否支持vue3：根目录缺少 index.html」：
   • 本项目根目录必须保留 index.html（uni-app Vue3 标准 H5 入口模板），请勿删除；
   • 若提示项目类型识别异常（例如仍按 uni-app x 识别），请先关闭项目，再「文件 → 打开目录」重新打开本 uniappClient 目录，并删除项目下 unpackage/ 缓存目录后重试；
   • 本项目为 经典 uni-app（Vue3） 工程：入口为 main.js + App.vue，页面为 pages/*.vue，不含 App.uvue / main.uts（那是 uni-app x 模板的文件）。

     八、代理商申请（v1.1 新增）

入口：我的 → 申请成为代理商（状态）。

接口：

审核通过后，平台会自动建立代理商租户并生成后台登录账号（账号与初始密码在「消息中心」通知中可见）。