健身房私教管理系统 01：用户体系与多角色注册闭环

前言

本次实战课程，我们以健身房私教课程为业务场景，以腾讯云开发作为开发工具，系统讲解系统搭建过程。

在正式开始搭建健身房私教管理系统之前，我们必须先跨过一道门槛：用户权限与注册机制。

对于一套包含管理端和小程序端的完整业务系统而言，我们需要同时服务于老板、教练和学员。如何优雅地处理这些角色的登录、注册和权限分配？本文将从数据库设计出发，带你彻底理清腾讯云微搭的用户体系底层逻辑，并实现一个完整的外部用户注册闭环。

一、 核心数据模型：门店与用户表

在我们的系统设计中，一切业务流转都建立在统一的身份管理之上。我们主要围绕两张核心表展开：

门店表 (fit_store_branches)：支持未来多门店的扩展，记录门店的编码、地址、经纬度等基础信息。

用户主表 (fit_users)：这是系统的统一鉴权与身份管理表，包含学员、教练、管理员所有用户。

数据库的创建方式参考视频门店管理、用户管理相关操作

二、 深度解析：微搭的三种用户机制

要做好注册闭环，必须先理解微搭底层的用户分类机制。在微搭体系中，用户被严格划分为三种类型：

1. 内部用户：通过用户名和密码登录，拥有较高的系统权限，通常只能在 PC 端（管理后台）使用。
2. 匿名用户：免登录即可访问小程序端的用户，通常只能浏览公开信息。
3. 外部用户：通过手机号、微信授权等方式登录小程序端的用户。

架构决策：在我们的健身房系统中，无论是需要在小程序端约课的学员，还是需要查看排班的教练，甚至是偶尔用手机看报表的管理员，只要在小程序端进行交互，我们统一采用外部用户机制进行注册和鉴权。

三、 注册与登录闭环业务流

传统的业务开发往往需要手写冗长的 Token 校验和拦截逻辑，但在微搭中，我们可以利用云开发的特性，将注册闭环简化为以下两个阶段：

阶段一：云原生拦截与 身份初始化

当用户首次打开我们的小程序时：

1. 云开发底层会检测到当前用户是未认证状态。
2. 系统自动将其拦截至官方提供的登录页，要求用户提供手机号和验证码。
3. 用户完成验证后，首次登录会在微搭的身份库中自动注册一个基础账号。此时，用户在云开发底层有了合法的身份。

阶段二：业务系统的身份绑定（欢迎页路由分发）

虽然用户在云开发身份认证层注册了，但我们的业务主表fit_users里还没有他的详细信息。因此，我们将小程序的“首页”设计为一个动态欢迎页，利用按钮状态来控制路由：

1. 获取凭证：用户登录进入欢迎页后，我们通过微搭的全局对象$w.auth获取当前用户的手机号。
2. 数据库查验：根据该手机号，去fit_users表中进行精确匹配。
3. 状态分发：

• 已存在（老用户）：说明该用户已完成业务注册。我们将查询到的用户信息（如角色、姓名、门店）赋值给全局变量，欢迎页按钮显示为“进入系统”，点击直达业务工作台。
• 不存在（新用户）：说明是首次访问的新客。欢迎页按钮显示为“用户注册”，点击后跳转至完善信息页面（填写姓名、选择角色等），提交后再写入fit_users表，完成真正的业务注册。

四、创建应用

在搭建小程序的时候，首先需要创建应用。打开控制台，在左侧导航菜单选择微搭低代码，在右侧内容区域选择小程序，从空白创建

添加应用的名称，启用登录

创建应用后，我们需要调整一下登录方式，选择调整规则链接

选择前往身份认证

勾选短信验证码登录

勾选短信验证码主要是在登录的时候得到用户的手机号，openid主要是用在支付时候提供

五、创建页面

创建应用的时候，默认会提供一个空白页，需要把他重命名为欢迎页

六、 核心逻辑代码实现

在欢迎页的生命周期方法如页面加载完成时，我们可以通过$w.cloud.callDataSource来实现上述的查验逻辑。创建一个全局的登录方法

创建一个全局对象用来保存用户的信息

创建一个全局变量用来标识用户是否注册

全局的登录方法代码如下：

exportdefaultasyncfunctionlogin(){// 1. 显示加载状态，优化用户体验$w.utils.showLoading({title:'身份核验中',mask:true});//try{// 2. 从微搭 Auth 对象获取当前外部用户的手机号constuserPhone=await$w.auth.currentUser.phone||"15122334455";if(!userPhone){$w.utils.showToast({title:'获取手机号失败',icon:'error'});//return;}// 3. 调用数据源查询业务用户表constres=await$w.cloud.callDataSource({dataSourceName:'fit_users',methodName:'wedaGetRecordsV2',//params:{filter:{where:{$and:[{phone:{$eq:userPhone}},// 精确匹配手机号]}}}});// 4. 路由与状态分发if(res.records&&res.records.length>0){// 查到用户：存入全局变量（假定已定义全局变量 userInfo 和 isRegistered）$w.app.dataset.state.userInfo=res.records[0];$w.app.dataset.state.isRegistered=true;}else{// 未查到用户：标记为未注册$w.app.dataset.state.isRegistered=false;}}catch(error){console.error("用户核验失败",error);}finally{$w.utils.hideLoading();//}}

选中页面组件，给页面显示的时候绑定方法，绑定我们的全局登录

通过这套机制，我们完美地将底层的云开发 Auth 体系与我们的业务强耦合，既保证了数据安全，又利用了低代码平台的便利性，实现了多角色在小程序的无缝接入。