Files
gym-manage/CONTEXT.md
T

5.1 KiB

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