张翔
478 lines
18 KiB
Markdown
478 lines
18 KiB
Markdown
# 健身房管理系统基础版业务概要设计文档（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. 为业务详细设计提供业务指导和约束
|
||
3. 作为产品经理、业务分析师的业务参考
|
||
|
||
### 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 业务范围
|
||
|
||
```mermaid
|
||
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 业务流程
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
A[用户打开小程序] --> B[填写手机号]
|
||
B --> C[验证手机号]
|
||
C --> D[填写基本信息]
|
||
D --> E[注册成功]
|
||
```
|
||
|
||
#### 3.1.3 业务规则
|
||
|
||
- 手机号需验证唯一性
|
||
- 手机号需通过短信验证码验证
|
||
- 支持微信授权快速注册
|
||
- 注册成功后自动创建会员档案
|
||
|
||
#### 3.1.4 异常处理
|
||
|
||
| 异常场景 | 处理方式 |
|
||
| ------------ | ---------------- |
|
||
| 手机号已存在 | 提示用户直接登录 |
|
||
| 验证码错误 | 提示用户重新输入 |
|
||
| 验证码过期 | 提示用户重新获取 |
|
||
|
||
---
|
||
|
||
### 3.2 团课预约流程
|
||
|
||
#### 3.2.1 业务场景
|
||
|
||
会员通过小程序预约团课，教练通过管理后台创建团课。
|
||
|
||
#### 3.2.2 业务流程
|
||
|
||
**会员预约团课**：
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
A[会员打开小程序] --> B[查看团课列表]
|
||
B --> C[选择团课]
|
||
C --> D[确认预约]
|
||
D --> E[预约成功]
|
||
```
|
||
|
||
**教练创建团课**：
|
||
|
||
```mermaid
|
||
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 业务流程
|
||
|
||
```mermaid
|
||
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 业务流程
|
||
|
||
```mermaid
|
||
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 业务流程
|
||
|
||
```mermaid
|
||
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 |
|
||
|
||
---
|
||
|
||
**文档结束**
|