Files
gym-manage/基础版功能清单.md
T

1100 lines
43 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 健身房管理系统基础版功能清单
> **文档编号**: GYM-FEATURE-LIST-BASIC-001
> **版本**: v1.1
> **日期**: 2026-04-07
> **作者**: 张翔
> **状态**: 正式发布
> **用途**: 多人协作开发任务分配与进度跟踪
> **更新说明**: 采用微信快捷登录+服务号消息推送方案
---
## 📋 文档说明
### 目标
本文档用于梳理基础版所有功能点,明确优先级、开发阶段、验收标准和依赖关系,便于团队成员认领任务和协作开发。
### ⚠️ 重要说明
**基础版开发范围**
-**P0MVP阶段)**:核心业务闭环,必须实现
-**P1(基础版完善)**:重要功能,显著提升用户体验
- 📋 **P2(付费订阅版)**:增值功能,仅作为未来规划参考,不在基础版开发范围内
- 📋 **P3(暂不实现)**:未来可能实现,仅作为长期规划参考
**开发顺序**
1. 第一阶段(MVP):仅开发P0功能,约3.5个月
2. 第二阶段(基础版完善):开发P1功能,约2个月
3. 第三阶段(付费订阅版):P2功能不在基础版范围内,后续单独规划
### 优先级说明
| 优先级 | 英文全称 | 中文含义 | 定义 | 开发顺序 |
|--------|---------|---------|------|---------|
| **P0** | Must Have | 必须有 | 核心业务闭环,缺少则产品无法使用 | 第一阶段(MVP) |
| **P1** | Should Have | 应该有 | 重要功能,显著提升用户体验 | 第二阶段(基础版完善) |
| **P2** | Could Have | 可以有 | 增值功能,提升产品竞争力 | 第三阶段(付费订阅版) |
| **P3** | Won't Have | 暂不实现 | 未来可能实现,当前版本不做 | 后续版本规划 |
### 开发阶段说明
- **MVP阶段(迭代0-7)**:约3.5个月,交付核心业务闭环(仅P0功能)
- **基础版完善(迭代8-11)**:约2个月,完善基础版功能(仅P1功能)
- **付费订阅版(迭代12-22)**:约4个月,开发高价值订阅模块(P2功能,不在基础版范围内)
---
## 🎯 功能模块总览
```mermaid
mindmap
root((基础版功能))
微信配置管理
小程序配置
服务号配置
开放平台配置
模板消息配置
会员管理
会员注册
会员信息管理
会员卡管理
预约管理
团课预约
团课管理
签到管理
扫码签到
签到记录管理
数据统计
基础数据统计
数据可视化看板
会员分析报表
营收分析报表
课程运营分析
营销工具
优惠券管理
拼团活动
秒杀活动
会员卡促销
积分商城
支付集成
微信支付
支付宝支付
组合支付
支付对账
系统管理
用户管理
角色权限管理
UI模版定制
品牌定制
布局调整
预设模板
配置历史
```
---
## 📊 详细功能清单
> **💡 提示**:以下功能清单包含所有规划功能(P0/P1/P2/P3)。基础版实际开发范围仅为P0和P1功能,P2和P3功能仅作为未来规划参考。
### 模块0: 微信配置管理模块
#### 0.1 小程序配置
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 小程序AppID配置 | P0 | MVP | 0.5天 | 配置验证通过率100% | 无 | - | 待开发 |
| 小程序AppSecret配置 | P0 | MVP | 0.5天 | 配置验证通过率100% | 小程序AppID配置 | - | 待开发 |
| 小程序配置验证 | P0 | MVP | 1天 | 验证准确率100% | 小程序AppSecret配置 | - | 待开发 |
| 小程序名称配置 | P1 | 基础版完善 | 0.5天 | 配置显示正确 | 小程序AppID配置 | - | 待开发 |
**业务规则**:
- 每个租户独立配置自己的小程序
- AppSecret需加密存储
- 配置后需验证有效性
- 配置错误需明确提示原因
**技术要点**:
- 使用AES加密存储AppSecret
- 调用微信接口验证配置有效性
- 使用Redis缓存AccessToken
- 配置变更需记录操作日志
---
#### 0.2 服务号配置
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 服务号AppID配置 | P0 | MVP | 0.5天 | 配置验证通过率100% | 无 | - | 待开发 |
| 服务号AppSecret配置 | P0 | MVP | 0.5天 | 配置验证通过率100% | 服务号AppID配置 | - | 待开发 |
| 服务号Token配置 | P0 | MVP | 0.5天 | 配置验证通过率100% | 服务号AppID配置 | - | 待开发 |
| 服务号AES Key配置 | P0 | MVP | 0.5天 | 配置验证通过率100% | 服务号Token配置 | - | 待开发 |
| 服务号配置验证 | P0 | MVP | 1天 | 验证准确率100% | 服务号AES Key配置 | - | 待开发 |
| 服务号名称配置 | P1 | 基础版完善 | 0.5天 | 配置显示正确 | 服务号AppID配置 | - | 待开发 |
**业务规则**:
- 每个租户独立配置自己的服务号
- 服务号需完成认证(300元/年)
- AppSecret、Token、AES Key需加密存储
- 配置后需验证有效性
- 配置错误需明确提示原因
**技术要点**:
- 使用AES加密存储敏感信息
- 调用微信接口验证配置有效性
- 使用Redis缓存AccessToken
- 配置服务器URL和Token用于接收事件推送
- 配置变更需记录操作日志
---
#### 0.3 开放平台配置
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 开放平台AppID配置 | P1 | 基础版完善 | 0.5天 | 配置验证通过率100% | 无 | - | 待开发 |
| 开放平台AppSecret配置 | P1 | 基础版完善 | 0.5天 | 配置验证通过率100% | 开放平台AppID配置 | - | 待开发 |
| 开放平台配置验证 | P1 | 基础版完善 | 1天 | 验证准确率100% | 开放平台AppSecret配置 | - | 待开发 |
**业务规则**:
- 开放平台用于统一用户身份(UnionID)
- 需要在开放平台绑定小程序和服务号
- AppSecret需加密存储
- 配置后需验证有效性
**技术要点**:
- 使用AES加密存储AppSecret
- 调用微信接口验证配置有效性
- 使用Redis缓存AccessToken
- 配置变更需记录操作日志
---
#### 0.4 模板消息配置
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 模板消息ID配置 | P0 | MVP | 1天 | 配置验证通过率100% | 服务号配置 | - | 待开发 |
| 模板消息字段配置 | P0 | MVP | 1天 | 字段映射准确率100% | 模板消息ID配置 | - | 待开发 |
| 模板消息测试 | P0 | MVP | 1天 | 测试发送成功率≥95% | 模板消息字段配置 | - | 待开发 |
| 模板消息管理 | P1 | 基础版完善 | 1天 | 管理操作成功率≥98% | 模板消息ID配置 | - | 待开发 |
**业务规则**:
- 需要在服务号后台申请模板消息
- 每个模板消息有唯一的模板ID
- 模板消息字段需与业务字段映射
- 模板消息每月有限额(4条/用户/月)
- 需合理规划消息类型和发送频率
**技术要点**:
- 使用JSON存储模板消息配置
- 使用Redis缓存模板消息配置
- 调用微信接口发送模板消息
- 记录消息发送日志
- 监控消息发送成功率
**常用模板消息类型**:
| 模板名称 | 适用场景 | 优先级 |
|----------|----------|--------|
| 预约成功通知 | 用户预约团课成功 | P0 |
| 预约取消通知 | 用户取消预约 | P0 |
| 签到成功通知 | 用户签到成功 | P0 |
| 课程开始提醒 | 课程开始前30分钟 | P0 |
| 会员卡到期提醒 | 到期前7天 | P0 |
| 验证码通知 | 身份验证 | P1 |
| 优惠券到账通知 | 优惠券发放 | P1 |
| 退款到账通知 | 退款成功 | P1 |
---
### 模块1: 会员管理模块
#### 1.1 会员注册
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 微信快捷登录 | P0 | MVP | 2天 | 登录成功率≥95%,流程≤2步 | 微信配置管理 | - | 待开发 |
| 服务号关注关联 | P0 | MVP | 1天 | 关联成功率≥95% | 微信快捷登录 | - | 待开发 |
| 手机号补全 | P1 | 基础版完善 | 1天 | 补全成功率≥90% | 微信快捷登录 | - | 待开发 |
| 基本信息填写 | P0 | MVP | 1天 | 信息更新实时生效 | 微信快捷登录 | - | 待开发 |
**业务规则**:
- 用户通过微信小程序授权登录,无需手机号即可完成注册
- 注册成功后自动创建会员档案
- 用户可通过小程序主动绑定手机号(通过微信手机号快捷获取)
- 健身房前台可在管理端录入会员手机号
- 用户需关注服务号才能接收业务通知
- 通过UnionID关联小程序和服务号身份
**技术要点**:
- 使用微信开放平台UnionID机制统一用户身份
- 使用Spring WebFlux实现异步登录流程
- UnionID和OpenID使用数据库存储
- 手机号使用AES加密存储(可选)
- 使用R2DBC实现响应式数据库操作
- 服务号事件监听实现关注关联
---
#### 1.2 会员信息管理
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 会员查看个人信息 | P0 | MVP | 0.5天 | 查看响应时间≤500ms | 会员注册 | - | 待开发 |
| 会员编辑个人信息 | P0 | MVP | 1天 | 信息更新实时生效 | 会员注册 | - | 待开发 |
| 前台查看会员信息 | P1 | 基础版完善 | 0.5天 | 查看响应时间≤500ms | 会员注册 | - | 待开发 |
| 前台编辑会员信息 | P1 | 基础版完善 | 1天 | 信息更新实时生效 | 会员注册 | - | 待开发 |
| 会员列表查看 | P1 | 基础版完善 | 1天 | 列表加载时间≤1秒 | 会员注册 | - | 待开发 |
| 会员搜索 | P1 | 基础版完善 | 1天 | 搜索响应时间≤1秒 | 会员列表查看 | - | 待开发 |
**业务规则**:
- 会员只能编辑自己的基本信息
- 前台可以编辑会员的所有信息
- 店长拥有最高权限
- 关键信息修改需记录操作日志
**技术要点**:
- 使用Redis缓存会员信息,提高查询性能
- 使用Elasticsearch实现会员搜索功能
- 操作日志使用AOP记录,存储到数据库
---
#### 1.3 会员卡管理
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 会员卡购买 | P0 | MVP | 2天 | 购买成功率≥98% | 会员注册 | - | 待开发 |
| 会员卡查看 | P0 | MVP | 1天 | 查看响应时间≤500ms | 会员卡购买 | - | 待开发 |
| 会员卡使用记录 | P0 | MVP | 1天 | 记录永久保存 | 会员卡购买 | - | 待开发 |
| 会员卡到期提醒 | P1 | 基础版完善 | 1天 | 提醒发送成功率≥95%(服务号模板消息) | 会员卡购买 | - | 待开发 |
| 会员卡续费 | P1 | 基础版完善 | 1天 | 续费成功率≥98% | 会员卡购买 | - | 待开发 |
| 会员卡退款 | P1 | 基础版完善 | 2天 | 退款成功率≥98% | 会员卡购买 | - | 待开发 |
**业务规则**:
- 支持时长卡、次卡、储值卡
- 会员卡到期前7天提醒
- 会员卡续费后权益立即生效
- 会员卡使用记录永久保存
**技术要点**:
- 使用状态机模式管理会员卡状态
- 使用分布式锁防止并发购买
- 使用消息队列实现到期提醒
- 使用Saga模式实现退款流程
---
### 模块2: 预约管理模块
#### 2.1 团课预约
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 团课列表展示 | P0 | MVP | 1天 | 列表加载时间≤1秒 | 无 | - | 待开发 |
| 团课详情查看 | P0 | MVP | 0.5天 | 查看响应时间≤500ms | 团课列表展示 | - | 待开发 |
| 团课预约 | P0 | MVP | 2天 | 预约成功率≥95% | 会员卡购买 | - | 待开发 |
| 团课取消预约 | P0 | MVP | 1天 | 取消成功率≥95% | 团课预约 | - | 待开发 |
| 预约记录查看 | P1 | 基础版完善 | 0.5天 | 查看响应时间≤500ms | 团课预约 | - | 待开发 |
| 预约提醒 | P1 | 基础版完善 | 1天 | 提醒发送成功率≥95%(服务号模板消息) | 团课预约 | - | 待开发 |
**业务规则**:
- 预约需在课程开始前至少30分钟
- 取消预约需在课程开始前至少2小时
- 每节课最多20人
- 预约成功后发送提醒
- 预约成功后扣减权益
**技术要点**:
- 使用Redis缓存团课信息
- 使用分布式锁防止预约冲突
- 使用消息队列实现预约提醒
- 使用响应式编程实现高并发预约
---
#### 2.2 团课管理
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 团课创建 | P1 | 基础版完善 | 2天 | 创建成功率≥98% | 无 | - | 待开发 |
| 团课编辑 | P1 | 基础版完善 | 1天 | 编辑成功率≥98% | 团课创建 | - | 待开发 |
| 团课取消 | P1 | 基础版完善 | 1天 | 取消通知发送成功率≥95% | 团课创建 | - | 待开发 |
| 团课列表查看 | P1 | 基础版完善 | 0.5天 | 列表加载时间≤1秒 | 团课创建 | - | 待开发 |
| 团课详情查看 | P1 | 基础版完善 | 0.5天 | 查看响应时间≤500ms | 团课创建 | - | 待开发 |
| 团课签到管理 | P1 | 基础版完善 | 1天 | 签到记录准确率100% | 团课创建 | - | 待开发 |
**业务规则**:
- 团课需指定教练、时间、地点
- 团课取消需提前24小时通知
- 团课取消后自动退款
- 团课签到后记录考勤
**技术要点**:
- 使用状态机模式管理团课状态
- 使用消息队列实现取消通知
- 使用分布式事务保证数据一致性
---
### 模块3: 签到管理模块
#### 3.1 扫码签到
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 会员扫码签到 | P0 | MVP | 2天 | 签到成功率≥98%,耗时≤3秒 | 会员卡购买 | - | 待开发 |
| 签到成功提示 | P0 | MVP | 0.5天 | 提示响应时间≤100ms | 会员扫码签到 | - | 待开发 |
| 签到记录查看 | P1 | 基础版完善 | 0.5天 | 查看响应时间≤1秒 | 会员扫码签到 | - | 待开发 |
| 签到失败处理 | P0 | MVP | 1天 | 失败原因提示清晰 | 会员扫码签到 | - | 待开发 |
**业务规则**:
- 签到需验证会员卡有效性
- 签到需验证预约信息(如有)
- 签到成功后记录到店时间
- 签到失败后提示原因
**技术要点**:
- 使用二维码生成签到码
- 使用Redis缓存签到码,提高验证速度
- 使用响应式编程实现高并发签到
- 使用WebSocket实现实时签到反馈
---
#### 3.2 签到记录管理
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 签到记录查看 | P1 | 基础版完善 | 0.5天 | 查看响应时间≤1秒 | 扫码签到 | - | 待开发 |
| 签到记录导出 | P1 | 基础版完善 | 1天 | 导出成功率≥98% | 签到记录查看 | - | 待开发 |
| 签到统计 | P1 | 基础版完善 | 1天 | 统计准确率≥99% | 签到记录查看 | - | 待开发 |
**业务规则**:
- 签到记录永久保存
- 支持按时间范围查询
- 支持按会员查询
**技术要点**:
- 使用Elasticsearch实现签到记录搜索
- 使用异步任务实现数据导出
- 使用Redis缓存统计数据
---
### 模块4: 数据统计模块
#### 4.1 基础数据统计
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 会员数据统计 | P1 | 基础版完善 | 1天 | 统计准确率≥99% | 会员注册 | - | 待开发 |
| 预约数据统计 | P1 | 基础版完善 | 1天 | 统计准确率≥99% | 团课预约 | - | 待开发 |
| 签到数据统计 | P1 | 基础版完善 | 1天 | 统计准确率≥99% | 扫码签到 | - | 待开发 |
| 数据导出 | P1 | 基础版完善 | 1天 | 导出成功率≥98% | 数据统计 | - | 待开发 |
**业务规则**:
- 统计数据保留30天(用于趋势分析)
- 业务记录永久保存
- 支持按日、周、月统计
- 支持数据导出
**技术要点**:
- 使用定时任务每日凌晨统计数据
- 使用Redis缓存统计结果
- 使用异步任务实现数据导出
- 使用Elasticsearch实现复杂查询
---
#### 4.2 数据可视化看板
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 核心指标卡片 | P2 | 付费订阅版 | 2天 | 看板加载时间≤2秒 | 基础数据统计 | - | 待开发 |
| 趋势图表 | P2 | 付费订阅版 | 3天 | 图表渲染流畅度≥90% | 基础数据统计 | - | 待开发 |
| 排行榜 | P2 | 付费订阅版 | 2天 | 数据更新延迟≤1分钟 | 基础数据统计 | - | 待开发 |
| 数据对比 | P2 | 付费订阅版 | 2天 | 对比准确率100% | 基础数据统计 | - | 待开发 |
**业务规则**:
- 核心指标数据实时更新
- 趋势图表数据每10分钟刷新一次
- 支持图表导出为PNG/PDF格式
- 支持自定义看板布局
**技术要点**:
- 使用WebSocket实现实时数据推送
- 使用ECharts实现数据可视化
- 使用Redis缓存图表数据
- 使用定时任务更新排行榜
---
#### 4.3 会员分析报表
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 会员画像分析 | P2 | 付费订阅版 | 3天 | 画像准确率≥95% | 会员注册 | - | 待开发 |
| 会员行为分析 | P2 | 付费订阅版 | 3天 | 分析准确率≥90% | 签到记录 | - | 待开发 |
| 会员生命周期分析 | P2 | 付费订阅版 | 3天 | 流失预警准确率≥85% | 会员注册 | - | 待开发 |
| 会员分组统计 | P2 | 付费订阅版 | 2天 | 分组准确率100% | 会员注册 | - | 待开发 |
**业务规则**:
- 流失会员预警阈值可配置(默认30天)
- 会员画像数据每日凌晨更新
- 支持导出会员分析报表
- 支持按条件筛选会员群体
**技术要点**:
- 使用机器学习算法实现会员画像
- 使用定时任务每日更新画像数据
- 使用Elasticsearch实现复杂查询
- 使用异步任务生成报表
---
#### 4.4 营收分析报表
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 收入概览 | P2 | 付费订阅版 | 2天 | 营收数据准确率100% | 支付集成 | - | 待开发 |
| 收入明细 | P2 | 付费订阅版 | 2天 | 明细查询响应时间≤2秒 | 支付集成 | - | 待开发 |
| 收入预测 | P2 | 付费订阅版 | 3天 | 预测准确率≥80% | 收入概览 | - | 待开发 |
| 成本分析 | P2 | 付费订阅版 | 2天 | 成本统计准确率100% | 收入概览 | - | 待开发 |
**业务规则**:
- 收入数据实时统计
- 收入预测基于近3个月数据
- 支持自定义统计周期
- 支持导出营收报表
**技术要点**:
- 使用机器学习算法实现收入预测
- 使用定时任务每日更新统计数据
- 使用Redis缓存营收数据
- 使用异步任务生成报表
---
#### 4.5 课程运营分析
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 课程概览 | P2 | 付费订阅版 | 2天 | 课程统计数据准确率≥99% | 团课管理 | - | 待开发 |
| 课程分析 | P2 | 付费订阅版 | 2天 | 分析准确率≥90% | 团课管理 | - | 待开发 |
| 时段分析 | P2 | 付费订阅版 | 2天 | 分析准确率≥90% | 团课管理 | - | 待开发 |
| 教练分析 | P2 | 付费订阅版 | 2天 | 分析准确率≥90% | 团课管理 | - | 待开发 |
**业务规则**:
- 课程数据实时更新
- 满员率 = 实际预约人数 / 课程容量
- 支持按周/月/季度统计
- 支持导出课程分析报表
**技术要点**:
- 使用定时任务每日更新统计数据
- 使用Redis缓存课程数据
- 使用Elasticsearch实现复杂查询
- 使用异步任务生成报表
---
### 模块5: 营销工具模块
#### 5.1 优惠券管理
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 优惠券创建 | P1 | 基础版完善 | 2天 | 创建成功率≥98% | 无 | - | 待开发 |
| 优惠券发放 | P1 | 基础版完善 | 2天 | 发放成功率≥99% | 优惠券创建 | - | 待开发 |
| 优惠券核销 | P1 | 基础版完善 | 2天 | 核销准确率100% | 优惠券发放 | - | 待开发 |
| 优惠券统计 | P1 | 基础版完善 | 1天 | 统计准确率100% | 优惠券核销 | - | 待开发 |
**业务规则**:
- 优惠券不可叠加使用(除非特别设置)
- 优惠券过期自动作废
- 优惠券使用后不支持退款(特殊情况除外)
- 优惠券发放后不可修改(可提前终止活动)
**技术要点**:
- 使用Redis缓存优惠券信息
- 使用分布式锁防止并发核销
- 使用消息队列实现优惠券发放
- 使用定时任务清理过期优惠券
---
#### 5.2 拼团活动
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 拼团创建 | P2 | 付费订阅版 | 2天 | 创建成功率≥98% | 无 | - | 待开发 |
| 拼团参与 | P2 | 付费订阅版 | 2天 | 参与成功率≥98% | 拼团创建 | - | 待开发 |
| 拼团管理 | P2 | 付费订阅版 | 1天 | 管理成功率≥98% | 拼团创建 | - | 待开发 |
| 拼团统计 | P2 | 付费订阅版 | 1天 | 统计准确率100% | 拼团参与 | - | 待开发 |
**业务规则**:
- 拼团失败自动退款
- 拼团成功后不可退款
- 同一用户可参与多个拼团
- 拼团价格不得高于原价
**技术要点**:
- 使用分布式锁防止拼团超员
- 使用消息队列实现拼团通知
- 使用定时任务检查拼团状态
- 使用Saga模式实现退款流程
---
#### 5.3 秒杀活动
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 秒杀创建 | P2 | 付费订阅版 | 2天 | 创建成功率≥98% | 无 | - | 待开发 |
| 秒杀参与 | P2 | 付费订阅版 | 3天 | 秒杀页面加载时间≤1秒 | 秒杀创建 | - | 待开发 |
| 秒杀管理 | P2 | 付费订阅版 | 1天 | 管理成功率≥98% | 秒杀创建 | - | 待开发 |
| 防刷机制 | P2 | 付费订阅版 | 2天 | 防刷机制有效率≥99% | 秒杀参与 | - | 待开发 |
**业务规则**:
- 秒杀商品不支持退款
- 秒杀订单需在规定时间内支付(如5分钟)
- 超时未支付自动取消订单
- 秒杀活动结束自动下架
**技术要点**:
- 使用Redis缓存秒杀商品库存
- 使用分布式锁防止超卖
- 使用消息队列实现订单处理
- 使用限流算法防止系统过载
---
#### 5.4 会员卡促销
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 买赠活动 | P2 | 付费订阅版 | 2天 | 活动创建成功率≥98% | 会员卡购买 | - | 待开发 |
| 折扣活动 | P2 | 付费订阅版 | 2天 | 活动创建成功率≥98% | 会员卡购买 | - | 待开发 |
| 限时优惠 | P2 | 付费订阅版 | 2天 | 活动创建成功率≥98% | 会员卡购买 | - | 待开发 |
| 推荐奖励 | P2 | 付费订阅版 | 2天 | 奖励发放及时率≥99% | 会员注册 | - | 待开发 |
**业务规则**:
- 促销活动不可叠加(除非特别设置)
- 活动价格需低于原价
- 活动需提前审核(防止设置错误)
- 活动数据需实时监控
**技术要点**:
- 使用Redis缓存活动信息
- 使用分布式锁防止并发操作
- 使用消息队列实现奖励发放
- 使用定时任务检查活动状态
---
#### 5.5 积分商城
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 积分获取 | P2 | 付费订阅版 | 2天 | 积分获取准确率100% | 会员注册 | - | 待开发 |
| 积分消耗 | P2 | 付费订阅版 | 2天 | 积分兑换成功率≥98% | 积分获取 | - | 待开发 |
| 积分商城 | P2 | 付费订阅版 | 2天 | 商品加载时间≤1秒 | 积分消耗 | - | 待开发 |
| 积分管理 | P2 | 付费订阅版 | 1天 | 积分统计准确率100% | 积分获取 | - | 待开发 |
**业务规则**:
- 积分有效期可配置(如1年)
- 积分过期自动清零
- 积分兑换不支持退款
- 积分规则调整需提前公告
**技术要点**:
- 使用Redis缓存积分信息
- 使用分布式锁防止并发操作
- 使用消息队列实现积分发放
- 使用定时任务清理过期积分
---
### 模块6: 支付集成模块
#### 6.1 微信支付
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 小程序内支付 | P1 | 基础版完善 | 2天 | 支付成功率≥98% | 无 | - | 待开发 |
| 扫码支付 | P1 | 基础版完善 | 2天 | 支付成功率≥98% | 无 | - | 待开发 |
| 支付回调处理 | P1 | 基础版完善 | 2天 | 回调处理准确率100% | 小程序内支付 | - | 待开发 |
| 退款处理 | P1 | 基础版完善 | 2天 | 退款成功率≥99% | 支付回调处理 | - | 待开发 |
**业务规则**:
- 支付订单需在规定时间内完成(如30分钟)
- 退款需原路返回
- 支付失败需明确提示原因
- 支付成功需发送通知
**技术要点**:
- 使用微信支付SDK
- 使用消息队列处理支付回调
- 使用分布式锁防止重复支付
- 使用幂等性设计保证数据一致性
---
#### 6.2 支付宝支付
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 小程序内支付 | P1 | 基础版完善 | 2天 | 支付成功率≥98% | 无 | - | 待开发 |
| 扫码支付 | P1 | 基础版完善 | 2天 | 支付成功率≥98% | 无 | - | 待开发 |
| 支付回调处理 | P1 | 基础版完善 | 2天 | 回调处理准确率100% | 小程序内支付 | - | 待开发 |
| 退款处理 | P1 | 基础版完善 | 2天 | 退款成功率≥99% | 支付回调处理 | - | 待开发 |
**业务规则**:
- 支付订单需在规定时间内完成
- 退款需原路返回
- 支付失败需明确提示原因
- 支付成功需发送通知
**技术要点**:
- 使用支付宝SDK
- 使用消息队列处理支付回调
- 使用分布式锁防止重复支付
- 使用幂等性设计保证数据一致性
---
#### 6.3 组合支付
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 积分+现金 | P2 | 付费订阅版 | 2天 | 支付明细计算准确率100% | 积分商城 | - | 待开发 |
| 优惠券+现金 | P2 | 付费订阅版 | 2天 | 支付明细计算准确率100% | 优惠券管理 | - | 待开发 |
| 余额+现金 | P2 | 付费订阅版 | 2天 | 支付明细计算准确率100% | 会员卡购买 | - | 待开发 |
| 支付方式选择 | P2 | 付费订阅版 | 1天 | 选择响应时间≤500ms | 无 | - | 待开发 |
**业务规则**:
- 组合支付需明确展示各支付明细
- 退款时按支付比例原路返回
- 优惠券使用后不退还(除非整单退款)
- 积分使用后不退还(除非整单退款)
**技术要点**:
- 使用策略模式实现多种支付方式
- 使用分布式事务保证数据一致性
- 使用消息队列实现异步支付
- 使用幂等性设计防止重复支付
---
#### 6.4 支付对账
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 对账文件下载 | P1 | 基础版完善 | 1天 | 下载成功率≥98% | 微信支付 | - | 待开发 |
| 对账处理 | P1 | 基础版完善 | 2天 | 对账准确率100% | 对账文件下载 | - | 待开发 |
| 对账报表 | P1 | 基础版完善 | 1天 | 报表生成时间≤5秒 | 对账处理 | - | 待开发 |
| 异常处理 | P1 | 基础版完善 | 2天 | 异常处理及时率≥99% | 对账处理 | - | 待开发 |
**业务规则**:
- 每日凌晨自动对账(T+1
- 对账差异需及时处理
- 对账记录永久保存
- 对账异常需告警通知
**技术要点**:
- 使用定时任务每日凌晨对账
- 使用消息队列处理对账结果
- 使用分布式锁防止重复对账
- 使用幂等性设计保证数据一致性
---
### 模块7: 系统管理模块
#### 7.1 用户管理
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 用户创建 | P0 | MVP | 1天 | 创建成功率≥98% | 无 | - | 待开发 |
| 用户编辑 | P0 | MVP | 1天 | 编辑成功率≥98% | 用户创建 | - | 待开发 |
| 用户删除 | P0 | MVP | 0.5天 | 删除成功率≥98% | 用户创建 | - | 待开发 |
| 用户角色分配 | P0 | MVP | 1天 | 分配成功率≥98% | 用户创建 | - | 待开发 |
**业务规则**:
- 用户需分配角色
- 用户删除需确认
- 用户密码需加密存储
**技术要点**:
- 使用Spring Security实现用户认证
- 使用JWT实现无状态会话
- 使用BCrypt加密密码
- 使用Redis缓存用户信息
---
#### 7.2 角色权限管理
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 角色创建 | P0 | MVP | 1天 | 创建成功率≥98% | 无 | - | 待开发 |
| 角色编辑 | P0 | MVP | 1天 | 编辑成功率≥98% | 角色创建 | - | 待开发 |
| 角色删除 | P0 | MVP | 0.5天 | 删除成功率≥98% | 角色创建 | - | 待开发 |
| 权限分配 | P0 | MVP | 1天 | 权限控制准确率100% | 角色创建 | - | 待开发 |
| 角色分配 | P0 | MVP | 1天 | 分配成功率≥98% | 角色创建 | - | 待开发 |
**业务规则**:
- 角色需分配权限
- 角色删除需确认
- 权限分配需最小化原则
**技术要点**:
- 使用RBAC模型实现权限控制
- 使用Spring Security实现权限校验
- 使用Redis缓存权限信息
- 使用AOP记录操作日志
---
### 模块8: UI模版定制模块
#### 8.1 品牌定制
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| Logo上传 | P1 | 基础版完善 | 1天 | 上传成功率≥95% | 无 | - | 待开发 |
| 品牌主色调设置 | P1 | 基础版完善 | 1天 | 设置响应时间≤200ms | 无 | - | 待开发 |
| 背景图上传 | P1 | 基础版完善 | 1天 | 上传成功率≥95% | 无 | - | 待开发 |
| 实时预览 | P1 | 基础版完善 | 1天 | 预览响应时间≤200ms | Logo上传 | - | 待开发 |
**业务规则**:
- Logo支持PNG/JPG格式,限制2MB以内
- 颜色支持RGB和HEX格式
- 品牌元素应用范围包括小程序和管理后台
- 配置变更实时生效,无需重新部署
**技术要点**:
- 使用OSS存储品牌元素
- 使用Redis缓存品牌配置
- 使用WebSocket实现实时预览
- 使用CDN加速图片加载
---
#### 8.2 布局调整
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 模块顺序调整 | P2 | 付费订阅版 | 2天 | 拖拽操作流畅度≥90% | 无 | - | 待开发 |
| 模块隐藏/显示 | P2 | 付费订阅版 | 1天 | 隐藏成功率100% | 无 | - | 待开发 |
| 首页布局类型选择 | P2 | 付费订阅版 | 1天 | 选择响应时间≤300ms | 无 | - | 待开发 |
| 导航菜单自定义 | P2 | 付费订阅版 | 2天 | 自定义成功率≥98% | 无 | - | 待开发 |
**业务规则**:
- 模块顺序调整支持跨区域移动
- 隐藏的模块不显示但数据保留
- 布局调整按角色区分
- 布局变更自动保存到配置历史
**技术要点**:
- 使用拖拽库实现模块排序
- 使用JSON存储布局配置
- 使用Redis缓存布局信息
- 使用WebSocket实现实时同步
---
#### 8.3 预设模板
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 模板预览 | P2 | 付费订阅版 | 1天 | 模板加载成功率≥98% | 无 | - | 待开发 |
| 一键应用模板 | P2 | 付费订阅版 | 1天 | 模板应用成功率≥95% | 模板预览 | - | 待开发 |
| 模板收藏 | P2 | 付费订阅版 | 0.5天 | 收藏成功率≥98% | 模板预览 | - | 待开发 |
| 模板对比 | P2 | 付费订阅版 | 1天 | 对比准确性100% | 模板预览 | - | 待开发 |
**业务规则**:
- 模板应用后保留租户已有的品牌配置
- 模板支持版本控制和灰度发布
- 模板切换支持配置合并
- 禁用的模板不可选择
**技术要点**:
- 使用JSON存储模板配置
- 使用Redis缓存模板信息
- 使用版本控制管理模板版本
- 使用CDN加速模板加载
---
#### 8.4 配置历史
| 功能点 | 优先级 | 开发阶段 | 预计工时 | 验收标准 | 依赖关系 | 负责人 | 状态 |
|--------|--------|---------|---------|---------|---------|--------|------|
| 配置历史列表查看 | P2 | 付费订阅版 | 1天 | 列表加载时间≤1秒 | 无 | - | 待开发 |
| 配置版本对比 | P2 | 付费订阅版 | 1天 | 对比准确性100% | 配置历史列表查看 | - | 待开发 |
| 配置回滚 | P2 | 付费订阅版 | 1天 | 回滚成功率≥98% | 配置历史列表查看 | - | 待开发 |
| 配置导出/导入 | P2 | 付费订阅版 | 1天 | 导出成功率≥98% | 配置历史列表查看 | - | 待开发 |
**业务规则**:
- 每次配置变更自动生成新版本号
- 配置历史保留90天
- 回滚操作需要确认
- 配置对比高亮显示差异
**技术要点**:
- 使用数据库存储配置历史
- 使用版本控制管理配置版本
- 使用Redis缓存配置信息
- 使用异步任务实现配置导出
---
## 🚀 开发顺序建议
### MVP阶段(P0功能)
**迭代0:微信配置管理模块**2026-03-02 ~ 2026-03-13
- [ ] 小程序配置(AppID、AppSecret、验证)
- [ ] 服务号配置(AppID、AppSecret、Token、AES Key、验证)
- [ ] 模板消息配置(ID、字段映射、测试)
**迭代1:会员管理模块**2026-03-16 ~ 2026-03-27
- [ ] 微信快捷登录(小程序授权登录)
- [ ] 服务号关注关联(UnionID关联)
- [ ] 会员信息管理(查看、编辑)
- [ ] 用户管理(增删改查)
- [ ] 角色权限管理(RBAC模型)
**迭代2:会员卡管理模块**2026-03-30 ~ 2026-04-10
- [ ] 会员卡购买(时长卡、次卡、储值卡)
- [ ] 会员卡查看(权益、使用记录)
**迭代3:团课预约模块**2026-04-13 ~ 2026-04-24
- [ ] 团课列表展示(筛选、搜索)
- [ ] 团课预约(权益扣减)
- [ ] 团课取消(权益退还)
**迭代4:扫码签到模块**2026-04-27 ~ 2026-05-08
- [ ] 扫码签到(会员卡验证、预约验证)
- [ ] 签到记录查看
**迭代5:基础数据统计模块**2026-05-11 ~ 2026-05-22
- [ ] 会员数据统计(新增、活跃、留存)
- [ ] 预约数据统计(预约率、取消率)
- [ ] 签到数据统计(签到率、到店频次)
**迭代6-7MVP验收与优化**2026-05-25 ~ 2026-06-26
- [ ] 端到端测试(E2E Test
- [ ] 性能测试(压力测试)
- [ ] 用户验收测试(UAT
- [ ] 缺陷修复
---
### 基础版完善阶段(P1功能)
**迭代8:营销工具模块**2026-06-29 ~ 2026-07-10
- [ ] 优惠券管理(创建、发放、核销)
- [ ] 手机号补全(微信手机号快捷获取)
- [ ] 开放平台配置(UnionID统一认证)
**迭代9:支付集成模块**2026-07-13 ~ 2026-07-24
- [ ] 微信支付集成
- [ ] 支付宝支付集成
- [ ] 支付回调处理
- [ ] 退款处理
- [ ] 支付对账
**迭代10UI模版定制模块**2026-07-27 ~ 2026-08-07
- [ ] 品牌定制(Logo、颜色、字体)
**迭代11:基础版验收与发布**2026-08-10 ~ 2026-08-28
- [ ] 端到端测试(E2E Test
- [ ] 性能测试(压力测试)
- [ ] 用户验收测试(UAT
- [ ] 生产环境部署
---
## 📝 协作指南
### 任务认领流程
1. **查看功能清单**:团队成员查看本文档,了解功能详情
2. **认领任务**:在"负责人"列填写自己的名字
3. **更新状态**:将"状态"从"待开发"改为"开发中"
4. **开发完成**:开发完成后,将"状态"改为"已完成"
5. **代码审查**:提交Pull Request,等待代码审查
6. **测试验收**:测试通过后,将"状态"改为"已验收"
### 开发规范
**代码规范**:
- 遵循阿里巴巴Java开发规范
- 使用Lombok简化代码
- 使用MapStruct进行对象映射
- 所有公共方法必须添加注释
**测试规范**:
- 单元测试覆盖率 ≥ 80%
- 集成测试覆盖率 ≥ 60%
- E2E测试覆盖率 ≥ 50%
- 所有测试必须通过才能合并代码
**提交规范**:
- feat: 新功能
- fix: 修复bug
- docs: 文档更新
- style: 代码格式调整
- refactor: 重构
- test: 测试相关
- chore: 构建/工具相关
### 沟通机制
**每日站会**:
- 时间:每天上午10:00(15分钟)
- 内容:昨天完成什么、今天计划做什么、遇到什么问题
**迭代规划会**:
- 时间:每个迭代第1天上午(1.5小时)
- 内容:规划本迭代任务、任务拆解和估算
**迭代评审会**:
- 时间:每个迭代第10天下午(1小时)
- 内容:演示功能、收集反馈
### 工具使用
**项目管理**: Jira
**代码管理**: GitLab
**文档协作**: Confluence
**即时通讯**: 企业微信
**设计协作**: Figma
---
## 📈 进度跟踪
### 整体进度
| 模块 | 功能点总数 | P0功能点 | P1功能点 | P2功能点 | 已完成 | 进行中 | 待开发 | 完成率 |
|------|-----------|---------|---------|---------|--------|--------|--------|--------|
| 会员管理 | 10 | 4 | 4 | 2 | 0 | 0 | 10 | 0% |
| 预约管理 | 12 | 4 | 8 | 0 | 0 | 0 | 12 | 0% |
| 签到管理 | 7 | 2 | 5 | 0 | 0 | 0 | 7 | 0% |
| 数据统计 | 20 | 0 | 4 | 16 | 0 | 0 | 20 | 0% |
| 营销工具 | 20 | 0 | 4 | 16 | 0 | 0 | 20 | 0% |
| 支付集成 | 16 | 0 | 8 | 8 | 0 | 0 | 16 | 0% |
| 系统管理 | 10 | 5 | 5 | 0 | 0 | 0 | 10 | 0% |
| UI模版定制 | 16 | 0 | 4 | 12 | 0 | 0 | 16 | 0% |
| **总计** | **111** | **15** | **42** | **54** | **0** | **0** | **111** | **0%** |
### MVP阶段进度
| 迭代 | 功能模块 | 预计工时 | 已完成工时 | 完成率 | 状态 |
|------|---------|---------|-----------|--------|------|
| 迭代0 | 微信配置管理模块 | 7天 | 0天 | 0% | 待开始 |
| 迭代1 | 会员管理模块 | 10天 | 0天 | 0% | 待开始 |
| 迭代2 | 会员卡管理模块 | 7天 | 0天 | 0% | 待开始 |
| 迭代3 | 团课预约模块 | 7天 | 0天 | 0% | 待开始 |
| 迭代4 | 扫码签到模块 | 5天 | 0天 | 0% | 待开始 |
| 迭代5 | 基础数据统计模块 | 4天 | 0天 | 0% | 待开始 |
| 迭代6-7 | MVP验收与优化 | 15天 | 0天 | 0% | 待开始 |
| **总计** | **MVP阶段** | **55天** | **0天** | **0%** | **待开始** |
---
## 🔗 相关文档
- [产品迭代计划](./产品迭代计划.md)
- [功能优先级矩阵](./功能优先级矩阵.md)
- [基础版产品设计文档](../product/PRD-基础版产品设计文档.md)
- [基础版业务概要设计](../design/business/B-HLD-基础版-业务概要设计.md)
- [基础版业务详细设计](../design/business/B-LLD-基础版-业务详细设计.md)
- [基础版技术实现详细设计](../design/technical/T-ILD-基础版-技术实现详细设计.md)
- [微信快捷登录与服务号消息推送方案设计](../superpowers/specs/2026-04-07-wechat-login-message-push-design.md)
---
## 📞 联系方式
如有疑问,请联系:
- **产品负责人**: 张翔
- **技术负责人**: 张翔
- **项目经理**: 张翔
---
**最后更新时间**: 2026-04-07
**下次更新时间**: 每周五更新进度
---
## 📝 更新记录
### v1.1 (2026-04-07)
**重大变更:采用微信快捷登录+服务号消息推送方案**
**更新内容**:
1. **文档范围明确**
- 添加重要说明,明确基础版开发范围为P0和P1功能
- P2和P3功能仅作为未来规划参考,不在基础版开发范围内
- 更新开发阶段说明,强调各阶段的功能范围
2. **新增模块**
- 模块0: 微信配置管理模块
- 小程序配置(AppID、AppSecret、验证)
- 服务号配置(AppID、AppSecret、Token、AES Key、验证)
- 开放平台配置(UnionID统一认证)
- 模板消息配置(ID、字段映射、测试)
3. **会员注册模块调整**
- 移除"手机号注册"和"手机号验证"功能
- 新增"微信快捷登录"功能(P0
- 新增"服务号关注关联"功能(P0)
- 新增"手机号补全"功能(P1,可选)
4. **消息推送方式调整**
- 所有业务通知从短信改为服务号模板消息
- 包括:预约提醒、签到通知、会员卡到期提醒等
- 新增验证码通知功能(通过服务号发送)
5. **开发顺序调整**
- 新增迭代0:微信配置管理模块(2026-03-02 ~ 2026-03-13
- 迭代1调整为:微信快捷登录、服务号关注关联
- 迭代8新增:手机号补全、开放平台配置
6. **成本优化**
- 移除短信费用(约600元/年)
- 新增服务号认证费用(300元/年)
- 年度净节省:约300元/年
**影响范围**:
- 会员注册流程
- 消息推送机制
- 租户配置管理
- 数据库设计(新增微信配置表)
**技术方案**:
- 采用微信开放平台UnionID机制统一用户身份
- 每个租户独立配置小程序和服务号
- 服务号模板消息替代短信通知
**相关文档**:
- [微信快捷登录与服务号消息推送方案设计](../superpowers/specs/2026-04-07-wechat-login-message-push-design.md)
---
### v1.0 (2026-04-07)
**初始版本**
- 完成基础版功能清单梳理
- 明确功能优先级和开发阶段
- 制定开发顺序和进度跟踪机制