# 健身房管理系统付费订阅版业务概要设计文档（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