张翔
880 lines
49 KiB
Markdown
880 lines
49 KiB
Markdown
# 健身房管理系统业务概要设计文档（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
|
||
|
||
---
|
||
|
||
**文档结束**
|