小牛Admin 会员客户端（uniapp）

基于 uni-app + Vue3 + uView Plus 的跨端会员基础客户端，对接小牛Admin v2.1 后端 API。一套代码可编译 App、H5、微信小程序，适合作为会员系统脚手架进行二次开发。

一、安装说明

1. 下载开发工具

请先安装 DCloud 官方 IDE HBuilderX（推荐正式版），用于打开、运行和打包本 uniapp 项目：

• HBuilderX 下载：https://www.dcloud.io/hbuilderx.html

• uni-app 官网：https://uniapp.dcloud.net.cn/

• DCloud 官网：https://www.dcloud.io/

安装完成后，用 HBuilderX「文件 → 打开目录」选择本项目的 uniapp 文件夹即可。

2. 配置接口地址（config）

打开项目根目录下的 config.js，将地址改成你的后端站点根地址（不要带末尾斜杠）：

window.__APP_CONFIG__ = {
  BASE_HOST: 'https://你的域名',
  BASE_IMG_URL: 'https://你的域名'
};

说明：

• H5：打包后会把 config.js 拷到与 index.html 同目录。部署后可直接改该文件切换环境，无需重新编译。

• App / 小程序：请同步修改 utils/request.js 顶部的 DEFAULT_HOST、DEFAULT_IMG_URL，保存后重新运行或打包。

• 接口实际请求地址为：BASE_HOST + /api，例如 https://你的域名/api。

3. 运行与打包

• 本地调试：在 HBuilderX 中运行到浏览器 / 手机模拟器 / 微信开发者工具

• H5 发行：菜单「发行 → 网站-H5」，将生成的文件覆盖到后端 php/public/h5/ 目录

• App / 小程序：按 HBuilderX 对应发行流程打包即可

4. H5 访问地址

后端网站运行目录指向 public 后，H5 访问地址为：

https://你的域名/h5/
 本地示例：http://127.0.0.1:端口/h5/

部署完成后，请确认 /h5/config.js 中的 BASE_HOST 已指向正确的 API 站点；若接口跨域，请保证后端已开启 CORS 或使用同域部署。

二、适用场景

• 需要登录注册、个人中心的会员类 App / H5 / 小程序

• 与小牛Admin 后台统一管理用户、单页协议、短信、App 升级

• 先搭建账号体系，再在首页扩展商城、内容、服务等业务

三、技术栈

四、功能概览

1. 账号与会员

• 短信验证码登录 / 账号密码登录

• 手机号注册、忘记密码、修改密码

• 个人资料、头像上传、绑定手机

• 退出登录、注销账号

2. 内容与协议

• 关于我们、隐私政策、用户协议等单页展示（后台可配置）

• 首页自动读取站点名称、Logo、简介

3. 系统能力

• App 热更新 / 整包更新（支持强制更新或可选更新）

• Android 启动隐私协议弹窗

• 统一请求封装、登录态管理、401 自动跳转登录

五、与后台对应关系

六、产品特点

1. 轻量基础版：聚焦会员账号体系，首页预留扩展位

2. 多端一套代码：App / H5 / 小程序共用业务逻辑

3. H5 可外置配置：改 config.js 即可切换环境

4. 与后台深度配套：用户、短信、单页、升级一条龙

5. 便于二次开发：接口、页面、组件结构清晰，可快速加业务模块

版本信息：应用名「会员系统」｜版本 1.0.0（versionCode 100）｜配套后端：小牛Admin v2.1.x
 H5 访问：https://你的域名/h5/