张翔
544 lines
23 KiB
Markdown
544 lines
23 KiB
Markdown
# 健身房管理系统付费订阅版业务概要设计文档（HLD）
|
||
|
||
> 文档编号: GYM-HLD-SUBSCRIPTION-001
|
||
> 版本: v1.0
|
||
> 日期: 2026-03-04
|
||
> 作者: 张翔
|
||
> 状态: 初稿
|
||
|
||
---
|
||
|
||
## 文档修订历史
|
||
|
||
| 版本 | 日期 | 作者 | 修订内容 |
|
||
| ---- | ---------- | ---- | ------------------ |
|
||
| v1.0 | 2026-03-04 | 张翔 | 创建付费订阅版业务概要设计 |
|
||
|
||
---
|
||
|
||
## 一、引言
|
||
|
||
### 1.1 编写目的
|
||
|
||
本文档为健身房管理系统付费订阅版的业务概要设计文档（High-Level Design），旨在：
|
||
|
||
1. 从业务层面描述付费订阅版的业务范围、业务流程、业务规则
|
||
2. 为付费订阅版详细设计提供业务指导和约束
|
||
3. 作为产品经理、业务分析师、开发人员的业务参考
|
||
|
||
### 1.2 项目背景
|
||
|
||
健身房管理系统付费订阅版在基础版基础上，提供丰富的增值功能，满足中大型健身房、连锁品牌等复杂场景需求。
|
||
|
||
### 1.3 术语定义
|
||
|
||
| 术语 | 定义 |
|
||
| ----------------------------- | ------------------------------------------------ |
|
||
| 租户(Tenant) | 系统的多租户架构中的独立业务实体，如一个连锁品牌 |
|
||
| 门店(Store) | 租户下的具体经营场所 |
|
||
| 会员(Member) | 在门店注册的用户 |
|
||
| 权益(Benefit) | 会员卡包含的时长、次数、储值、等级等权益 |
|
||
| 可预约资源(Bookable Resource) | 团课、私教、场地、线上课程等可被预约的对象 |
|
||
| 时段(Slot) | 资源的可预约时间窗口 |
|
||
| 订阅模块(Subscription Module) | 按需订阅的增值功能模块 |
|
||
| 配置继承(Configuration Inheritance) | 门店配置继承租户配置的机制 |
|
||
|
||
### 1.4 参考文档
|
||
|
||
- 《健身房管理系统付费订阅版产品设计文档》 GYM-PRD-SUBSCRIPTION-001
|
||
- 《健身房管理系统业务概要设计文档》 GYM-HLD-001
|
||
- 《订阅与配置模块详细设计文档》 GYM-LLD-004
|
||
|
||
---
|
||
|
||
## 二、业务概述
|
||
|
||
### 2.1 业务目标
|
||
|
||
| 目标维度 | 目标描述 | 成功指标 |
|
||
| -------- | ---------------------- | -------------------------------- |
|
||
| 用户体验 | 提升会员预约和签到体验 | 预约成功率 ≥ 95%，签到耗时 ≤ 3秒 |
|
||
| 运营效率 | 降低人工操作成本 | 人工处理时间减少 50% |
|
||
| 数据价值 | 提供数据驱动决策支持 | 数据报表使用率 ≥ 80% |
|
||
| 业务增长 | 提升会员留存和增长 | 会员留存率提升 20% |
|
||
|
||
### 2.2 用户角色
|
||
|
||
| 角色 | 描述 | 主要功能 |
|
||
| ---------- | -------------- | ---------------------------- |
|
||
| 会员 | 健身房注册用户 | 预约课程、签到、查看个人信息、参与社区 |
|
||
| 教练 | 健身房教练 | 排课、私教预约确认、学员签到、发布线上课程 |
|
||
| 前台 | 门店前台人员 | 会员接待、签到辅助、会员管理 |
|
||
| 店长 | 门店管理者 | 单店全功能管理、数据查看、营销活动管理 |
|
||
| 运营管理员 | 平台运营人员 | 营销活动配置、数据分析、AI运营建议查看 |
|
||
| 财务专员 | 财务人员 | 账单管理、财务报表 |
|
||
| 超级管理员 | 平台最高权限 | 全平台管理、系统配置 |
|
||
|
||
### 2.3 业务范围
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────────┐
|
||
│ 付费订阅版业务范围 │
|
||
├─────────────────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ 基础功能（包含基础版所有功能） │ │
|
||
│ ├─────────────────────────────────────────────────────────────────┤ │
|
||
│ │ • 会员管理 • 预约管理 • 签到管理 • 数据统计 • 系统管理 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ 订阅与配置管理 │ │
|
||
│ ├─────────────────────────────────────────────────────────────────┤ │
|
||
│ │ • 订阅管理 • 配置管理 • 套餐管理 • 计费管理 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ 业务扩展类模块 │ │
|
||
│ ├─────────────────────────────────────────────────────────────────┤ │
|
||
│ │ • 私教管理 • 场地预约 • 线上课程 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ 体验升级类模块 │ │
|
||
│ ├─────────────────────────────────────────────────────────────────┤ │
|
||
│ │ • 人脸识别签到 • NFC签到 • 智能储物柜 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ 营销增长类模块 │ │
|
||
│ ├─────────────────────────────────────────────────────────────────┤ │
|
||
│ │ • 营销活动 • 会员推荐奖励 • 会员互动社区 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ 数据智能类模块 │ │
|
||
│ ├─────────────────────────────────────────────────────────────────┤ │
|
||
│ │ • 高级数据分析 • 智能报表 • AI运营建议 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
||
│ │ 营销分析与预测模块 │ │
|
||
│ ├─────────────────────────────────────────────────────────────────┤ │
|
||
│ │ • 营销精算模型 • 促销策略预测 • 促销活动效果预测 │ │
|
||
│ └─────────────────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 三、核心业务流程
|
||
|
||
### 3.1 订阅流程
|
||
|
||
#### 3.1.1 业务场景
|
||
|
||
租户管理员通过管理后台订阅增值模块。
|
||
|
||
#### 3.1.2 业务流程
|
||
|
||
```
|
||
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
||
│ 租户管理 │ → │ 查看订阅 │ → │ 选择订阅 │ → │ 确认订阅 │ → │ 模块立即 │
|
||
│ 员登录 │ │ 套餐 │ │ 模块 │ │ │ │ 启用 │
|
||
└─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘
|
||
```
|
||
|
||
#### 3.1.3 业务规则
|
||
|
||
- 订阅成功后模块立即启用
|
||
- 年付享受最大折扣
|
||
- 支持多种支付方式
|
||
- 订阅成功后发送通知
|
||
|
||
#### 3.1.4 异常处理
|
||
|
||
| 异常场景 | 处理方式 |
|
||
|---------|---------|
|
||
| 支付失败 | 提示用户重新支付 |
|
||
| 支付超时 | 提示用户重新发起支付 |
|
||
|
||
---
|
||
|
||
### 3.2 配置继承流程
|
||
|
||
#### 3.2.1 业务场景
|
||
|
||
门店管理员配置门店级参数，可以选择继承租户级配置。
|
||
|
||
#### 3.2.2 业务流程
|
||
|
||
```
|
||
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
||
│ 门店管理 │ → │ 查看租户 │ → │ 选择继承 │ → │ 配置门店 │ → │ 配置立即 │
|
||
│ 员登录 │ │ 级配置 │ │ 模式 │ │ 级参数 │ │ 生效 │
|
||
└─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘
|
||
```
|
||
|
||
#### 3.2.3 业务规则
|
||
|
||
- 查询优先级：门店配置 → 租户配置 → 默认配置
|
||
- 支持三种继承模式（继承/继承+覆盖/自定义）
|
||
- 配置变更后立即生效
|
||
- 配置变更记录版本，支持回滚
|
||
|
||
#### 3.2.4 异常处理
|
||
|
||
| 异常场景 | 处理方式 |
|
||
|---------|---------|
|
||
| 配置冲突 | 提示用户选择覆盖或合并 |
|
||
| 配置无效 | 提示用户重新配置 |
|
||
|
||
---
|
||
|
||
### 3.3 私教预约流程
|
||
|
||
#### 3.3.1 业务场景
|
||
|
||
会员通过小程序预约私教课程。
|
||
|
||
#### 3.3.2 业务流程
|
||
|
||
```
|
||
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
||
│ 会员打开 │ → │ 查看私教 │ → │ 选择私教 │ → │ 确认预约 │ → │ 预约成功 │
|
||
│ 小程序 │ │ 课程列表 │ │ 课程 │ │ │ │ │
|
||
└─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘
|
||
```
|
||
|
||
#### 3.3.3 业务规则
|
||
|
||
- 私教预约需提前至少24小时
|
||
- 私教取消需提前至少12小时
|
||
- 私教签到后记录考勤
|
||
|
||
#### 3.3.4 异常处理
|
||
|
||
| 异常场景 | 处理方式 |
|
||
|---------|---------|
|
||
| 教练时间冲突 | 提示用户选择其他时间 |
|
||
| 会员卡权益不足 | 提示用户购买会员卡 |
|
||
|
||
---
|
||
|
||
### 3.4 营销活动创建流程
|
||
|
||
#### 3.4.1 业务场景
|
||
|
||
运营管理员通过管理后台创建营销活动。
|
||
|
||
#### 3.4.2 业务流程
|
||
|
||
```
|
||
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
||
│ 运营管理 │ → │ 创建营销 │ → │ 配置活动 │ → │ 发布活动 │ → │ 活动生效 │
|
||
│ 员登录 │ │ 活动 │ │ 规则 │ │ │ │ │
|
||
└─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘
|
||
```
|
||
|
||
#### 3.4.3 业务规则
|
||
|
||
- 营销活动需指定时间、规则、奖励
|
||
- 营销活动发布后不可修改规则
|
||
- 营销活动统计按活动、时间维度
|
||
|
||
#### 3.4.4 异常处理
|
||
|
||
| 异常场景 | 处理方式 |
|
||
|---------|---------|
|
||
| 活动时间冲突 | 提示用户调整活动时间 |
|
||
| 活动规则无效 | 提示用户重新配置 |
|
||
|
||
---
|
||
|
||
### 3.5 营销分析与预测流程
|
||
|
||
#### 3.5.1 业务场景
|
||
|
||
运营管理员使用营销精算模型预测促销策略。
|
||
|
||
#### 3.5.2 业务流程
|
||
|
||
```
|
||
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
||
│ 运营管理 │ → │ 选择营销 │ → │ 配置促销 │ → │ 预测效果 │ → │ 查看预测 │
|
||
│ 员登录 │ │ 精算模型 │ │ 参数 │ │ │ │ 结果 │
|
||
└─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘
|
||
```
|
||
|
||
#### 3.5.3 业务规则
|
||
|
||
- 营销精算模型基于历史数据
|
||
- 促销策略预测提供多种方案
|
||
- 促销活动效果预测基于历史数据
|
||
|
||
#### 3.5.4 异常处理
|
||
|
||
| 异常场景 | 处理方式 |
|
||
|---------|---------|
|
||
| 历史数据不足 | 提示用户积累更多数据 |
|
||
| 预测失败 | 提示用户调整参数 |
|
||
|
||
---
|
||
|
||
## 四、核心业务规则
|
||
|
||
### 4.1 订阅管理规则
|
||
|
||
| 规则 | 描述 |
|
||
|------|------|
|
||
| 订阅生效 | 订阅成功后模块立即启用 |
|
||
| 计费周期 | 支持月付、季付、半年付、年付 |
|
||
| 试用政策 | 不同模块类型提供不同试用时长 |
|
||
| 组合套餐 | 支持组合套餐，享受更多优惠 |
|
||
|
||
### 4.2 配置管理规则
|
||
|
||
| 规则 | 描述 |
|
||
|------|------|
|
||
| 配置继承 | 支持门店配置继承租户配置 |
|
||
| 继承模式 | 支持继承、继承+覆盖、自定义三种模式 |
|
||
| 配置优先级 | 门店配置 → 租户配置 → 默认配置 |
|
||
| 配置版本 | 配置变更记录版本，支持回滚 |
|
||
|
||
### 4.3 私教管理规则
|
||
|
||
| 规则 | 描述 |
|
||
|------|------|
|
||
| 私教预约时间 | 私教预约需提前至少24小时 |
|
||
| 私教取消时间 | 私教取消需提前至少12小时 |
|
||
| 私教考勤 | 私教签到后记录考勤 |
|
||
|
||
### 4.4 营销活动规则
|
||
|
||
| 规则 | 描述 |
|
||
|------|------|
|
||
| 活动规则 | 营销活动需指定时间、规则、奖励 |
|
||
| 活动修改 | 营销活动发布后不可修改规则 |
|
||
| 活动统计 | 营销活动统计按活动、时间维度 |
|
||
|
||
### 4.5 营销分析与预测规则
|
||
|
||
| 规则 | 描述 |
|
||
|------|------|
|
||
| 模型基础 | 营销精算模型基于历史数据 |
|
||
| 预测方案 | 促销策略预测提供多种方案 |
|
||
| 效果预测 | 促销活动效果预测基于历史数据 |
|
||
|
||
---
|
||
|
||
## 五、业务场景
|
||
|
||
### 5.1 租户订阅场景
|
||
|
||
**场景描述**：
|
||
租户A是一家连锁健身房品牌，想启用私教管理和营销活动模块，租户管理员登录管理后台，查看订阅套餐，选择私教管理模块和营销活动模块，选择年付方式，查看优惠信息，确认订阅，支付成功，模块立即启用，租户开始使用新功能。
|
||
|
||
**业务流程**：
|
||
|
||
1. 租户管理员登录管理后台
|
||
2. 查看订阅套餐
|
||
3. 选择订阅模块
|
||
4. 选择计费方式
|
||
5. 查看优惠信息
|
||
6. 确认订阅
|
||
7. 支付成功
|
||
8. 模块立即启用
|
||
9. 开始使用新功能
|
||
|
||
**涉及的业务规则**：
|
||
|
||
- 订阅成功后模块立即启用，无需重启
|
||
- 年付享受最大折扣
|
||
- 支持多种支付方式
|
||
- 订阅成功后发送通知
|
||
|
||
---
|
||
|
||
### 5.2 门店配置继承场景
|
||
|
||
**场景描述**：
|
||
租户A配置了团课、私教、营销模块，门店1想完全继承租户配置，门店2想在租户配置基础上覆盖签到方式（增加人脸识别），门店3想完全自定义配置。各门店管理员登录管理后台，选择继承模式，配置门店级参数，保存配置，配置立即生效。
|
||
|
||
**业务流程**：
|
||
|
||
1. 门店管理员登录管理后台
|
||
2. 查看租户级配置
|
||
3. 选择继承模式（继承/继承+覆盖/自定义）
|
||
4. 配置门店级参数
|
||
5. 保存配置
|
||
6. 配置立即生效
|
||
7. 验证配置生效
|
||
|
||
**涉及的业务规则**：
|
||
|
||
- 查询优先级：门店配置 → 租户配置 → 默认配置
|
||
- 支持三种继承模式
|
||
- 配置变更后立即生效
|
||
- 配置变更记录版本，支持回滚
|
||
|
||
---
|
||
|
||
### 5.3 私教预约场景
|
||
|
||
**场景描述**：
|
||
会员张三想预约私教课程，通过小程序查看私教课程列表，选择教练李四，选择时间，确认预约，预约成功，接收提醒。
|
||
|
||
**业务流程**：
|
||
|
||
1. 张三打开小程序
|
||
2. 查看私教课程列表
|
||
3. 选择教练李四
|
||
4. 选择时间
|
||
5. 确认预约
|
||
6. 预约成功
|
||
7. 接收提醒
|
||
|
||
**涉及的业务规则**：
|
||
|
||
- 私教预约需提前至少24小时
|
||
- 私教取消需提前至少12小时
|
||
- 私教签到后记录考勤
|
||
|
||
---
|
||
|
||
### 5.4 营销活动创建场景
|
||
|
||
**场景描述**：
|
||
运营管理员王五想创建一个新会员注册送月卡的活动，登录管理后台，创建营销活动，配置活动规则（新会员注册送月卡），配置活动奖励（月卡一张），发布活动，活动生效，开始监控活动效果。
|
||
|
||
**业务流程**：
|
||
|
||
1. 王五登录管理后台
|
||
2. 创建营销活动
|
||
3. 配置活动规则（新会员注册送月卡）
|
||
4. 配置活动奖励（月卡一张）
|
||
5. 发布活动
|
||
6. 活动生效
|
||
7. 开始监控活动效果
|
||
|
||
**涉及的业务规则**：
|
||
|
||
- 营销活动需指定时间、规则、奖励
|
||
- 营销活动发布后不可修改规则
|
||
- 营销活动统计按活动、时间维度
|
||
|
||
---
|
||
|
||
### 5.5 营销分析与预测场景
|
||
|
||
**场景描述**：
|
||
运营管理员赵六想预测一个新会员注册送月卡活动的效果，登录管理后台，选择营销精算模型，配置促销参数（活动时间、目标人群、奖励金额），预测活动效果，查看预测结果（预计新增会员数、预计成本、预计收益）。
|
||
|
||
**业务流程**：
|
||
|
||
1. 赵六登录管理后台
|
||
2. 选择营销精算模型
|
||
3. 配置促销参数（活动时间、目标人群、奖励金额）
|
||
4. 预测活动效果
|
||
5. 查看预测结果（预计新增会员数、预计成本、预计收益）
|
||
|
||
**涉及的业务规则**：
|
||
|
||
- 营销精算模型基于历史数据
|
||
- 促销策略预测提供多种方案
|
||
- 促销活动效果预测基于历史数据
|
||
|
||
---
|
||
|
||
## 六、数据模型
|
||
|
||
### 6.1 核心实体
|
||
|
||
| 实体 | 描述 |
|
||
|------|------|
|
||
| 租户(Tenant) | 系统的多租户架构中的独立业务实体 |
|
||
| 门店(Store) | 租户下的具体经营场所 |
|
||
| 会员(Member) | 在门店注册的用户 |
|
||
| 会员卡(MemberCard) | 会员购买的权益卡 |
|
||
| 权益(Benefit) | 会员卡包含的权益 |
|
||
| 团课(GroupClass) | 集体课程 |
|
||
| 私教课程(PrivateClass) | 私教课程 |
|
||
| 预约(Booking) | 会员预约记录 |
|
||
| 签到(CheckIn) | 会员签到记录 |
|
||
| 订阅(Subscription) | 租户订阅记录 |
|
||
| 配置(Config) | 租户或门店配置 |
|
||
| 营销活动(MarketingActivity) | 营销活动 |
|
||
| 营销预测(MarketingPrediction) | 营销预测结果 |
|
||
|
||
### 6.2 实体关系
|
||
|
||
```
|
||
租户(Tenant) ──1:N── 门店(Store)
|
||
租户(Tenant) ──1:N── 订阅(Subscription)
|
||
租户(Tenant) ──1:N── 配置(Config)
|
||
门店(Store) ──1:N── 会员(Member)
|
||
门店(Store) ──1:N── 配置(Config)
|
||
会员(Member) ──1:N── 会员卡(MemberCard)
|
||
会员(Member) ──1:N── 预约(Booking)
|
||
会员(Member) ──1:N── 签到(CheckIn)
|
||
会员卡(MemberCard) ──1:N── 权益(Benefit)
|
||
团课(GroupClass) ──1:N── 预约(Booking)
|
||
私教课程(PrivateClass) ──1:N── 预约(Booking)
|
||
营销活动(MarketingActivity) ──1:N── 营销预测(MarketingPrediction)
|
||
```
|
||
|
||
---
|
||
|
||
## 七、技术约束
|
||
|
||
### 7.1 性能约束
|
||
|
||
| 指标 | 要求 |
|
||
|------|------|
|
||
| API响应时间 | ≤ 500ms |
|
||
| 并发用户 | 支持500并发用户 |
|
||
| 数据库查询 | 查询响应时间 ≤ 1s |
|
||
|
||
### 7.2 可用性约束
|
||
|
||
| 指标 | 要求 |
|
||
|------|------|
|
||
| 系统可用性 | SLA ≥ 99.9% |
|
||
| 故障恢复时间 | MTTR ≤ 30分钟 |
|
||
|
||
### 7.3 安全性约束
|
||
|
||
| 指标 | 要求 |
|
||
|------|------|
|
||
| 数据加密 | 敏感数据加密存储 |
|
||
| 访问控制 | 基于角色的访问控制 |
|
||
| 操作审计 | 关键操作记录审计日志 |
|
||
| 支付安全 | 支持安全支付通道 |
|
||
|
||
### 7.4 可扩展性约束
|
||
|
||
| 指标 | 要求 |
|
||
|------|------|
|
||
| 会员数量 | 不限制 |
|
||
| 门店数量 | 支持多门店 |
|
||
| 团课容量 | 不限制 |
|
||
| 数据保留 | 永久保存 |
|
||
|
||
---
|
||
|
||
## 八、附录
|
||
|
||
### 8.1 术语定义
|
||
|
||
| 术语 | 定义 |
|
||
|------|------|
|
||
| 订阅模块 | 按需订阅的增值功能模块 |
|
||
| 私教管理 | 私教课程管理、私教预约、私教签到等功能 |
|
||
| 营销活动 | 吸引新会员和提升会员活跃度的活动 |
|
||
| 营销精算模型 | 基于历史数据预测促销策略的模型 |
|
||
| 促销活动效果预测 | 基于历史数据预测促销活动效果 |
|
||
| 配置继承 | 门店配置继承租户配置的机制 |
|
||
|
||
### 8.2 参考文档
|
||
|
||
- 《健身房管理系统付费订阅版产品设计文档》 GYM-PRD-SUBSCRIPTION-001
|
||
- 《健身房管理系统业务概要设计文档》 GYM-HLD-001
|
||
- 《订阅与配置模块详细设计文档》 GYM-LLD-004
|