张翔
18 KiB
18 KiB
健身房管理系统基础版业务概要设计文档（B-HLD）
文档编号: GYM-B-HLD-BASIC-001
版本: v1.0
日期: 2026-03-08
作者: 张翔
状态: 已发布
文档修订历史
| 版本 | 日期 | 作者 | 修订内容 |
|---|---|---|---|
| v1.0 | 2026-03-08 | 张翔 | 创建基础版业务概要设计文档 |
一、引言
1.1 编写目的
本文档为健身房管理系统基础版的业务概要设计文档（Business High-Level Design），旨在：
- 从业务层面描述基础版的业务范围、核心业务流程、业务规则
- 为业务详细设计提供业务指导和约束
- 作为产品经理、业务分析师的业务参考
1.2 项目背景
健身房管理系统基础版是面向小型工作室、个人教练等场景的核心版本，保证业务闭环，提供完整的会员管理、预约、签到等核心功能。
1.3 术语定义
| 术语 | 定义 |
|---|---|
| 租户(Tenant) | 系统的多租户架构中的独立业务实体，如一个连锁品牌 |
| 门店(Store) | 租户下的具体经营场所 |
| 会员(Member) | 在门店注册的用户 |
| 权益(Benefit) | 会员卡包含的时长、次数、储值、等级等权益 |
| 可预约资源(Bookable Resource) | 团课等可被预约的对象 |
| 时段(Slot) | 资源的可预约时间窗口 |
1.4 参考文档
- 《健身房管理系统基础版产品设计文档》 GYM-PRD-BASIC-001
二、业务概述
2.1 业务目标
| 目标维度 | 目标描述 | 成功指标 |
|---|---|---|
| 用户体验 | 提升会员预约和签到体验 | 预约成功率 ≥ 95%，签到耗时 ≤ 3秒 |
| 运营效率 | 降低人工操作成本 | 人工处理时间减少 50% |
| 数据价值 | 提供基础数据支持 | 数据报表使用率 ≥ 80% |
2.2 用户角色
| 角色 | 描述 | 主要功能 |
|---|---|---|
| 会员 | 健身房注册用户 | 预约课程、签到、查看个人信息 |
| 教练 | 健身房教练 | 排课、团课签到管理 |
| 前台 | 门店前台人员 | 会员接待、签到辅助、会员管理 |
| 店长 | 门店管理者 | 单店全功能管理、数据查看 |
| 超级管理员 | 平台最高权限 | 全平台管理、系统配置 |
2.3 业务范围
flowchart LR
subgraph "基础版业务范围"
M1[会员管理<br/>• 会员注册<br/>• 会员卡管理<br/>• 权益管理]
M2[预约管理<br/>• 团课预约<br/>• 团课管理]
M3[签到管理<br/>• 扫码签到<br/>• 签到记录管理]
M4[数据统计<br/>• 基础数据统计]
M5[系统管理<br/>• 用户管理<br/>• 角色权限管理]
M6[UI模版定制<br/>• 品牌定制<br/>• 布局调整<br/>• 预设模板<br/>• 配置历史]
end
三、核心业务流程
3.1 会员注册流程
3.1.1 业务场景
新用户通过小程序或前台进行注册，成为健身房会员。
3.1.2 业务流程
flowchart LR
A[用户打开小程序] --> B[填写手机号]
B --> C[验证手机号]
C --> D[填写基本信息]
D --> E[注册成功]
3.1.3 业务规则
- 手机号需验证唯一性
- 手机号需通过短信验证码验证
- 支持微信授权快速注册
- 注册成功后自动创建会员档案
3.1.4 异常处理
| 异常场景 | 处理方式 |
|---|---|
| 手机号已存在 | 提示用户直接登录 |
| 验证码错误 | 提示用户重新输入 |
| 验证码过期 | 提示用户重新获取 |
3.2 团课预约流程
3.2.1 业务场景
会员通过小程序预约团课，教练通过管理后台创建团课。
3.2.2 业务流程
会员预约团课：
flowchart LR
A[会员打开小程序] --> B[查看团课列表]
B --> C[选择团课]
C --> D[确认预约]
D --> E[预约成功]
教练创建团课：
flowchart LR
A[教练打开管理后台] --> B[点击创建团课]
B --> C[填写团课信息]
C --> D[发布团课]
D --> E[发布成功]
3.2.3 业务规则
预约时间规则
- 预约需在课程开始前至少30分钟
- ✅ 场景1：团课18:00开始，会员17:30可以预约
- ✅ 场景2：团课18:00开始，会员17:31可以预约
- ❌ 场景3：团课18:00开始，会员17:29无法预约
- ❌ 场景4：团课18:00开始，会员18:00无法预约
取消预约规则
- 取消预约需在课程开始前至少2小时
- ✅ 场景1：团课18:00开始，会员16:00可以取消预约
- ✅ 场景2：团课18:00开始，会员15:59可以取消预约
- ❌ 场景3：团课18:00开始，会员16:01无法取消预约
- ❌ 场景4：团课18:00开始，会员17:00无法取消预约
课程容量规则
- 每节课最多20人
- ✅ 场景1：团课当前预约19人，第20人可以预约
- ✅ 场景2：团课当前预约18人，2人同时预约，都成功
- ❌ 场景3：团课当前预约20人，第21人无法预约
- ❌ 场景4：团课当前预约19人，2人同时预约，1人成功1人失败
权益扣减规则
- 预约成功后扣减权益
- ✅ 场景1：会员有5次团课权益，预约1次后剩余4次
- ✅ 场景2：会员有30天时长卡，预约后时长不变，仅记录预约信息
- ✅ 场景3：会员有储值卡，预约团课费用100元，余额从500元变为400元
- ❌ 场景4：会员权益为0时，无法预约团课
团课创建规则
- 团课需指定教练、时间、地点
- ✅ 场景1：教练张三创建团课，指定时间为18:00-19:00，地点为A教室
- ✅ 场景2：教练张三创建团课，指定时间为每周一18:00-19:00，地点为A教室
- ❌ 场景3：创建团课未指定教练，系统提示"请选择教练"
- ❌ 场景4：创建团课未指定时间，系统提示"请选择时间"
团课取消规则
- 团课取消需提前24小时通知
- 团课取消后自动退款
- ✅ 场景1：团课18:00开始，教练在前一天16:00取消，已预约会员自动退款
- ✅ 场景2：团课18:00开始，教练在前一天18:00取消，已预约会员自动退款
- ❌ 场景3：团课18:00开始，教练在前一天18:01取消，系统提示"取消时间过晚"
- ❌ 场景4：团课18:00开始，教练在当天17:00取消，系统提示"取消时间过晚"
3.2.4 异常处理
| 异常场景 | 处理方式 |
|---|---|
| 课程已满 | 提示用户选择其他课程 |
| 会员卡权益不足 | 提示用户购买会员卡 |
| 预约时间过短 | 提示用户提前预约 |
3.3 签到流程
3.3.1 业务场景
会员到店后通过扫码进行签到，记录到店信息。
3.3.2 业务流程
flowchart LR
A[会员到店] --> B[扫描签到码]
B --> C[验证会员卡]
C --> D[签到成功]
D --> E[记录到店时间]
3.3.3 业务规则
会员卡验证规则
- 签到需验证会员卡有效性
- ✅ 场景1：会员卡有效期至2026-12-31，今日签到成功
- ✅ 场景2：会员卡有5次权益，签到后剩余4次
- ✅ 场景3：会员卡为30天时长卡，签到后时长不变
- ❌ 场景4：会员卡已过期（2026-01-01到期），签到失败提示"会员卡已过期"
- ❌ 场景5：会员卡权益为0，签到失败提示"会员卡权益不足"
预约验证规则
- 签到需验证预约信息（如有）
- ✅ 场景1：会员预约了18:00的团课，18:00签到成功
- ✅ 场景2：会员预约了18:00的团课，17:50签到成功
- ✅ 场景3：会员未预约团课，签到成功记录为自由训练
- ❌ 场景4：会员预约了18:00的团课，19:00签到失败提示"课程已结束"
- ❌ 场景5：会员预约了A教室的团课，在B教室签到失败提示"签到地点错误"
签到记录规则
- 签到成功后记录到店时间
- ✅ 场景1：会员18:00:00签到，记录到店时间为2026-03-08 18:00:00
- ✅ 场景2：会员同一天多次签到，记录每次签到时间
- ✅ 场景3：会员签到后离开，再次签到记录新的到店时间
- ❌ 场景4：会员签到失败，不记录到店时间
3.3.4 异常处理
| 异常场景 | 处理方式 |
|---|---|
| 会员卡无效 | 提示用户购买会员卡 |
| 会员卡过期 | 提示用户续费 |
| 签到码无效 | 提示用户重新扫描 |
3.4 会员卡购买流程
3.4.1 业务场景
会员通过小程序购买会员卡，获得相应权益。
3.4.2 业务流程
flowchart LR
A[会员打开小程序] --> B[查看会员卡列表]
B --> C[选择会员卡]
C --> D[确认购买]
D --> E[购买成功]
3.4.3 业务规则
会员卡类型规则
- 支持时长卡、次卡、储值卡
- ✅ 场景1：会员购买30天时长卡，有效期从购买日起30天
- ✅ 场景2：会员购买10次次卡，获得10次团课预约权益
- ✅ 场景3：会员购买1000元储值卡，余额为1000元
- ✅ 场景4：会员购买组合卡（30天时长卡+5次次卡），同时获得时长和次数权益
- ❌ 场景5：会员购买不存在的会员卡类型，系统提示"会员卡类型不存在"
到期提醒规则
- 会员卡到期前7天提醒
- ✅ 场景1：会员卡2026-03-15到期，系统在2026-03-08发送提醒
- ✅ 场景2：会员卡2026-03-08到期，系统在2026-03-01发送提醒
- ✅ 场景3：会员卡2026-03-08到期，系统每天发送提醒直到到期
- ❌ 场景4：会员卡2026-03-08到期，系统在2026-03-09发送提醒（已过期）
续费生效规则
- 会员卡续费后权益立即生效
- ✅ 场景1：会员卡剩余5次，续费10次后剩余15次
- ✅ 场景2：会员卡2026-03-08到期，续费30天后有效期延长至2026-04-07
- ✅ 场景3：会员卡余额200元，续费500元后余额700元
- ✅ 场景4：会员卡已过期，续费后立即恢复使用
- ❌ 场景5：会员卡续费失败，原权益保持不变
使用记录规则
- 会员卡使用记录永久保存
- ✅ 场景1：会员预约团课，记录预约时间、课程信息、权益扣减
- ✅ 场景2：会员签到，记录签到时间、地点、权益扣减
- ✅ 场景3：会员购买会员卡，记录购买时间、金额、权益获得
- ✅ 场景4：会员卡过期，历史使用记录仍可查询
- ✅ 场景5：会员注销账户，使用记录保留用于数据分析
3.4.4 异常处理
| 异常场景 | 处理方式 |
|---|---|
| 支付失败 | 提示用户重新支付 |
| 支付超时 | 提示用户重新发起支付 |
3.5 UI模版定制流程
3.5.1 业务场景
租户通过管理后台的可视化配置器定制自己的UI，包括品牌元素、布局结构和预设模板。
3.5.2 业务流程
flowchart LR
A[租户登录管理后台] --> B[打开UI定制器]
B --> C[品牌定制]
C --> D[布局调整]
D --> E[配置保存]
3.5.3 业务规则
- 品牌元素应用范围包括小程序和管理后台
- 布局调整支持拖拽排序和模块隐藏
- 预设模板应用后保留品牌配置
- 配置变更实时生效，无需重新部署
- 配置变更自动记录到历史
3.5.4 异常处理
| 异常场景 | 处理方式 |
|---|---|
| Logo上传失败 | 提示用户重新上传 |
| 配置保存失败 | 提示用户检查配置格式 |
| 模板应用失败 | 提示用户调整品牌配置 |
| 配置回滚失败 | 提示用户选择其他版本 |
四、用户角色和权限
4.1 角色定义
| 角色 | 描述 | 主要职责 |
|---|---|---|
| 会员 | 健身房注册用户 | 预约课程、签到、查看个人信息 |
| 教练 | 健身房教练 | 排课、团课签到管理 |
| 前台 | 门店前台人员 | 会员接待、签到辅助、会员管理 |
| 店长 | 门店管理者 | 单店全功能管理、数据查看 |
| 超级管理员 | 平台最高权限 | 全平台管理、系统配置 |
4.2 权限矩阵
| 功能模块 | 会员 | 教练 | 前台 | 店长 | 超级管理员 |
|---|---|---|---|---|---|
| 会员信息查看 | 自己 | 所有 | 所有 | 所有 | 所有 |
| 会员信息编辑 | 自己 | 无 | 所有 | 所有 | 所有 |
| 团课创建 | 无 | 是 | 否 | 是 | 是 |
| 团课编辑 | 无 | 自己 | 否 | 所有 | 所有 |
| 团课取消 | 无 | 自己 | 否 | 所有 | 所有 |
| 签到管理 | 无 | 是 | 是 | 是 | 是 |
| 数据统计查看 | 自己 | 自己 | 所有 | 所有 | 所有 |
| 系统配置 | 无 | 无 | 无 | 无 | 是 |
五、业务规则汇总
5.1 预约规则
| 规则名称 | 规则描述 |
|---|---|
| 预约时间限制 | 课程开始前至少30分钟 |
| 取消预约限制 | 课程开始前至少2小时 |
| 课程容量限制 | 每节课最多20人 |
| 权益扣减规则 | 预约成功后扣减权益 |
| 团课创建规则 | 需指定教练、时间、地点 |
| 团课取消规则 | 需提前24小时通知，自动退款 |
5.2 签到规则
| 规则名称 | 规则描述 |
|---|---|
| 会员卡验证规则 | 签到需验证会员卡有效性 |
| 预约验证规则 | 签到需验证预约信息（如有） |
| 签到记录规则 | 签到成功后记录到店时间 |
5.3 会员卡规则
| 规则名称 | 规则描述 |
|---|---|
| 会员卡类型规则 | 支持时长卡、次卡、储值卡 |
| 到期提醒规则 | 会员卡到期前7天提醒 |
| 续费生效规则 | 会员卡续费后权益立即生效 |
| 使用记录规则 | 会员卡使用记录永久保存 |
5.4 UI定制规则
| 规则名称 | 规则描述 |
|---|---|
| 品牌元素应用 | 应用范围包括小程序和管理后台 |
| 布局调整规则 | 支持拖拽排序和模块隐藏 |
| 预设模板规则 | 应用后保留品牌配置 |
| 配置生效规则 | 配置变更实时生效 |
| 配置历史规则 | 配置变更自动记录到历史 |
六、异常处理汇总
| 异常场景 | 处理方式 |
|---|---|
| 手机号已存在 | 提示用户直接登录 |
| 验证码错误 | 提示用户重新输入 |
| 验证码过期 | 提示用户重新获取 |
| 课程已满 | 提示用户选择其他课程 |
| 会员卡权益不足 | 提示用户购买会员卡 |
| 预约时间过短 | 提示用户提前预约 |
| 会员卡无效 | 提示用户购买会员卡 |
| 会员卡过期 | 提示用户续费 |
| 签到码无效 | 提示用户重新扫描 |
| 支付失败 | 提示用户重新支付 |
| 支付超时 | 提示用户重新发起支付 |
| Logo上传失败 | 提示用户重新上传 |
| 配置保存失败 | 提示用户检查配置格式 |
| 模板应用失败 | 提示用户调整品牌配置 |
| 配置回滚失败 | 提示用户选择其他版本 |
七、附录
7.1 业务流程图索引
| 流程名称 | 图表位置 |
|---|---|
| 会员注册流程 | 3.1.2 |
| 会员预约团课流程 | 3.2.2 |
| 教练创建团课流程 | 3.2.2 |
| 签到流程 | 3.3.2 |
| 会员卡购买流程 | 3.4.2 |
| UI模版定制流程 | 3.5.2 |
7.2 业务规则索引
| 规则分类 | 规则名称 | 图表位置 |
|---|---|---|
| 预约规则 | 预约时间限制 | 5.1 |
| 预约规则 | 取消预约限制 | 5.1 |
| 预约规则 | 课程容量限制 | 5.1 |
| 预约规则 | 权益扣减规则 | 5.1 |
| 预约规则 | 团课创建规则 | 5.1 |
| 预约规则 | 团课取消规则 | 5.1 |
| 签到规则 | 会员卡验证规则 | 5.2 |
| 签到规则 | 预约验证规则 | 5.2 |
| 签到规则 | 签到记录规则 | 5.2 |
| 会员卡规则 | 会员卡类型规则 | 5.3 |
| 会员卡规则 | 到期提醒规则 | 5.3 |
| 会员卡规则 | 续费生效规则 | 5.3 |
| 会员卡规则 | 使用记录规则 | 5.3 |
| UI定制规则 | 品牌元素应用 | 5.4 |
| UI定制规则 | 布局调整规则 | 5.4 |
| UI定制规则 | 预设模板规则 | 5.4 |
| UI定制规则 | 配置生效规则 | 5.4 |
| UI定制规则 | 配置历史规则 | 5.4 |
文档结束