novalon/gym-manage

Fork 0

Files

T

张翔 104fa7e7c8 docs: reorganize documentation structure

2026-03-05 13:48:13 +08:00

23 KiB

Raw Blame History

健身房管理系统付费订阅版业务概要设计文档（HLD）

文档编号: GYM-HLD-SUBSCRIPTION-001
版本: v1.0
日期: 2026-03-04
作者: 张翔
状态: 初稿

文档修订历史

版本	日期	作者	修订内容
v1.0	2026-03-04	张翔	创建付费订阅版业务概要设计

一、引言

1.1 编写目的

本文档为健身房管理系统付费订阅版的业务概要设计文档（High-Level Design），旨在：

从业务层面描述付费订阅版的业务范围、业务流程、业务规则
为付费订阅版详细设计提供业务指导和约束
作为产品经理、业务分析师、开发人员的业务参考

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

业务流程：

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

涉及的业务规则：

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

5.2 门店配置继承场景

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

业务流程：

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

涉及的业务规则：

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

5.3 私教预约场景

场景描述：会员张三想预约私教课程，通过小程序查看私教课程列表，选择教练李四，选择时间，确认预约，预约成功，接收提醒。

业务流程：

张三打开小程序
查看私教课程列表
选择教练李四
选择时间
确认预约
预约成功
接收提醒

涉及的业务规则：

私教预约需提前至少24小时
私教取消需提前至少12小时
私教签到后记录考勤

5.4 营销活动创建场景

场景描述：运营管理员王五想创建一个新会员注册送月卡的活动，登录管理后台，创建营销活动，配置活动规则（新会员注册送月卡），配置活动奖励（月卡一张），发布活动，活动生效，开始监控活动效果。

业务流程：

王五登录管理后台
创建营销活动
配置活动规则（新会员注册送月卡）
配置活动奖励（月卡一张）
发布活动
活动生效
开始监控活动效果

涉及的业务规则：

营销活动需指定时间、规则、奖励
营销活动发布后不可修改规则
营销活动统计按活动、时间维度

5.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

23 KiB Raw Blame History Unescape Escape

健身房管理系统付费订阅版业务概要设计文档（HLD）

文档修订历史

一、引言

1.1 编写目的

1.2 项目背景

1.3 术语定义

1.4 参考文档

二、业务概述

2.1 业务目标

2.2 用户角色

2.3 业务范围

三、核心业务流程

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 业务规则

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 私教管理规则

4.4 营销活动规则

4.5 营销分析与预测规则

五、业务场景

5.1 租户订阅场景

5.2 门店配置继承场景

5.3 私教预约场景

5.4 营销活动创建场景

5.5 营销分析与预测场景

六、数据模型

6.1 核心实体

6.2 实体关系

七、技术约束

7.1 性能约束

7.2 可用性约束

7.3 安全性约束

7.4 可扩展性约束

八、附录

8.1 术语定义

8.2 参考文档

23 KiB

Raw Blame History