# 健身房管理系统基础版业务详细设计文档（B-LLD）
> 文档编号: GYM-B-LLD-BASIC-001
> 版本: v1.0
> 日期: 2026-03-08
> 作者: 张翔
> 状态: 已发布
---
## 文档修订历史
| 版本 | 日期 | 作者 | 修订内容 |
| ---- | ---------- | ---- | ---------------------- |
| v1.0 | 2026-03-08 | 张翔 | 创建基础版业务详细设计文档 |
---
## 一、引言
### 1.1 编写目的
本文档为健身房管理系统基础版的业务详细设计文档（Business Low-Level Design），旨在：
1. 详细描述业务流程、业务规则、异常处理
2. 为技术实现提供详细的业务指导
3. 作为业务分析师、开发人员的业务参考
### 1.2 项目背景
健身房管理系统基础版是面向小型工作室、个人教练等场景的核心版本，保证业务闭环，提供完整的会员管理、预约、签到等核心功能。
### 1.3 术语定义
| 术语 | 定义 |
| ----------------------------- | ------------------------------------------------ |
| 租户(Tenant) | 系统的多租户架构中的独立业务实体，如一个连锁品牌 |
| 门店(Store) | 租户下的具体经营场所 |
| 会员(Member) | 在门店注册的用户 |
| 权益(Benefit) | 会员卡包含的时长、次数、储值、等级等权益 |
| 可预约资源(Bookable Resource) | 团课等可被预约的对象 |
| 时段(Slot) | 资源的可预约时间窗口 |
### 1.4 参考文档
- 《健身房管理系统基础版产品设计文档》 GYM-PRD-BASIC-001
- 《健身房管理系统基础版业务概要设计文档》 GYM-B-HLD-BASIC-001
---
## 二、详细业务流程
### 2.1 会员全生命周期流程
#### 2.1.1 业务场景
从会员注册到流失的完整生命周期管理，包括新会员激活、活跃期维护、沉默期干预、流失预警和挽回。
#### 2.1.2 业务流程
```mermaid
flowchart LR
A[新会员注册] --> B[首次到店引导]
B --> C[新会员激活期
7天内完成首次到店]
C --> D[活跃期维护
持续到店和消费]
D --> E{活跃度评估}
E -->|活跃| F[持续运营
推送个性化内容]
E -->|沉默| G[沉默期干预
7天未到店触发]
G --> H{干预效果}
H -->|成功| D
H -->|失败| I[流失预警
30天未到店触发]
I --> J{挽回策略}
J -->|挽回成功| D
J -->|挽回失败| K[会员流失
标记为流失状态]
K --> L[归档分析
流失原因分析]
style A fill:#e1f5ff
style C fill:#fff4e1
style G fill:#ffe1e1
style I fill:#ffe1e1
style K fill:#ffcccc
```
#### 2.1.3 业务规则
**新会员激活期规则**
- 注册后7天内完成首次到店，否则进入沉默期干预
- ✅ 场景1：会员2026-03-01注册，2026-03-07首次到店，激活成功
- ✅ 场景2：会员2026-03-01注册，2026-03-08首次到店，激活成功
- ❌ 场景3：会员2026-03-01注册，2026-03-09首次到店，已进入沉默期干预
- ❌ 场景4：会员2026-03-01注册，2026-03-15首次到店，已进入流失预警
**活跃期定义规则**
- 30天内至少到店2次或消费1次
- ✅ 场景1：会员30天内到店2次，保持活跃状态
- ✅ 场景2：会员30天内到店1次但消费1次，保持活跃状态
- ✅ 场景3：会员30天内到店3次，保持活跃状态
- ❌ 场景4：会员30天内到店1次且未消费，进入沉默期
- ❌ 场景5：会员30天内未到店但消费1次，保持活跃状态
**沉默期触发规则**
- 7天未到店触发沉默期干预
- ✅ 场景1：会员最后到店2026-03-01，2026-03-08触发沉默期干预
- ✅ 场景2：会员最后到店2026-03-01，2026-03-09仍处于沉默期
- ✅ 场景3：会员沉默期干预成功，到店后重新计算活跃期
- ❌ 场景4：会员最后到店2026-03-01，2026-03-07未触发沉默期干预
**沉默期干预策略**
- 发送个性化关怀短信
- 提供专属优惠券
- 推荐适合的团课
- 教练主动联系
- ✅ 场景1：会员沉默7天，发送关怀短信"好久不见，期待您的到来"
- ✅ 场景2：会员沉默7天，提供专属优惠券"限时9折优惠"
- ✅ 场景3：会员沉默7天，推荐适合的团课"瑜伽课程适合您"
- ✅ 场景4：会员沉默7天，教练主动电话联系
- ❌ 场景5：会员沉默7天，未采取任何干预措施
**流失预警规则**
- 30天未到店触发流失预警
- ✅ 场景1：会员最后到店2026-02-01，2026-03-03触发流失预警
- ✅ 场景2：会员最后到店2026-02-01，2026-03-04启动挽回流程
- ✅ 场景3：会员挽回成功，到店后重新计算活跃期
- ❌ 场景4：会员最后到店2026-02-01，2026-03-02未触发流失预警
**流失定义规则**
- 90天未到店且未消费
- ✅ 场景1：会员最后到店2026-01-01，2026-04-01标记为流失状态
- ✅ 场景2：会员最后到店2026-01-01，2026-03-31仍处于流失预警期
- ✅ 场景3：会员90天内未到店但消费1次，不标记为流失
- ❌ 场景4：会员最后到店2026-01-01，2026-03-31标记为流失状态（错误）
**挽回策略规则**
- 根据会员等级和历史行为制定个性化挽回方案
- ✅ 场景1：VIP会员流失预警，提供专属私教课程优惠
- ✅ 场景2：普通会员流失预警，发送关怀短信和优惠券
- ✅ 场景3：高消费会员流失预警，客服主动电话联系
- ❌ 场景4：流失预警会员未制定挽回方案，系统自动发送通用短信
**流失归档规则**
- 流失会员归档保存，用于流失原因分析
- ✅ 场景1：会员标记为流失，归档保存所有历史数据
- ✅ 场景2：会员流失后重新激活，归档数据仍保留用于分析
- ✅ 场景3：定期分析流失会员数据，生成流失原因报告
- ❌ 场景4：会员标记为流失，删除历史数据（错误）
#### 2.1.4 异常处理
| 异常场景 | 处理方式 |
|---------|---------|
| 新会员激活失败 | 发送个性化邀请短信，提供首次到店优惠 |
| 沉默期干预无效 | 升级干预策略，提供专属优惠或服务 |
| 流失预警触发 | 启动挽回流程，由客服主动联系 |
| 会员数据异常 | 标记异常状态，暂停自动化运营，人工介入处理 |
---
### 2.2 支付与退款全流程
#### 2.2.1 业务场景
会员购买会员卡、私教课程等服务的支付流程，以及退款申请、审批、退款、财务对账的完整流程。
#### 2.2.2 业务流程
```mermaid
flowchart TB
subgraph 支付流程
A[会员发起支付] --> B[选择支付方式]
B --> C[创建支付订单]
C --> D[调用支付网关]
D --> E{支付结果}
E -->|成功| F[更新订单状态]
F --> G[发放会员卡权益]
G --> H[发送支付成功通知]
E -->|失败| I[记录支付失败]
I --> J[提示用户重新支付]
end
subgraph 退款流程
K[会员申请退款] --> L[填写退款原因]
L --> M[提交退款申请]
M --> N{退款类型}
N -->|自动退款| O[系统自动审核]
N -->|人工审核| P[店长审核]
P --> Q{审核结果}
Q -->|通过| R[财务专员复核]
Q -->|拒绝| S[通知会员拒绝原因]
O --> R
R --> T{复核结果}
T -->|通过| U[调用退款接口]
T -->|拒绝| S
U --> V[更新订单状态]
V --> W[收回会员卡权益]
W --> X[发送退款成功通知]
X --> Y[财务对账]
end
style E fill:#fff4e1
style Q fill:#fff4e1
style T fill:#fff4e1
style K fill:#e1f5ff
```
#### 2.2.3 业务规则
**支付方式规则**
- 支持微信支付、支付宝、银行卡支付
- ✅ 场景1：会员选择微信支付，调用微信支付接口
- ✅ 场景2：会员选择支付宝，调用支付宝接口
- ✅ 场景3：会员选择银行卡，调用银行卡支付接口
- ❌ 场景4：会员选择不支持的支付方式，提示"暂不支持该支付方式"
**支付超时规则**
- 订单创建后30分钟内未支付自动取消
- ✅ 场景1：订单18:00创建，18:30未支付，订单自动取消
- ✅ 场景2：订单18:00创建，18:29支付，支付成功
- ❌ 场景3：订单18:00创建，18:31支付，支付失败提示"订单已取消"
- ❌ 场景4：订单18:00创建，18:00支付，支付成功
**自动退款条件规则**
- 7天内购买且未使用的会员卡、私教课程
- ✅ 场景1：会员购买会员卡后第1天申请退款，未使用，自动退款
- ✅ 场景2：会员购买会员卡后第7天申请退款，未使用，自动退款
- ❌ 场景3：会员购买会员卡后第8天申请退款，未使用，需人工审核
- ❌ 场景4：会员购买会员卡后第1天申请退款，已使用，需人工审核
**人工审核条件规则**
- 超过7天、已使用部分权益、金额超过1000元
- ✅ 场景1：会员购买会员卡后第8天申请退款，需人工审核
- ✅ 场景2：会员购买会员卡后第1天申请退款，已使用，需人工审核
- ✅ 场景3：会员购买1500元会员卡后第1天申请退款，需人工审核
- ❌ 场景4：会员购买会员卡后第7天申请退款，未使用，金额500元，自动退款
**退款时效规则**
- 审核通过后1-3个工作日到账
- ✅ 场景1：退款审核通过，第1个工作日到账
- ✅ 场景2：退款审核通过，第3个工作日到账
- ❌ 场景3：退款审核通过，第4个工作日到账（超时）
**财务对账规则**
- 每日自动对账，异常订单人工处理
- ✅ 场景1：系统每日凌晨自动对账，生成对账报告
- ✅ 场景2：对账发现异常订单，标记异常，财务专员人工核查
- ❌ 场景3：对账发现异常订单，未标记异常（错误）
**退款手续费规则**
- 7天内无手续费，7-30天收取5%手续费，30天以上收取10%手续费
- ✅ 场景1：会员购买会员卡后第1天申请退款，无手续费
- ✅ 场景2：会员购买会员卡后第15天申请退款，收取5%手续费
- ✅ 场景3：会员购买会员卡后第45天申请退款，收取10%手续费
- ❌ 场景4：会员购买会员卡后第1天申请退款，收取5%手续费（错误）
#### 2.2.4 异常处理
| 异常场景 | 处理方式 |
|---------|---------|
| 支付超时 | 订单自动取消，释放库存和权益 |
| 支付重复 | 检测重复支付，自动退款重复金额 |
| 退款失败 | 重试3次，失败后人工介入处理 |
| 财务对账异常 | 标记异常订单，财务专员人工核查 |
| 退款申请超时 | 退款申请提交后48小时内未处理自动升级 |
---
### 2.3 投诉与反馈处理流程
#### 2.3.1 业务场景
会员提交投诉或反馈，系统自动分类、分配、处理、反馈，并进行满意度调查和归档分析。
#### 2.3.2 业务流程
```mermaid
flowchart LR
A[会员提交投诉/反馈] --> B[填写投诉详情]
B --> C[选择投诉类型]
C --> D[上传相关凭证]
D --> E[提交投诉]
E --> F[系统自动分类]
F --> G{投诉类型}
G -->|服务投诉| H[分配给店长]
G -->|设施投诉| I[分配给运营管理员]
G -->|财务投诉| J[分配给财务专员]
G -->|技术投诉| K[分配给技术支持]
H --> L[处理人接收]
I --> L
J --> L
K --> L
L --> M[调查处理]
M --> N{处理结果}
N -->|解决| O[反馈处理结果]
N -->|无法解决| P[升级处理]
P --> Q[上级介入处理]
Q --> O
O --> R[会员确认]
R --> S{满意度调查}
S -->|满意| T[归档分析]
S -->|不满意| U[重新处理]
U --> M
style A fill:#e1f5ff
style F fill:#fff4e1
style N fill:#fff4e1
style S fill:#ffe1e1
```
#### 2.3.3 业务规则
**投诉分类规则**
- 服务投诉、设施投诉、财务投诉、技术投诉、其他
- ✅ 场景1：会员投诉教练服务态度，分类为服务投诉
- ✅ 场景2：会员投诉器械损坏，分类为设施投诉
- ✅ 场景3：会员投诉退款问题，分类为财务投诉
- ✅ 场景4：会员投诉系统故障，分类为技术投诉
- ✅ 场景5：会员投诉其他问题，分类为其他
**响应时效规则**
- 投诉提交后2小时内响应
- ✅ 场景1：投诉14:00提交，16:00前响应
- ✅ 场景2：投诉14:00提交，15:59响应
- ❌ 场景3：投诉14:00提交，16:01响应（超时）
**处理时效规则**
- 一般投诉24小时内处理完毕，复杂投诉48小时内处理完毕
- ✅ 场景1：一般投诉14:00提交，次日14:00前处理完毕
- ✅ 场景2：复杂投诉14:00提交，后日14:00前处理完毕
- ❌ 场景3：一般投诉14:00提交，次日14:01处理完毕（超时）
**升级机制规则**
- 处理人无法解决时自动升级给上级
- ✅ 场景1：店长无法解决服务投诉，自动升级给运营管理员
- ✅ 场景2：运营管理员无法解决设施投诉，自动升级给超级管理员
- ❌ 场景3：处理人无法解决投诉，未升级（错误）
**满意度调查规则**
- 投诉处理完成后自动发送满意度调查
- ✅ 场景1：投诉处理完成，系统自动发送满意度调查问卷
- ✅ 场景2：会员完成满意度调查，系统记录满意度评分
- ❌ 场景3：投诉处理完成，未发送满意度调查（错误）
**归档分析规则**
- 投诉归档后进行分类统计和原因分析
- ✅ 场景1：投诉归档，系统自动分类统计
- ✅ 场景2：定期分析投诉数据，生成投诉原因报告
- ❌ 场景3：投诉归档，未进行分类统计（错误）
**投诉闭环规则**
- 所有投诉必须闭环处理，不得遗漏
- ✅ 场景1：投诉处理完成，会员确认，归档
- ✅ 场景2：投诉处理完成，会员不满意，重新处理，会员确认，归档
- ❌ 场景3：投诉处理完成，未会员确认，归档（错误）
#### 2.3.4 异常处理
| 异常场景 | 处理方式 |
|---------|---------|
| 投诉信息不完整 | 提示会员补充必要信息 |
| 处理人未响应 | 2小时未响应自动升级给上级 |
| 处理超时 | 24小时未处理自动升级给店长 |
| 会员不满意 | 重新处理，升级处理级别 |
| 投诉重复提交 | 合并重复投诉，关联处理 |
---
## 三、业务数据流转
### 3.1 会员数据流转
```mermaid
flowchart LR
A[会员注册] --> B[创建会员档案]
B --> C[购买会员卡]
C --> D[获得权益]
D --> E[预约团课]
E --> F[扣减权益]
F --> G[签到]
G --> H[记录到店]
H --> I[消费记录]
I --> J[数据统计]
```
### 3.2 权益数据流转
```mermaid
flowchart LR
A[购买会员卡] --> B[发放权益]
B --> C[预约扣减]
C --> D[签到扣减]
D --> E[权益使用记录]
E --> F[权益查询]
F --> G[权益续费]
G --> B
```
---
## 四、业务规则汇总
### 4.1 时间相关规则
| 规则类型 | 时间要求 | 说明 |
| -------------- | ------------------ | ------------------------ |
| 预约时间 | 课程开始前30分钟 | 会员预约团课的最短时间 |
| 取消预约 | 课程开始前2小时 | 会员取消预约的最短时间 |
| 团课取消 | 提前24小时 | 教练取消团课的最短时间 |
| 支付超时 | 30分钟 | 订单未支付自动取消时间 |
| 新会员激活期 | 7天 | 新会员首次到店时间要求 |
| 沉默期触发 | 7天未到店 | 触发沉默期干预的时间 |
| 流失预警 | 30天未到店 | 触发流失预警的时间 |
| 流失定义 | 90天未到店 | 会员流失的时间定义 |
| 投诉响应 | 2小时 | 投诉响应时间要求 |
| 投诉处理 | 24-48小时 | 投诉处理完成时间 |
| 退款时效 | 1-3个工作日 | 退款到账时间 |
### 4.2 数量相关规则
| 规则类型 | 数量限制 | 说明 |
| ------------ | -------- | -------------- |
| 团课容量 | 20人 | 每节课最大人数 |
| 自动退款 | 7天内 | 自动退款条件 |
| 手续费7-30天 | 5% | 退款手续费 |
| 手续费30天以上 | 10% | 退款手续费 |
### 4.3 状态相关规则
| 规则类型 | 状态定义 | 说明 |
| ------------ | -------- | -------------- |
| 活跃期 | 30天内到店2次或消费1次 | 会员活跃状态 |
| 沉默期 | 7天未到店 | 会员沉默状态 |
| 流失预警 | 30天未到店 | 流失预警状态 |
| 流失 | 90天未到店且未消费 | 会员流失状态 |
---
## 五、业务异常处理
### 5.1 会员相关异常
| 异常类型 | 处理方式 |
| ------------ | ---------------------------- |
| 手机号已存在 | 提示用户直接登录 |
| 验证码错误 | 提示用户重新输入 |
| 验证码过期 | 提示用户重新获取 |
| 会员卡无效 | 提示用户购买会员卡 |
| 会员卡过期 | 提示用户续费 |
| 会员卡权益不足 | 提示用户购买会员卡或续费 |
### 5.2 预约相关异常
| 异常类型 | 处理方式 |
| ------------ | ---------------------------- |
| 课程已满 | 提示用户选择其他课程 |
| 会员卡权益不足 | 提示用户购买会员卡 |
| 预约时间过短 | 提示用户提前预约 |
| 团课取消过晚 | 系统提示"取消时间过晚" |
### 5.3 支付相关异常
| 异常类型 | 处理方式 |
| ------------ | ---------------------------- |
| 支付失败 | 提示用户重新支付 |
| 支付超时 | 订单自动取消，释放库存和权益 |
| 支付重复 | 检测重复支付，自动退款重复金额 |
| 退款失败 | 重试3次，失败后人工介入处理 |
| 财务对账异常 | 标记异常订单，财务专员人工核查 |
### 5.4 投诉相关异常
| 异常类型 | 处理方式 |
| -------------- | ---------------------------- |
| 投诉信息不完整 | 提示会员补充必要信息 |
| 处理人未响应 | 2小时未响应自动升级给上级 |
| 处理超时 | 24小时未处理自动升级给店长 |
| 会员不满意 | 重新处理，升级处理级别 |
| 投诉重复提交 | 合并重复投诉，关联处理 |
---
## 六、业务指标
### 6.1 核心业务指标
| 指标名称 | 目标值 | 计算方式 |
| ------------------ | ------------ | ---------------------------- |
| 预约成功率 | ≥ 95% | 成功预约次数 / 总预约次数 |
| 签到耗时 | ≤ 3秒 | 签到请求到签到完成的时间 |
| 人工处理时间减少 | 50% | (优化前时间 - 优化后时间) / 优化前时间 |
| 数据报表使用率 | ≥ 80% | 使用报表的用户数 / 总用户数 |
| 新会员激活率 | ≥ 70% | 7天内首次到店的新会员数 / 新会员总数 |
| 会员流失率 | ≤ 10% | 流失会员数 / 总会员数 |
| 投诉处理满意度 | ≥ 90% | 满意投诉数 / 总投诉数 |
### 6.2 运营指标
| 指标名称 | 目标值 | 计算方式 |
| ------------------ | ------------ | ---------------------------- |
| 团课满课率 | ≥ 80% | 满员课程数 / 总课程数 |
| 会员活跃度 | ≥ 60% | 活跃会员数 / 总会员数 |
| 会员续费率 | ≥ 70% | 续费会员数 / 到期会员数 |
| 会员卡使用率 | ≥ 85% | 使用会员卡的会员数 / 持卡会员数 |
---
## 七、附录
### 7.1 业务术语表
| 术语 | 定义 |
| ----------------------------- | ------------------------------------------------ |
| 租户(Tenant) | 系统的多租户架构中的独立业务实体，如一个连锁品牌 |
| 门店(Store) | 租户下的具体经营场所 |
| 会员(Member) | 在门店注册的用户 |
| 权益(Benefit) | 会员卡包含的时长、次数、储值、等级等权益 |
| 可预约资源(Bookable Resource) | 团课等可被预约的对象 |
| 时段(Slot) | 资源的可预约时间窗口 |
### 7.2 参考文档
- 《健身房管理系统基础版产品设计文档》 GYM-PRD-BASIC-001
- 《健身房管理系统基础版业务概要设计文档》 GYM-B-HLD-BASIC-001
- 《健身房管理系统基础版技术实现详细设计文档》 GYM-T-ILD-BASIC-001
### 7.3 业务流程图索引
| 流程名称 | 图表位置 |
| ---------------- | ------------ |
| 会员全生命周期流程 | 2.1.2 |
| 支付与退款全流程 | 2.2.2 |
| 投诉与反馈处理流程 | 2.3.2 |
| 会员数据流转 | 3.1 |
| 权益数据流转 | 3.2 |
### 7.4 业务规则索引
| 规则分类 | 规则名称 | 图表位置 |
| ---------------- | ---------------- | ------------ |
| 时间相关规则 | 预约时间 | 4.1 |
| 时间相关规则 | 取消预约 | 4.1 |
| 时间相关规则 | 团课取消 | 4.1 |
| 时间相关规则 | 支付超时 | 4.1 |
| 时间相关规则 | 新会员激活期 | 4.1 |
| 时间相关规则 | 沉默期触发 | 4.1 |
| 时间相关规则 | 流失预警 | 4.1 |
| 时间相关规则 | 流失定义 | 4.1 |
| 时间相关规则 | 投诉响应 | 4.1 |
| 时间相关规则 | 投诉处理 | 4.1 |
| 时间相关规则 | 退款时效 | 4.1 |
| 数量相关规则 | 团课容量 | 4.2 |
| 数量相关规则 | 自动退款 | 4.2 |
| 数量相关规则 | 手续费7-30天 | 4.2 |
| 数量相关规则 | 手续费30天以上 | 4.2 |
| 状态相关规则 | 活跃期 | 4.3 |
| 状态相关规则 | 沉默期 | 4.3 |
| 状态相关规则 | 流失预警 | 4.3 |
| 状态相关规则 | 流失 | 4.3 |
---
**文档结束**
---
## 二、详细业务流程（续）
### 2.4 UI 模版定制模块
#### 2.4.1 业务场景
健身房管理者可以根据品牌特色自定义系统界面，包括品牌 Logo、主题色、布局风格等，提升品牌形象和用户体验。
#### 2.4.2 业务数据流转
```mermaid
flowchart TB
subgraph UI 模版定制流程
A[管理员进入 UI 设置] --> B[选择定制类型]
B --> C{定制类型}
C -->|品牌定制 | D[上传品牌 Logo]
C -->|主题色定制 | E[选择主题色]
C -->|布局定制 | F[选择布局模板]
D --> G[预览效果]
E --> G
F --> G
G --> H{确认发布}
H -->|是 | I[保存到数据库]
H -->|否 | B
I --> J[通知所有用户]
J --> K[更新缓存]
K --> L[完成定制]
end
style A fill:#e1f5ff
style G fill:#fff4e1
style I fill:#e8f5e9
style L fill:#e8f5e9
```
#### 2.4.3 业务规则
**品牌定制规则**
- 支持上传 PNG、JPG 格式的 Logo 文件，最大 5MB
- ✅ 场景 1：管理员上传 PNG 格式 Logo（2MB），上传成功
- ✅ 场景 2：管理员上传 JPG 格式 Logo（3MB），上传成功
- ❌ 场景 3：管理员上传 GIF 格式 Logo（1MB），格式不支持
- ❌ 场景 4：管理员上传 PNG 格式 Logo（6MB），文件大小超限
**主题色定制规则**
- 提供预设色板，支持自定义色值输入
- ✅ 场景 1：管理员从预设色板选择蓝色主题，应用成功
- ✅ 场景 2：管理员输入自定义色值#1890FF，应用成功
- ❌ 场景 3：管理员输入无效色值#GGGGGG，提示格式错误
- ❌ 场景 4：管理员选择与 Logo 颜色冲突的主题色，系统提示建议
**布局定制规则**
- 提供 3 种预设布局模板（经典、现代、简约）
- ✅ 场景 1：管理员选择经典布局，应用成功
- ✅ 场景 2：管理员选择现代布局，应用成功
- ✅ 场景 3：管理员选择简约布局，应用成功
- ❌ 场景 4：管理员自定义布局超出预设范围，提示不支持
**预览规则**
- 支持实时预览，预览效果与实际效果一致
- ✅ 场景 1：管理员修改主题色，实时预览更新
- ✅ 场景 2：管理员切换布局模板，实时预览更新
- ✅ 场景 3：管理员上传 Logo，实时预览更新
- ❌ 场景 4：管理员修改后未预览直接发布，系统强制要求预览
**发布规则**
- 发布后即时生效，所有用户端同步更新
- ✅ 场景 1：管理员发布新主题，会员小程序即时更新
- ✅ 场景 2：管理员发布新主题，教练端 App 即时更新
- ✅ 场景 3：管理员发布新主题，管理后台 PC 即时更新
- ❌ 场景 4：管理员发布后部分用户未更新，系统自动清理缓存
#### 2.4.4 异常处理
| 异常场景 | 处理方式 |
|---------|---------|
| Logo 上传失败 | 提示文件大小或格式错误，建议重新上传 |
| 主题色不兼容 | 提示颜色冲突，推荐兼容色板 |
| 预览加载失败 | 重新加载预览，失败则提示网络问题 |
| 发布失败 | 回滚到上一个版本，提示发布失败原因 |
| 缓存更新失败 | 强制清理缓存，通知运维介入 |
#### 2.4.5 业务指标
| 指标名称 | 目标值 | 计算方式 |
|---------|--------|---------|
| UI 定制使用率 | ≥ 60% | 使用定制的门店数 / 总门店数 |
| 定制满意度 | ≥ 85% | 满意评价数 / 总评价数 |
| 预览加载时间 | ≤ 2 秒 | 预览请求到渲染完成的时间 |
| 发布成功率 | ≥ 99% | 成功发布次数 / 总发布次数 |