144 lines
5.1 KiB
Markdown
144 lines
5.1 KiB
Markdown
# Gym Manage - 健身房管理系统
|
|
|
|
一个面向健身房的多端业务管理系统：后台管理 Web 端（管理员/员工）、会员端小程序（微信小程序）、教练端小程序（微信小程序），共享同一 SpringBoot 后端。
|
|
|
|
## Language
|
|
|
|
### 系统管理 (System)
|
|
|
|
**用户 (User)**:
|
|
拥有登录凭据的系统账号，可被分配一个或多个角色，通过角色获得操作权限。
|
|
_Avoid_: 账号、员工、管理员
|
|
|
|
**角色 (Role)**:
|
|
一组权限的集合体。用户通过被分配角色来间接获得权限。角色包含角色编码（唯一标识）和权限树配置。
|
|
_Avoid_: 权限组、岗位
|
|
|
|
**菜单 (Menu)**:
|
|
前端页面的导航入口树。菜单可嵌套，与权限绑定后控制用户可见的页面和按钮。
|
|
_Avoid_: 导航、路由
|
|
|
|
**数据字典 (Dict Type / Dict Data)**:
|
|
"类型-数据项"两级结构。Dict Type 定义字段类别（如"课程状态"），Dict Data 定义具体枚举值（如"待开始"、"进行中"）。
|
|
_Avoid_: 枚举、配置项
|
|
|
|
**系统配置 (System Config)**:
|
|
系统运行时的键值对参数，如上传文件大小限制、默认分页条数等。
|
|
_Avoid_: 设置、参数
|
|
|
|
### 审计 (Audit)
|
|
|
|
**操作日志 (Operation Log)**:
|
|
记录用户在系统中的所有操作（创建/修改/删除），包含操作人、操作模块、操作时间、IP 地址。
|
|
_Avoid_: 行为日志、活动记录
|
|
|
|
**登录日志 (Login Log)**:
|
|
记录所有的登录/登出事件，包含成功/失败状态和原因。
|
|
_Avoid_: 认证记录、会话日志
|
|
|
|
**异常日志 (Exception Log)**:
|
|
系统运行时的未捕获异常记录，包含堆栈信息、请求路径。
|
|
_Avoid_: 错误日志、故障记录
|
|
|
|
### 通知 (Notification)
|
|
|
|
**公告 (Notice)**:
|
|
管理员发布的系统级通知，展示给所有用户。
|
|
_Avoid_: 消息、通知
|
|
|
|
**轮播图 (Banner)**:
|
|
首页顶部轮播的推广图片，可配置跳转链接和生效时间。
|
|
_Avoid_: 广告、幻灯片
|
|
|
|
### 会员 (Member)
|
|
|
|
**会员 (Member)**:
|
|
在系统中注册的健身用户，可通过微信小程序登录认证。拥有会员卡、储值卡等资产。
|
|
_Avoid_: 客户、用户、消费者
|
|
|
|
**会员卡类型 (Member Card Type)**:
|
|
预定义的会员卡模板，包含名称、时长（天）、价格、权益描述。
|
|
_Avoid_: 卡种、套餐
|
|
|
|
**会员卡记录 (Member Card Record)**:
|
|
会员购买特定会员卡类型的实例，有生效期、失效期、使用次数等生命周期数据。
|
|
_Avoid_: 购卡记录、会员资格
|
|
|
|
**储值卡 (Stored Card)**:
|
|
会员的预充值余额账户，用于消费支付。有支付密码保护。
|
|
_Avoid_: 余额、钱包
|
|
|
|
### 团课 (Group Course)
|
|
|
|
**团课 (Group Course)**:
|
|
由教练带领多名会员参加的集体健身课程。有类型、标签、时间、地点、人数上限、教练等属性。
|
|
_Avoid_: 课程、班级、大课
|
|
|
|
**课程类型 (Course Type)**:
|
|
团课的分类体系，如"瑜伽"、"动感单车"、"搏击操"。
|
|
_Avoid_: 课程分类
|
|
|
|
**课程标签 (Course Label)**:
|
|
团课的附加标签，用于搜索和推荐，可多个标签叠加。
|
|
_Avoid_: 标签、标记
|
|
|
|
**预约 (Booking)**:
|
|
会员对某节团课的报名操作。预约后可取消，超时不可取消。
|
|
_Avoid_: 报名、预定、登记
|
|
|
|
**签到 (Check-In)**:
|
|
会员到达上课地点后确认到场的操作。通过扫描教练展示的二维码完成。
|
|
_Avoid_: 打卡、签到
|
|
|
|
**签到二维码 (Check-In QR Code)**:
|
|
教练端生成的限时二维码，会员扫描后完成签到。有时效性和防伪造机制。
|
|
_Avoid_: 签到码
|
|
|
|
**课程推荐 (Course Recommend)**:
|
|
系统管理员手动指定的精选课程列表，在会员端首页展示。
|
|
_Avoid_: 热门课程、精选
|
|
|
|
### 教练 (Coach)
|
|
|
|
**教练 (Coach)**:
|
|
可开设和带领团课的人员。关联课程列表、违规记录。
|
|
_Avoid_: 私教、指导员、讲师
|
|
|
|
**开课 (Start Course / Open Course)**:
|
|
教练到上课时间后点击"开始上课"将课程状态从"待开始"变为"进行中"。
|
|
_Avoid_: 开始上课、启动课程
|
|
|
|
**结课 (End Course)**:
|
|
教练下课后点击"结束课程"将课程状态从"进行中"变为"已完成"。
|
|
_Avoid_: 下课、完成课程
|
|
|
|
**违规记录 (Violation)**:
|
|
教练的违规行为记录，如迟到、早退、未开课等。
|
|
_Avoid_: 处罚记录、违纪
|
|
|
|
### 数据统计 (Statistics)
|
|
|
|
**数据统计 (Data Statistics)**:
|
|
系统仪表盘数据，包含会员增长趋势、预约率、签到率、收入等维度的图表和汇总数据。
|
|
_Avoid_: 报表、分析
|
|
|
|
**教练业绩 (Coach Performance)**:
|
|
按教练维度的教学数据排行和明细，包含开课次数、学员人次、出勤率等。
|
|
_Avoid_: 教练评分、教练排名
|
|
|
|
### 支付 (Payment)
|
|
|
|
**汇付支付 (Huifu Payment)**:
|
|
通过汇付天下聚合支付平台完成的支付流程，包含创建订单、支付回调、退款。
|
|
_Avoid_: 微信支付、支付宝
|
|
|
|
### 认证 (Auth)
|
|
|
|
**JWT Token**:
|
|
JSON Web Token，用户登录后获取的身份凭证，所有 API 请求需在 Authorization header 携带。有过期时间。
|
|
_Avoid_: 令牌、会话
|
|
|
|
**签名 (Signature)**:
|
|
API 请求的防篡改签名参数，由请求体 + 时间戳 + 密钥生成。
|
|
_Avoid_: 校验码
|