# 健身房管理系统业务概要设计文档（HLD）

> 文档编号: GYM-HLD-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)                    | 资源的可预约时间窗口                             |

### 1.4 参考文档

- 《健身房管理系统产品设计文档》 GYM-PRD-001

---

## 二、业务概述

### 2.1 业务目标

| 目标维度 | 目标描述               | 成功指标                         |
| -------- | ---------------------- | -------------------------------- |
| 用户体验 | 提升会员预约和签到体验 | 预约成功率 ≥ 95%，签到耗时 ≤ 3秒 |
| 运营效率 | 降低人工操作成本       | 人工处理时间减少 50%             |
| 数据价值 | 提供数据驱动决策支持   | 数据报表使用率 ≥ 80%             |
| 业务扩展 | 支持多业态灵活适配     | 支持至少3种业态场景              |

### 2.2 用户角色

| 角色       | 描述           | 主要功能                     |
| ---------- | -------------- | ---------------------------- |
| 会员       | 健身房注册用户 | 预约课程、签到、查看个人信息 |
| 教练       | 健身房教练     | 排课、私教预约确认、学员签到 |
| 前台       | 门店前台人员   | 会员接待、签到辅助、会员管理 |
| 店长       | 门店管理者     | 单店全功能管理、数据查看     |
| 运营管理员 | 平台运营人员   | 营销活动配置、数据分析       |
| 财务专员   | 财务人员       | 账单管理、财务报表           |
| 超级管理员 | 平台最高权限   | 全平台管理、系统配置         |

### 2.3 业务范围

```
┌─────────────────────────────────────────────────────────────────────────┐
│                          业务范围                                      │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 会员管理                                                  │   │
│  ├─────────────────────────────────────────────────────────────────┤   │
│  │ • 会员注册  • 会员卡管理  • 权益管理  • 等级管理       │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 预约管理                                                  │   │
│  ├─────────────────────────────────────────────────────────────────┤   │
│  │ • 团课预约  • 私教预约  • 场地预约  • 线上课程          │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 签到管理                                                  │   │
│  ├─────────────────────────────────────────────────────────────────┤   │
│  │ • 扫码签到  • 刷脸签到  • NFC签到  • 教练代签            │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 课程管理                                                  │   │
│  ├─────────────────────────────────────────────────────────────────┤   │
│  │ • 课程类型  • 课程排期  • 场地管理  • 价格配置             │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 教练管理                                                  │   │
│  ├─────────────────────────────────────────────────────────────────┤   │
│  │ • 教练信息  • 排班管理  • 课时统计  • 评价管理           │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 财务管理                                                  │   │
│  ├─────────────────────────────────────────────────────────────────┤   │
│  │ • 营收统计  • 账单管理  • 退款管理  • 对账管理           │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 计划中心                                                  │   │
│  ├─────────────────────────────────────────────────────────────────┤   │
│  │ • 训练计划  • 课程排期  • 会员目标  • 教练排班           │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 数据分析                                                  │   │
│  ├─────────────────────────────────────────────────────────────────┤   │
│  │ • 会员分析  • 课程分析  • 财务分析  • 运营分析           │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 系统管理                                                  │   │
│  ├─────────────────────────────────────────────────────────────────┤   │
│  │ • 租户管理  • 门店管理  • 权限管理  • 系统配置           │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘
```

### 2.4 产品版本架构

本系统采用**基础版 + 订阅模块**的产品架构，满足不同规模和业态的健身房需求：

#### 2.4.1 基础版

基础版保证业务闭环，适合小型工作室、个人教练等场景：

**包含模块：**

- ✅ 会员管理（完整）
- ✅ 会员卡管理（完整）
- ✅ 权益管理（完整）
- ✅ 团课预约（完整）
- ✅ 扫码签到（完整）
- ✅ 基础数据统计（完整）
- ✅ 系统管理（基础）

**限制：**

- 会员数量：最多500人
- 门店数量：单门店
- 团课容量：每节课最多20人
- 数据保留：保留30天
- 导出功能：基础导出

#### 2.4.2 订阅模块

订阅模块按需订阅，灵活扩展功能：

**业务扩展类模块：**

- 🔒 私教管理模块
- 🔒 场地预约模块
- 🔒 线上课程模块

**体验升级类模块：**

- 🔒 人脸识别签到
- 🔒 NFC签到
- 🔒 智能储物柜

**营销增长类模块：**

- 🔒 营销活动模块
- 🔒 会员推荐奖励
- 🔒 会员互动社区

**数据智能类模块：**

- 🔒 高级数据分析
- 🔒 智能报表
- 🔒 AI运营建议

### 2.5 配置层级架构

本系统采用**三层配置架构**，支持租户级和门店级配置，支持配置继承和覆盖：

#### 2.5.1 配置层级

```
┌─────────────────────────────────────────────────────────────────────────┐
│                        配置层级架构                                  │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 系统默认配置                                             │   │
│  │ - 所有模块默认启用                                            │   │
│  │ - 基础功能默认配置                                            │   │
│  └──────────────────┬──────────────────────────────────────────┘   │
│                     │ 继承                                           │
│                     ▼                                                 │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 租户级配置                                                 │   │
│  │ - 租户A：启用团课、私教、营销                             │   │
│  │ - 租户B：只启用私教、营销                                 │   │
│  └──────────────────┬──────────────────────────────────────────┘   │
│                     │ 继承/覆盖                                         │
│                     ▼                                                 │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │ 门店级配置                                                 │   │
│  │ - 门店1：继承租户配置                                     │   │
│  │ - 门店2：继承租户配置 + 覆盖签到方式                   │   │
│  │ - 门店3：完全自定义配置                                   │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                     │
│  查询优先级：门店配置 → 租户配置 → 默认配置                     │
└─────────────────────────────────────────────────────────────────────────┘
```

#### 2.5.2 继承模式

| 继承模式      | 说明                           | 适用场景                           |
| ------------- | ------------------------------ | ---------------------------------- |
| **继承**      | 完全继承上级配置，不做任何修改 | 门店完全使用租户配置               |
| **继承+覆盖** | 继承上级配置，覆盖部分配置项   | 门店大部分使用租户配置，少量自定义 |
| **自定义**    | 完全自定义配置，不继承上级配置 | 门店有特殊需求，完全独立配置       |

#### 2.5.3 配置示例

**场景一：连锁品牌 - 门店完全继承**

- 租户A配置：启用团课、私教、营销
- 门店1配置：继承模式=继承
- 最终生效：与租户配置一致

**场景二：连锁品牌 - 门店继承+覆盖**

- 租户A配置：签到方式=[二维码]
- 门店2配置：继承模式=继承+覆盖，签到方式=[二维码,人脸]
- 最终生效：签到方式=[二维码,人脸]，其他配置继承租户

**场景三：精品工作室 - 完全自定义**

- 租户B配置：签到方式=[二维码]
- 门店3配置：继承模式=自定义，签到方式=[人脸]
- 最终生效：签到方式=[人脸]，不继承租户配置

---

## 三、核心业务流程

### 3.1 会员注册与入会流程

```
┌─────────────────────────────────────────────────────────────────────────┐
│                    会员注册与入会流程                                │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐   │
│  │  新用户  │────▶│  手机号  │────▶│  验证码  │────▶│  注册    │   │
│  │  访问    │     │  输入    │     │  验证    │     │  成功    │   │
│  └──────────┘     └──────────┘     └──────────┘     └──────────┘   │
│                                                         │           │
│                                                         ▼           │
│                                                 ┌──────────┐       │
│                                                 │  信息    │       │
│                                                 │  完善    │       │
│                                                 └──────────┘       │
│                                                         │           │
│                                                         ▼           │
│                                                 ┌──────────┐       │
│                                                 │  购买    │       │
│                                                 │  会员卡  │       │
│                                                 └──────────┘       │
│                                                         │           │
│                                                         ▼           │
│                                                 ┌──────────┐       │
│                                                 │  入会    │       │
│                                                 │  完成    │       │
│                                                 └──────────┘       │
│                                                                         │
│  业务规则:                                                              │
│  • 手机号必须唯一，一个手机号只能注册一个会员                              │
│  • 验证码有效期60秒，同一手机号60秒内只能发送一次                          │
│  • 会员信息完善后才能购买会员卡                                           │
│  • 会员卡购买成功后立即生效，权益即时可用                                   │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘
```

### 3.2 课程预约流程

```
┌─────────────────────────────────────────────────────────────────────────┐
│                      课程预约流程                                    │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐   │
│  │  会员    │────▶│  浏览    │────▶│  选择    │────▶│  确认    │   │
│  │  登录    │     │  课程    │     │  时段    │     │  预约    │   │
│  └──────────┘     └──────────┘     └──────────┘     └──────────┘   │
│                                                         │           │
│                                                         ▼           │
│                                                 ┌──────────┐       │
│                                                 │  权益    │       │
│                                                 │  检查    │       │
│                                                 └──────────┘       │
│                                                         │           │
│                                            ┌────────────┴────────┐   │
│                                            ▼                     ▼   │
│                                    ┌──────────┐          ┌──────────┐   │
│                                    │  预约    │          │  提示    │   │
│                                    │  成功    │          │  失败    │   │
│                                    └──────────┘          └──────────┘   │
│                                                                         │
│  业务规则:                                                              │
│  • 会员必须拥有足够的权益才能预约（次数、时长、储值等）                      │
│  • 同一时段只能预约一个课程，预约冲突时提示用户                              │
│  • 预约成功后发送通知（微信、短信）                                      │
│  • 预约取消时间限制：开课前2小时内不能取消                                  │
│  • 热门课程支持候补机制，满员后自动进入候补队列                            │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘
```

### 3.3 签到流程

```
┌─────────────────────────────────────────────────────────────────────────┐
│                        签到流程                                      │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐   │
│  │  会员    │────▶│  到达    │────▶│  选择    │────▶│  验证    │   │
│  │  到达    │     │  门店    │     │  签到方式│     │  身份    │   │
│  └──────────┘     └──────────┘     └──────────┘     └──────────┘   │
│                                                         │           │
│                                            ┌────────────┴────────┐   │
│                                            ▼                     ▼   │
│                                    ┌──────────┐          ┌──────────┐   │
│                                    │  扫码    │          │  刷脸    │   │
│                                    │  签到    │          │  签到    │   │
│                                    └──────────┘          └──────────┘   │
│                                            │                     │       │
│                                            └──────────┬──────────┘       │
│                                                       ▼                 │
│                                                 ┌──────────┐           │
│                                                 │  预约    │           │
│                                                 │  检查    │           │
│                                                 └──────────┘           │
│                                                       │                 │
│                                          ┌────────────┴────────┐       │
│                                          ▼                     ▼       │
│                                  ┌──────────┐          ┌──────────┐   │
│                                  │  签到    │          │  手动    │   │
│                                  │  成功    │          │  处理    │   │
│                                  └──────────┘          └──────────┘   │
│                                                                         │
│  业务规则:                                                              │
│  • 签到时验证会员身份和预约信息                                          │
│  • 有预约的会员优先签到，自动扣减权益                                      │
│  • 无预约的会员可以临时签到，需前台确认                                    │
│  • 签到成功后记录签到时间、设备信息                                        │
│  • 支持教练代签，教练可以确认学员签到                                      │
│  • 签到失败时提供明确的错误提示（如：预约不存在、权益不足）                    │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘
```

### 3.4 会员卡购买与激活流程

```
┌─────────────────────────────────────────────────────────────────────────┐
│                  会员卡购买与激活流程                                │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐   │
│  │  会员    │────▶│  浏览    │────▶│  选择    │────▶│  支付    │   │
│  │  登录    │     │  会员卡  │     │  卡类型  │     │  订单    │   │
│  └──────────┘     └──────────┘     └──────────┘     └──────────┘   │
│                                                         │           │
│                                                         ▼           │
│                                                 ┌──────────┐       │
│                                                 │  支付    │       │
│                                                 │  成功    │       │
│                                                 └──────────┘       │
│                                                         │           │
│                                                         ▼           │
│                                                 ┌──────────┐       │
│                                                 │  会员卡  │       │
│                                                 │  激活    │       │
│                                                 └──────────┘       │
│                                                         │           │
│                                                         ▼           │
│                                                 ┌──────────┐       │
│                                                 │  权益    │       │
│                                                 │  到账    │       │
│                                                 └──────────┘       │
│                                                                         │
│  业务规则:                                                              │
│  • 会员卡类型包括：时长卡、次卡、储值卡、等级卡                             │
│  • 支付成功后会员卡立即激活，权益即时到账                                  │
│  • 会员卡有效期从激活日开始计算                                            │
│  • 支持会员卡转让功能（可选，需店长审批）                                   │
│  • 会员卡到期前7天发送提醒通知                                            │
│  • 支持会员卡续费，续费后权益累加                                         │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘
```

---

## 四、业务规则

### 4.1 会员管理规则

#### 4.1.1 会员注册规则

- 手机号必须唯一，一个手机号只能注册一个会员
- 验证码有效期60秒，同一手机号60秒内只能发送一次
- 会员信息完善后才能购买会员卡
- 支持微信一键登录，自动关联手机号

#### 4.1.2 会员卡规则

- 会员卡类型：时长卡、次卡、储值卡、等级卡
- 会员卡支付成功后立即激活，权益即时到账
- 会员卡有效期从激活日开始计算
- 支持会员卡续费，续费后权益累加
- 会员卡到期前7天发送提醒通知
- 支持会员卡转让功能（可选，需店长审批）

#### 4.1.3 权益管理规则

- 权益类型：时长、次数、储值、等级
- 权益使用时优先级：储值 > 次数 > 时长 > 等级
- 权益扣减时先检查余额，余额不足时提示用户
- 权益使用记录永久保存，支持查询
- 权益到期后自动失效，不可使用

### 4.2 预约管理规则

#### 4.2.1 预约规则

- 会员必须拥有足够的权益才能预约（次数、时长、储值等）
- 同一时段只能预约一个课程，预约冲突时提示用户
- 预约成功后发送通知（微信、短信）
- 预约取消时间限制：开课前2小时内不能取消
- 热门课程支持候补机制，满员后自动进入候补队列
- 候补队列按预约时间排序，有人取消时自动补位

#### 4.2.2 课程排期规则

- 课程排期需提前至少24小时发布
- 课程排期修改需通知已预约会员
- 课程取消需提前2小时通知已预约会员
- 课程满员后自动开启候补
- 教练请假需提前24小时通知，系统自动调整排期

### 4.3 签到管理规则

#### 4.3.1 签到规则

- 签到时验证会员身份和预约信息
- 有预约的会员优先签到，自动扣减权益
- 无预约的会员可以临时签到，需前台确认
- 签到成功后记录签到时间、设备信息
- 支持教练代签，教练可以确认学员签到
- 签到失败时提供明确的错误提示（如：预约不存在、权益不足）

#### 4.3.2 签到时间规则

- 团课签到时间：开课前30分钟至开课后10分钟
- 私教签到时间：预约时间前后15分钟内
- 临时签到时间：门店营业时间内
- 迟到超过10分钟视为缺勤，不扣减权益

### 4.4 财务管理规则

#### 4.4.1 支付规则

- 支持多种支付方式：微信支付、支付宝、银行卡
- 支付成功后立即到账，实时更新财务数据
- 支持退款，退款需店长审批
- 退款原路返回，到账时间取决于支付渠道
- 支持对账功能，每日自动对账

#### 4.4.2 账单规则

- 账单实时生成，支持查询和导出
- 账单包含：订单号、金额、支付方式、时间、状态
- 账单状态：待支付、已支付、已退款、已取消
- 支持按时间、门店、会员、类型筛选账单
- 账单数据永久保存，支持审计

### 4.5 数据分析规则

#### 4.5.1 数据统计规则

- 数据实时统计，支持实时查询
- 数据按天、周、月、季度、年度汇总
- 支持多维度数据分析：会员、课程、财务、运营
- 数据报表支持导出：Excel、PDF
- 数据可视化：图表、趋势图、排行榜

#### 4.5.2 数据权限规则

- 超级管理员：查看全平台数据
- 运营管理员：查看负责区域数据
- 店长：查看本店数据
- 财务专员：查看财务数据
- 其他角色：按权限查看对应数据

### 4.6 订阅管理规则

#### 4.6.1 订阅套餐规则

- 基础版：包含核心业务模块，保证业务闭环
- 订阅模块：按需订阅，灵活扩展功能
- 组合套餐：多个模块组合，享受优惠价格
- 计费方式：月付、季付、半年付、年付，年付享受最大折扣
- 试用政策：不同模块类型提供不同天数的试用

#### 4.6.2 订阅生命周期规则

- 订阅状态：正常、暂停、取消、过期
- 订阅续费：到期前7天提醒，到期当天自动续费
- 订阅取消：取消后立即生效，不退还当月费用
- 订阅暂停：暂停期间不扣费，暂停期间无法使用模块
- 订阅过期：过期后立即禁用模块，数据保留30天

#### 4.6.3 订阅模块规则

- 模块启用：订阅成功后立即启用，无需重启
- 模块禁用：取消订阅后立即禁用，数据保留
- 模块配置：支持租户级和门店级配置，支持继承和覆盖
- 模块试用：试用期内可免费使用，试用结束后自动续费或取消
- 模块升级：支持模块升级，升级后立即生效，按差价计费

#### 4.6.4 配置继承规则

- 查询优先级：门店配置 → 租户配置 → 默认配置
- 继承模式：继承、继承+覆盖、自定义
- 配置版本：每次配置变更自动记录版本，支持回滚
- 配置缓存：配置数据缓存5分钟，配置变更后立即刷新缓存
- 配置审计：记录所有配置变更操作，支持审计查询

---

## 五、业务场景

### 5.1 典型业务场景

#### 5.1.1 会员预约团课场景

**场景描述**：
会员小李想预约明天晚上7点的瑜伽课程，他打开会员小程序，浏览课程列表，找到瑜伽课程，查看课程详情，确认教练、场地、时间，检查自己的会员权益（次卡剩余5次），确认可以预约，点击预约按钮，系统验证权益余额，预约成功，收到微信通知。

**业务流程**：

1. 会员登录小程序
2. 浏览课程列表
3. 选择瑜伽课程
4. 查看课程详情
5. 检查会员权益
6. 确认预约
7. 系统验证权益
8. 预约成功
9. 发送通知

**涉及的业务规则**：

- 会员必须拥有足够的权益才能预约
- 同一时段只能预约一个课程
- 预约成功后发送通知

#### 5.1.2 会员签到场景

**场景描述**：
会员小李到达健身房，打开会员小程序，点击签到按钮，选择刷脸签到，系统识别人脸，验证身份，检查预约信息，确认有预约，签到成功，自动扣减权益（次卡剩余4次），记录签到时间和设备信息。

**业务流程**：

1. 会员到达健身房
2. 打开会员小程序
3. 点击签到按钮
4. 选择刷脸签到
5. 系统识别人脸
6. 验证身份
7. 检查预约信息
8. 签到成功
9. 扣减权益
10. 记录签到信息

**涉及的业务规则**：

- 签到时验证会员身份和预约信息
- 有预约的会员优先签到，自动扣减权益
- 签到成功后记录签到时间、设备信息

#### 5.1.3 教练排课场景

**场景描述**：
教练王老师想安排下周的私教课程，他打开教练端App，查看自己的排班表，选择下周三下午2点到3点的时间段，选择私教课程，填写课程名称、课程描述，选择场地，设置价格，发布课程，系统自动生成预约时段，会员可以开始预约。

**业务流程**：

1. 教练登录教练端App
2. 查看排班表
3. 选择时间段
4. 选择课程类型
5. 填写课程信息
6. 选择场地
7. 设置价格
8. 发布课程
9. 系统生成预约时段
10. 会员可以预约

**涉及的业务规则**：

- 课程排期需提前至少24小时发布
- 课程排期修改需通知已预约会员
- 课程满员后自动开启候补

#### 5.1.4 店长查看数据场景

**场景描述**：
店长张经理想查看今天的运营数据，他打开管理后台，点击数据看板，查看今日概览（会员数、预约数、签到数、营收），查看趋势数据（近7天预约趋势、近30天营收趋势），查看排行数据（热门课程排行、活跃会员排行），导出数据报表。

**业务流程**：

1. 店长登录管理后台
2. 点击数据看板
3. 查看今日概览
4. 查看趋势数据
5. 查看排行数据
6. 导出数据报表

**涉及的业务规则**：

- 数据实时统计，支持实时查询
- 数据按天、周、月、季度、年度汇总
- 支持多维度数据分析
- 数据报表支持导出

#### 5.1.5 租户订阅场景

**场景描述**：
租户A是一家连锁健身房品牌，想启用私教管理和营销活动模块，租户管理员登录管理后台，查看订阅套餐，选择私教管理模块和营销活动模块，选择年付方式，查看优惠信息，确认订阅，支付成功，模块立即启用，租户开始使用新功能。

**业务流程**：

1. 租户管理员登录管理后台
2. 查看订阅套餐
3. 选择订阅模块
4. 选择计费方式
5. 查看优惠信息
6. 确认订阅
7. 支付成功
8. 模块立即启用
9. 开始使用新功能

**涉及的业务规则**：

- 订阅成功后模块立即启用，无需重启
- 年付享受最大折扣
- 支持多种支付方式
- 订阅成功后发送通知

#### 5.1.6 门店配置继承场景

**场景描述**：
租户A配置了团课、私教、营销模块，门店1想完全继承租户配置，门店2想在租户配置基础上覆盖签到方式（增加人脸识别），门店3想完全自定义配置。各门店管理员登录管理后台，选择继承模式，配置门店级参数，保存配置，配置立即生效。

**业务流程**：

1. 门店管理员登录管理后台
2. 查看租户级配置
3. 选择继承模式（继承/继承+覆盖/自定义）
4. 配置门店级参数
5. 保存配置
6. 配置立即生效
7. 验证配置生效

**涉及的业务规则**：

- 查询优先级：门店配置 → 租户配置 → 默认配置
- 支持三种继承模式
- 配置变更后立即生效
- 配置变更记录版本，支持回滚

### 5.2 特殊业务场景

#### 5.2.1 热门课程抢课场景

**场景描述**：
热门课程（如普拉提）只有10个名额，但有多名会员同时预约，系统采用先到先得的原则，前10名预约成功的会员获得名额，其他会员自动进入候补队列，有会员取消预约时，候补队列中的会员自动补位。

**业务流程**：

1. 多名会员同时预约热门课程
2. 系统处理预约请求
3. 前10名预约成功
4. 其他会员进入候补队列
5. 有会员取消预约
6. 候补队列中的会员自动补位
7. 发送补位通知

**涉及的业务规则**：

- 同一时段只能预约一个课程
- 热门课程支持候补机制
- 候补队列按预约时间排序
- 有人取消时自动补位

#### 5.2.2 会员卡过期续费场景

**场景描述**：
会员小李的会员卡即将过期，系统提前7天发送提醒通知，小李收到通知后，打开会员小程序，查看会员卡信息，点击续费按钮，选择续费时长，支付成功，会员卡续费成功，权益累加，有效期延长。

**业务流程**：

1. 系统检测会员卡即将过期
2. 提前7天发送提醒通知
3. 会员收到通知
4. 打开会员小程序
5. 查看会员卡信息
6. 点击续费按钮
7. 选择续费时长
8. 支付成功
9. 会员卡续费成功
10. 权益累加，有效期延长

**涉及的业务规则**：

- 会员卡到期前7天发送提醒通知
- 支持会员卡续费，续费后权益累加
- 会员卡有效期从续费成功日开始计算

#### 5.2.3 签到异常处理场景

**场景描述**：
会员小李到达健身房，尝试刷脸签到，但系统无法识别人脸，小李选择扫码签到，扫描二维码，系统验证身份，但发现没有预约，前台工作人员手动处理，确认会员身份，临时签到成功。

**业务流程**：

1. 会员到达健身房
2. 尝试刷脸签到
3. 系统无法识别人脸
4. 选择扫码签到
5. 扫描二维码
6. 系统验证身份
7. 发现没有预约
8. 前台手动处理
9. 确认会员身份
10. 临时签到成功

**涉及的业务规则**：

- 签到时验证会员身份和预约信息
- 无预约的会员可以临时签到，需前台确认
- 签到失败时提供明确的错误提示

---

## 六、业务约束

### 6.1 数据约束

- 会员手机号必须唯一
- 会员ID全局唯一
- 预约ID全局唯一
- 签到记录ID全局唯一
- 会员卡ID全局唯一
- 订单ID全局唯一

### 6.2 时间约束

- 验证码有效期60秒
- 预约取消时间限制：开课前2小时内不能取消
- 课程排期需提前至少24小时发布
- 课程取消需提前2小时通知已预约会员
- 教练请假需提前24小时通知
- 团课签到时间：开课前30分钟至开课后10分钟
- 私教签到时间：预约时间前后15分钟内
- 会员卡到期前7天发送提醒通知

### 6.3 权益约束

- 会员必须拥有足够的权益才能预约
- 权益使用时优先级：储值 > 次数 > 时长 > 等级
- 权益扣减时先检查余额，余额不足时提示用户
- 权益到期后自动失效，不可使用
- 权益使用记录永久保存，支持查询

### 6.4 并发约束

- 同一时段只能预约一个课程
- 热门课程支持候补机制
- 候补队列按预约时间排序
- 有人取消时自动补位
- 支持高并发场景（QPS ≥ 1000）

---

## 七、业务指标

### 7.1 用户体验指标

| 指标名称   | 目标值 | 测量方法                    |
| ---------- | ------ | --------------------------- |
| 预约成功率 | ≥ 95%  | 预约成功次数 / 预约总次数   |
| 签到耗时   | ≤ 3秒  | 签到完成时间 - 签到开始时间 |
| 注册成功率 | ≥ 98%  | 注册成功次数 / 注册总次数   |
| 支付成功率 | ≥ 99%  | 支付成功次数 / 支付总次数   |

### 7.2 运营效率指标

| 指标名称         | 目标值 | 测量方法                                                       |
| ---------------- | ------ | -------------------------------------------------------------- |
| 人工处理时间减少 | ≥ 50%  | (优化前人工处理时间 - 优化后人工处理时间) / 优化前人工处理时间 |
| 预约取消率       | ≤ 10%  | 预约取消次数 / 预约总次数                                      |
| 签到成功率       | ≥ 98%  | 签到成功次数 / 签到总次数                                      |
| 会员活跃度       | ≥ 60%  | 活跃会员数 / 总会员数                                          |

### 7.3 数据价值指标

| 指标名称       | 目标值 | 测量方法                        |
| -------------- | ------ | ------------------------------- |
| 数据报表使用率 | ≥ 80%  | 使用数据报表的用户数 / 总用户数 |
| 数据准确性     | ≥ 99%  | 数据准确记录数 / 数据总记录数   |
| 数据实时性     | ≤ 1秒  | 数据更新时间 - 数据产生时间     |

### 7.4 系统性能指标

| 指标名称     | 目标值     | 测量方法                     |
| ------------ | ---------- | ---------------------------- |
| 系统可用性   | ≥ 99.9%    | (总时间 - 故障时间) / 总时间 |
| 响应时间     | ≤ 2秒      | 请求响应时间                 |
| 并发处理能力 | ≥ 1000 QPS | 每秒处理请求数               |

---

## 八、附录

### 8.1 业务术语表

| 术语                          | 定义                                             |
| ----------------------------- | ------------------------------------------------ |
| 租户(Tenant)                  | 系统的多租户架构中的独立业务实体，如一个连锁品牌 |
| 门店(Store)                   | 租户下的具体经营场所                             |
| 会员(Member)                  | 在门店注册的用户                                 |
| 权益(Benefit)                 | 会员卡包含的时长、次数、储值、等级等权益         |
| 可预约资源(Bookable Resource) | 团课、私教、场地、线上课程等可被预约的对象       |
| 时段(Slot)                    | 资源的可预约时间窗口                             |
| 预约(Booking)                 | 会员预订课程或场地的行为                         |
| 签到(Check-in)                | 会员到达健身房并记录到达时间的行为               |
| 会员卡(Member Card)           | 会员购买的权益载体，包含时长、次数、储值等       |
| 候补(Waitlist)                | 课程满员后，会员进入等待队列，有空位时自动补位   |

### 8.2 参考文档

- 《健身房管理系统产品设计文档》 GYM-PRD-001
- 《健身房管理系统详细设计文档》 GYM-LLD-001

---

**文档结束**