novalon/gym-manage
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: reorganize documentation structure

Browse Source
This commit is contained in:
张翔
2026-03-05 13:48:13 +08:00
parent 349b0a754f
commit 104fa7e7c8
59 changed files with 22859 additions and 916 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/archive/v1.0/HLD-系统概要设计.md
+879
View File
@@ -0,0 +1,879 @@
# 健身房管理系统业务概要设计文档（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
---
**文档结束**
docs/archive/v1.0/PRD-产品设计文档.md
+929
View File
@@ -0,0 +1,929 @@
# 健身房管理系统产品设计文档（PRD）
> 文档编号: GYM-PRD-001
> 版本: v1.0
> 日期: 2026-02-28
> 作者: 张翔
> 状态: 初稿
---
## 文档修订历史
| 版本 | 日期 | 作者 | 修订内容 |
|------|------|------|---------|
| v1.0 | 2026-02-28 | 张翔 | 初稿 |
---
## 一、产品概述
### 1.1 产品背景
随着健身行业数字化转型的加速，传统健身房面临着会员管理效率低、预约流程繁琐、数据统计困难等痛点。本系统旨在为综合型健身俱乐部、精品工作室、连锁品牌提供全场景的数字化管理平台，实现：
- 会员端：一站式查看个人所有信息，便捷预约签到
- 管理后台：全维度数据整理与分析，支撑运营决策
- 多业态支持：灵活适配不同规模和类型的健身场所
### 1.2 产品目标
| 目标维度 | 目标描述 | 成功指标 |
|---------|---------|---------|
| 用户体验 | 提升会员预约和签到体验 | 预约成功率 ≥ 95%，签到耗时 ≤ 3秒 |
| 运营效率 | 降低人工操作成本 | 人工处理时间减少 50% |
| 数据价值 | 提供数据驱动决策支持 | 数据报表使用率 ≥ 80% |
| 系统稳定 | 保证高可用性 | SLA ≥ 99.9% |
### 1.4 产品版本架构
本系统采用**基础版 + 订阅模块**的产品架构，满足不同规模和业态的健身房需求：
#### 1.4.1 基础版
基础版保证业务闭环，适合小型工作室、个人教练等场景：
**包含模块：**
- ✅ 会员管理（完整）
- ✅ 会员卡管理（完整）
- ✅ 权益管理（完整）
- ✅ 团课预约（完整）
- ✅ 扫码签到（完整）
- ✅ 基础数据统计（完整）
- ✅ 系统管理（基础）
**限制：**
- 会员数量：最多500人
- 门店数量：单门店
- 团课容量：每节课最多20人
- 数据保留：保留30天
- 导出功能：基础导出
#### 1.4.2 订阅模块
订阅模块按需订阅，灵活扩展功能：
**业务扩展类模块：**
- 🔒 私教管理模块（¥299/月）
- 🔒 场地预约模块（¥199/月）
- 🔒 线上课程模块（¥399/月）
**体验升级类模块：**
- 🔒 人脸识别签到（¥499/月）
- 🔒 NFC签到（¥199/月）
- 🔒 智能储物柜（¥299/月）
**营销增长类模块：**
- 🔒 营销活动模块（¥399/月）
- 🔒 会员推荐奖励（¥299/月）
- 🔒 会员互动社区（¥499/月）
**数据智能类模块：**
- 🔒 高级数据分析（¥599/月）
- 🔒 智能报表（¥399/月）
- 🔒 AI运营建议（¥799/月）
**计费方式：**
- 月付：按月计费，每月自动续费
- 季付：一次性支付3个月，享受9折
- 半年付：一次性支付6个月，享受85折
- 年付：一次性支付12个月，享受8折 + 赠送1个月
**组合套餐：**
- 基础套餐：基础版 + 私教管理 + 营销活动（¥599/月）
- 高级套餐：基础版 + 全部业务扩展模块（¥799/月）
- 尊享套餐：基础版 + 全部模块（¥1999/月）
**试用政策：**
- 业务扩展类模块：14天试用
- 体验升级类模块：7天试用
- 营销增长类模块：14天试用
- 数据智能类模块：7天试用
### 1.3 目标用户
| 用户角色 | 用户画像 | 核心需求 |
|---------|---------|---------|
| **会员** | 25-45岁健身爱好者，追求健康生活方式 | 便捷预约、快速签到、查看个人信息、追踪健身进度 |
| **教练** | 专业健身教练，需要管理课程和学员 | 课程排期、学员签到、课时统计、评价管理 |
| **前台** | 门店前台人员，负责日常接待 | 会员接待、签到辅助、会员信息查询 |
| **店长** | 门店管理者，负责门店运营 | 单店全功能管理、数据查看、员工管理 |
| **运营管理员** | 平台运营人员，负责营销和数据分析 | 营销活动配置、数据分析、报表生成 |
| **财务专员** | 财务人员，负责账务管理 | 账单管理、财务报表、对账处理 |
| **超级管理员** | 平台最高权限管理者 | 全平台管理、系统配置、权限管理 |
---
## 二、功能需求
### 2.1 会员管理
#### 2.1.1 会员注册与信息管理
**用户故事**: 作为新用户，我可以通过手机号注册成为会员，以便开始使用系统
**功能描述**:
- 支持手机号+验证码注册
- 支持微信一键登录
- 会员信息完善（姓名、性别、生日、头像等）
- 会员信息查询和修改
- 会员状态管理（正常、冻结、注销）
**验收标准**:
- 注册流程在30秒内完成
- 验证码60秒内到达
- 支持手机号脱敏显示
- 敏感信息（手机号、身份证）加密存储
#### 2.1.2 会员卡管理
**用户故事**: 作为会员，我可以购买和管理会员卡，以便享受相应的权益
**功能描述**:
- 会员卡类型管理（时长卡、次卡、储值卡、等级卡）
- 会员卡购买流程
- 会员卡信息查询
- 会员卡激活/冻结/注销
- 会员卡转让（可选）
**验收标准**:
- 支持多种支付方式（微信、支付宝、银行卡）
- 会员卡购买成功后立即生效
- 支持会员卡有效期提醒
- 支持会员卡使用记录查询
#### 2.1.3 权益管理
**用户故事**: 作为会员，我可以查看我的权益余额和使用情况，以便合理安排健身计划
**功能描述**:
- 权益类型管理（时长、次数、储值、等级）
- 权益余额查询
- 权益使用记录
- 权益到期提醒
- 权益扣减和充值
**验收标准**:
- 权益余额实时更新
- 支持权益到期前3天提醒
- 权益扣减记录可追溯
- 支持权益转让（可选）
#### 2.1.4 等级管理
**用户故事**: 作为会员，我可以查看我的等级和积分，以便了解我的会员权益
**功能描述**:
- 会员等级体系定义
- 等级升级规则
- 等级权益配置
- 积分获取规则
- 积分兑换规则
**验收标准**:
- 等级升级自动触发
- 等级权益清晰展示
- 积分获取和使用记录可查询
- 支持等级权益差异化
### 2.2 预约管理
#### 2.2.1 团课预约
**用户故事**: 作为会员，我可以预约团课，以便参加我感兴趣的课程
**功能描述**:
- 团课列表展示（按时间、类型、教练筛选）
- 团课详情查看
- 团课预约
- 预约取消
- 预约提醒
**验收标准**:
- 支持提前7天预约
- 支持课程开始前2小时取消
- 预约成功后立即发送通知
- 支持预约冲突检测
#### 2.2.2 私教预约
**用户故事**: 作为会员，我可以预约私教课程，以便获得一对一指导
**功能描述**:
- 教练列表展示
- 教练详情查看
- 教练可预约时段查询
- 私教课程预约
- 预约取消
**验收标准**:
- 支持查看教练排班
- 支持选择预约时间段
- 支持预约备注
- 支持教练确认机制
#### 2.2.3 场地预约
**用户故事**: 作为会员，我可以预约场地，以便自主训练
**功能描述**:
- 场地列表展示
- 场地详情查看
- 场地可用时段查询
- 场地预约
- 预约取消
**验收标准**:
- 支持场地类型筛选
- 支持查看场地实时占用情况
- 支持预约时长限制
- 支持预约超时自动释放
#### 2.2.4 线上课程预约
**用户故事**: 作为会员，我可以预约线上课程，以便在家锻炼
**功能描述**:
- 线上课程列表展示
- 课程详情查看
- 课程预约
- 课程回放
- 课程评价
**验收标准**:
- 支持课程分类浏览
- 支持课程搜索
- 支持课程收藏
- 支持课程进度追踪
### 2.3 签到管理
#### 2.3.1 扫码签到
**用户故事**: 作为会员，我可以通过扫码快速签到，以便节省时间
**功能描述**:
- 生成会员二维码
- 扫码签到
- 签到验证
- 签到记录查询
**验收标准**:
- 二维码有效期5分钟
- 签到响应时间 ≤ 2秒
- 支持重复签到检测
- 签到成功后发送通知
#### 2.3.2 人脸识别签到
**用户故事**: 作为会员，我可以通过人脸识别自动签到，以便实现无感入场
**功能描述**:
- 人脸信息采集
- 人脸特征存储
- 人脸识别签到
- 签到记录查询
**验收标准**:
- 人脸识别准确率 ≥ 99%
- 识别响应时间 ≤ 1秒
- 支持人脸信息更新
- 支持多人同时识别
#### 2.3.3 NFC签到
**用户故事**: 作为会员，我可以通过NFC快速签到，以便便捷入场
**功能描述**:
- NFC卡绑定
- NFC签到
- 签到验证
- 签到记录查询
**验收标准**:
- 支持ISO 14443 Type A/B标准
- 签到响应时间 ≤ 1秒
- 支持NFC卡挂失
- 支持NFC卡解绑
#### 2.3.4 教练代签
**用户故事**: 作为教练，我可以为会员代签，以便处理特殊情况
**功能描述**:
- 教练登录验证
- 选择会员
- 代签操作
- 代签记录查询
**验收标准**:
- 支持按手机号搜索会员
- 支持代签备注
- 代签记录可追溯
- 支持代签权限控制
### 2.4 课程管理
#### 2.4.1 课程类型管理
**用户故事**: 作为运营管理员，我可以管理课程类型，以便分类展示课程
**功能描述**:
- 课程类型增删改查
- 课程类型排序
- 课程类型图标
- 课程类型描述
**验收标准**:
- 支持多级分类
- 支持课程类型启用/禁用
- 支持课程类型搜索
- 支持课程类型统计
#### 2.4.2 课程排期
**用户故事**: 作为教练，我可以管理课程排期，以便安排我的教学计划
**功能描述**:
- 课程排期创建
- 课程排期修改
- 课程排期删除
- 课程排期查询
**验收标准**:
- 支持按周/月视图查看
- 支持拖拽调整排期
- 支持排期冲突检测
- 支持排期复制
#### 2.4.3 场地管理
**用户故事**: 作为店长，我可以管理场地信息，以便合理分配资源
**功能描述**:
- 场地信息增删改查
- 场地容量设置
- 场地设备管理
- 场地状态管理
**验收标准**:
- 支持场地图片上传
- 支持场地设备清单
- 支持场地维护状态
- 支持场地使用统计
#### 2.4.4 价格配置
**用户故事**: 作为运营管理员，我可以配置课程价格，以便灵活定价
**功能描述**:
- 课程价格设置
- 会员卡价格设置
- 折扣规则配置
- 价格生效时间
**验收标准**:
- 支持多种价格类型
- 支持会员等级折扣
- 支持促销活动价格
- 支持价格历史查询
### 2.5 教练管理
#### 2.5.1 教练信息管理
**用户故事**: 作为店长，我可以管理教练信息，以便展示教练资料
**功能描述**:
- 教练信息增删改查
- 教练资质管理
- 教练照片上传
- 教练简介编辑
**验收标准**:
- 支持教练资质证书上传
- 支持教练擅长领域标注
- 支持教练评价展示
- 支持教练排序
#### 2.5.2 排班管理
**用户故事**: 作为教练，我可以管理我的排班，以便安排工作时间
**功能描述**:
- 排班创建
- 排班修改
- 排班删除
- 排班查询
**验收标准**:
- 支持按日/周/月视图
- 支持设置可预约时段
- 支持设置休息日
- 支持排班模板
#### 2.5.3 课时统计
**用户故事**: 作为教练，我可以查看我的课时统计，以便了解工作量
**功能描述**:
- 课时统计查询
- 课时明细查看
- 课时趋势分析
- 课时报表导出
**验收标准**:
- 支持按时间段统计
- 支持按课程类型统计
- 支持课时收入统计
- 支持数据可视化
#### 2.5.4 评价管理
**用户故事**: 作为会员，我可以对教练进行评价，以便提供反馈
**功能描述**:
- 评价提交
- 评价查看
- 评价回复
- 评价统计
**验收标准**:
- 支持星级评价
- 支持文字评价
- 支持评价图片
- 支持评价匿名
### 2.6 财务管理
#### 2.6.1 营收统计
**用户故事**: 作为财务专员，我可以查看营收统计，以便了解经营状况
**功能描述**:
- 营收数据统计
- 营收趋势分析
- 营收对比分析
- 营收报表导出
**验收标准**:
- 支持按日/周/月统计
- 支持按门店统计
- 支持按业务类型统计
- 支持数据可视化
#### 2.6.2 账单管理
**用户故事**: 作为会员，我可以查看我的账单，以便了解消费情况
**功能描述**:
- 账单列表查询
- 账单详情查看
- 账单筛选
- 账单导出
**验收标准**:
- 支持按时间筛选
- 支持按类型筛选
- 支持账单详情查看
- 支持账单PDF导出
#### 2.6.3 退款管理
**用户故事**: 作为运营管理员，我可以处理退款申请，以便提升用户满意度
**功能描述**:
- 退款申请查看
- 退款审核
- 退款处理
- 退款记录查询
**验收标准**:
- 支持退款原因分类
- 支持退款审核流程
- 支持退款状态跟踪
- 支持退款统计
#### 2.6.4 对账管理
**用户故事**: 作为财务专员，我可以进行对账操作，以便确保账务准确
**功能描述**:
- 对账数据导入
- 对账差异分析
- 对账确认
- 对账报表
**验收标准**:
- 支持多渠道对账
- 支持自动对账
- 支持差异标记
- 支持对账记录
### 2.7 计划中心
#### 2.7.1 训练计划
**用户故事**: 作为会员，我可以制定训练计划，以便科学健身
**功能描述**:
- 训练计划创建
- 训练计划编辑
- 训练计划执行
- 训练计划分享
**验收标准**:
- 支持模板选择
- 支持自定义计划
- 支持计划执行记录
- 支持计划进度追踪
#### 2.7.2 课程排期
**用户故事**: 作为运营管理员，我可以管理课程排期，以便合理安排课程
**功能描述**:
- 课程排期查看
- 课程排期调整
- 课程排期冲突检测
- 课程排期导出
**验收标准**:
- 支持多维度视图
- 支持批量调整
- 支持排期提醒
- 支持排期统计
#### 2.7.3 会员目标
**用户故事**: 作为会员，我可以设置健身目标，以便激励自己
**功能描述**:
- 目标设置
- 目标进度追踪
- 目标达成提醒
- 目标历史记录
**验收标准**:
- 支持多种目标类型
- 支持目标周期设置
- 支持目标可视化
- 支持目标分享
#### 2.7.4 教练排班
**用户故事**: 作为店长，我可以管理教练排班，以便合理安排人力
**功能描述**:
- 教练排班查看
- 教练排班调整
- 教练排班统计
- 教练排班导出
**验收标准**:
- 支持按门店查看
- 支持按教练查看
- 支持排班冲突检测
- 支持排班优化建议
### 2.8 数据分析
#### 2.8.1 会员分析
**用户故事**: 作为运营管理员，我可以查看会员分析，以便了解会员情况
**功能描述**:
- 会员增长分析
- 会员活跃度分析
- 会员留存分析
- 会员画像分析
**验收标准**:
- 支持多维度分析
- 支持趋势图表
- 支持数据钻取
- 支持报表导出
#### 2.8.2 课程分析
**用户故事**: 作为运营管理员，我可以查看课程分析，以便优化课程安排
**功能描述**:
- 课程预约分析
- 课程签到分析
- 课程评价分析
- 课程收益分析
**验收标准**:
- 支持按课程类型分析
- 支持按时间段分析
- 支持数据对比
- 支持优化建议
#### 2.8.3 财务分析
**用户故事**: 作为财务专员，我可以查看财务分析，以便了解财务状况
**功能描述**:
- 收入分析
- 支出分析
- 利润分析
- 现金流分析
**验收标准**:
- 支持多维度分析
- 支持预算对比
- 支持预测分析
- 支持风险预警
#### 2.8.4 运营分析
**用户故事**: 作为运营管理员，我可以查看运营分析，以便优化运营策略
**功能描述**:
- 整体运营指标
- 门店运营对比
- 员工绩效分析
- 营销效果分析
**验收标准**:
- 支持实时数据
- 支持自定义指标
- 支持数据预警
- 支持决策建议
### 2.9 系统管理
#### 2.9.1 租户管理
**用户故事**: 作为超级管理员，我可以管理租户，以便支持多租户架构
**功能描述**:
- 租户信息增删改查
- 租户配置管理
- 租户状态管理
- 租户数据隔离
**验收标准**:
- 支持租户独立配置
- 支持租户数据隔离
- 支持租户计费
- 支持租户监控
#### 2.9.2 门店管理
**用户故事**: 作为超级管理员，我可以管理门店，以便支持多门店运营
**功能描述**:
- 门店信息增删改查
- 门店配置管理
- 门店状态管理
- 门店数据统计
**验收标准**:
- 支持门店图片上传
- 支持门店地址定位
- 支持门店营业时间设置
- 支持门店数据隔离
#### 2.9.3 权限管理
**用户故事**: 作为超级管理员，我可以管理权限，以便控制用户访问
**功能描述**:
- 角色管理
- 权限管理
- 用户角色分配
- 权限审计
**验收标准**:
- 支持RBAC模型
- 支持权限继承
- 支持权限审计
- 支持权限测试
#### 2.9.4 系统配置
**用户故事**: 作为超级管理员，我可以配置系统参数，以便灵活调整系统行为
**功能描述**:
- 系统参数配置
- 业务规则配置
- 接口配置
- 日志配置
**验收标准**:
- 支持参数分类管理
- 支持参数生效时间
- 支持参数变更记录
- 支持参数导出
### 2.10 订阅管理
#### 2.10.1 订阅套餐管理
**用户故事**: 作为超级管理员，我可以管理订阅套餐，以便为租户提供灵活的订阅选择
**功能描述**:
- 订阅套餐增删改查
- 套餐类型管理（基础版、订阅模块、组合套餐）
- 套餐价格配置（月付、季付、半年付、年付）
- 套餐折扣配置
- 套餐试用天数配置
- 套餐状态管理（上架、下架）
**验收标准**:
- 支持套餐分类展示
- 支持套餐价格自动计算
- 支持套餐优惠展示
- 支持套餐试用配置
#### 2.10.2 租户订阅管理
**用户故事**: 作为超级管理员，我可以管理租户订阅，以便跟踪租户的订阅状态
**功能描述**:
- 租户订阅查询
- 订阅详情查看
- 订阅状态管理（正常、暂停、取消、过期）
- 订阅续费处理
- 订阅取消处理
- 订阅升级/降级处理
**验收标准**:
- 支持订阅状态实时更新
- 支持订阅自动续费
- 支持订阅变更记录
- 支持订阅提醒通知
#### 2.10.3 订阅模块管理
**用户故事**: 作为租户管理员，我可以管理订阅模块，以便按需启用/禁用功能
**功能描述**:
- 订阅模块查询
- 模块启用/禁用
- 模块配置管理
- 模块试用期管理
- 模块使用统计
**验收标准**:
- 支持模块即时启用/禁用
- 支持模块配置继承（门店继承租户配置）
- 支持模块试用期自动结束
- 支持模块使用量统计
#### 2.10.4 订阅计费管理
**用户故事**: 作为财务专员，我可以管理订阅计费，以便准确收取订阅费用
**功能描述**:
- 订阅账单生成
- 订阅账单查询
- 订阅支付处理
- 订阅退款处理
- 订阅对账管理
- 订阅发票管理
**验收标准**:
- 支持账单自动生成
- 支持多种支付方式
- 支持账单PDF导出
- 支持对账差异分析
#### 2.10.5 订阅配置管理
**用户故事**: 作为租户管理员，我可以管理订阅配置，以便灵活调整订阅策略
**功能描述**:
- 租户级模块配置
- 门店级模块配置
- 配置继承模式管理（继承、继承+覆盖、自定义）
- 配置变更历史查询
- 配置回滚功能
**验收标准**:
- 支持配置层级管理（租户→门店）
- 支持配置继承模式切换
- 支持配置变更追溯
- 支持配置版本回滚
---
## 三、非功能需求
### 3.1 性能需求
| 指标 | 要求 | 说明 |
|-------|------|------|
| 响应时间 | API响应时间 ≤ 500ms | 95%的请求 |
| 并发能力 | 支持1000 QPS | 热门课程抢课场景 |
| 数据库查询 | 单次查询 ≤ 100ms | 索引优化 |
| 页面加载 | 首屏加载 ≤ 2秒 | 3G网络环境 |
### 3.2 可用性需求
| 指标 | 要求 | 说明 |
|-------|------|------|
| 系统可用性 | SLA ≥ 99.9% | 年度停机时间 ≤ 8.76小时 |
| 故障恢复 | RTO ≤ 30分钟 | 恢复时间目标 |
| 数据备份 | 每日备份 | 保留30天 |
| 容灾能力 | 支持异地容灾 | RPO ≤ 1小时 |
### 3.3 安全性需求
| 指标 | 要求 | 说明 |
|-------|------|------|
| 数据加密 | 敏感数据加密存储 | AES-256 |
| 传输加密 | HTTPS加密传输 | TLS 1.2+ |
| 认证安全 | JWT Token认证 | 有效期2小时 |
| 权限控制 | RBAC权限模型 | 最小权限原则 |
| 审计日志 | 操作日志记录 | 保留90天 |
### 3.4 可扩展性需求
| 指标 | 要求 | 说明 |
|-------|------|------|
| 水平扩展 | 支持应用集群部署 | 无状态设计 |
| 数据库扩展 | 支持读写分离 | 主从复制 |
| 缓存扩展 | 支持Redis集群 | 分布式缓存 |
| 存储扩展 | 支持OSS对象存储 | 海量文件存储 |
### 3.5 可维护性需求
| 指标 | 要求 | 说明 |
|-------|------|------|
| 代码规范 | 遵循编码规范 | SonarQube检查 |
| 文档完善 | 代码注释率 ≥ 30% | 关键逻辑注释 |
| 日志规范 | 统一日志格式 | ELK日志分析 |
| 监控告警 | 实时监控 | Prometheus+Grafana |
---
## 四、用户故事与验收标准
### 4.1 会员端用户故事
| 用户故事 | 优先级 | 验收标准 |
|---------|-------|---------|
| 作为新用户，我可以通过手机号注册成为会员 | P0 | 注册流程在30秒内完成，验证码60秒内到达 |
| 作为会员，我可以购买会员卡 | P0 | 支持多种支付方式，购买成功后立即生效 |
| 作为会员，我可以预约团课 | P0 | 支持提前7天预约，预约成功后立即发送通知 |
| 作为会员，我可以通过扫码签到 | P0 | 二维码有效期5分钟，签到响应时间 ≤ 2秒 |
| 作为会员，我可以查看我的权益余额 | P1 | 权益余额实时更新，支持到期前3天提醒 |
| 作为会员，我可以设置健身目标 | P2 | 支持多种目标类型，支持目标可视化 |
### 4.2 管理端用户故事
| 用户故事 | 优先级 | 验收标准 |
|---------|-------|---------|
| 作为店长，我可以查看门店数据 | P0 | 支持实时数据查看，支持数据导出 |
| 作为教练，我可以管理课程排期 | P0 | 支持按周/月视图，支持拖拽调整 |
| 作为运营管理员，我可以配置课程价格 | P0 | 支持多种价格类型，支持会员等级折扣 |
| 作为财务专员，我可以查看营收统计 | P1 | 支持按日/周/月统计，支持数据可视化 |
| 作为超级管理员，我可以管理租户 | P1 | 支持租户独立配置，支持租户数据隔离 |
---
## 五、项目里程碑
| 阶段 | 时间 | 交付内容 |
|------|------|---------|
| 第一阶段 | 2026-03-01 ~ 2026-03-31 | 会员管理、预约管理、签到管理核心功能 |
| 第二阶段 | 2026-04-01 ~ 2026-04-30 | 课程管理、教练管理、财务管理 |
| 第三阶段 | 2026-05-01 ~ 2026-05-31 | 计划中心、数据分析、系统管理 |
| 第四阶段 | 2026-06-01 ~ 2026-06-30 | 系统优化、性能调优、上线部署 |
---
## 六、风险与应对
| 风险 | 影响 | 概率 | 应对措施 |
|------|------|------|---------|
| 需求变更频繁 | 高 | 中 | 采用敏捷开发，快速迭代 |
| 技术选型不当 | 高 | 低 | 充分调研，POC验证 |
| 性能不达标 | 中 | 中 | 提前性能测试，优化瓶颈 |
| 安全漏洞 | 高 | 低 | 安全审计，渗透测试 |
| 人员流动 | 中 | 中 | 知识沉淀，文档完善 |
---
## 七、成功标准
| 维度 | 指标 | 目标值 |
|------|------|-------|
| 功能完整性 | 需求覆盖率 | ≥ 95% |
| 用户体验 | 用户满意度 | ≥ 4.5/5.0 |
| 系统性能 | 响应时间 | ≤ 500ms |
| 系统稳定性 | SLA | ≥ 99.9% |
| 代码质量 | 代码覆盖率 | ≥ 80% |
---
## 八、参考文档
- 健身房行业数字化转型趋势报告
- 健身房管理系统竞品分析报告
- 用户体验设计规范
- 移动应用设计指南
- 数据安全与隐私保护规范