# 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_: 校验码