170 lines
5.6 KiB
Markdown
170 lines
5.6 KiB
Markdown
# CONTEXT.md — 健身房管理系统 领域术语表
|
|
|
|
> 本文档定义项目的统一语言（Ubiquitous Language），确保需求、设计、代码、测试中术语一致。
|
|
> 不含任何实现细节，仅为概念定义和关系。
|
|
|
|
---
|
|
|
|
## 一、核心业务概念
|
|
|
|
### 租户 (Tenant)
|
|
健身房经营实体。每个租户拥有独立的小程序、服务号、品牌配置。系统中的所有业务数据按租户隔离。
|
|
|
|
### 会员 (Member)
|
|
在健身房消费的终端用户。通过微信小程序注册，拥有会员档案、会员卡和预约记录。
|
|
|
|
### 用户 (User)
|
|
系统管理端的操作人员（健身房员工）。包括管理员、前台、店长等，拥有不同的角色和权限。
|
|
|
|
### 管理员 (Admin)
|
|
拥有系统最高权限的用户，可管理所有用户、角色、权限、配置。
|
|
|
|
### 教练 (Coach)
|
|
负责团课授课的人员，属于用户的一种扩展身份。
|
|
|
|
---
|
|
|
|
## 二、微信生态概念
|
|
|
|
### 小程序 (Mini Program / MiniApp)
|
|
会员端的微信小程序入口。用户通过小程序完成登录、浏览课程、预约、签到等操作。
|
|
|
|
### 服务号 (Service Account)
|
|
用于向会员推送模板消息的微信服务号。发送预约提醒、签到通知、会员卡到期提醒等。
|
|
|
|
### 开放平台 (Open Platform)
|
|
微信开放平台，用于统一小程序和服务号的用户身份（通过 UnionID）。
|
|
|
|
### UnionID
|
|
微信开放平台下的统一用户标识。同一微信开放平台账号下的不同应用（小程序、服务号），同一用户的 UnionID 相同。
|
|
|
|
### OpenID
|
|
单个微信应用下的用户标识。同一用户在不同应用中 OpenID 不同。
|
|
|
|
### 模板消息 (Template Message)
|
|
通过服务号向会员发送的结构化通知消息。每月限额 4 条/用户。
|
|
|
|
---
|
|
|
|
## 三、团课与预约
|
|
|
|
### 团课 (Group Course)
|
|
健身房提供的团体健身课程。包含课程名称、教练、时间、地点、容量（最多 20 人）等信息。
|
|
|
|
### 团课类型 (Course Type)
|
|
团课的分类维度，如"瑜伽、动感单车、搏击操"等。
|
|
|
|
### 团课标签 (Course Label)
|
|
团课的标记维度，如"新手友好、高强度、减脂"等。
|
|
|
|
### 团课推荐 (Course Recommendation)
|
|
管理员手动标记的推荐课程，在小程序首页优先展示。
|
|
|
|
### 预约 (Booking / Reservation)
|
|
会员报名参加团课的操作。预约成功后扣减会员卡权益，课程开始前 30 分钟截止预约。
|
|
|
|
### 取消预约 (Cancel Booking)
|
|
会员取消已报名的团课。需在课程开始前至少 2 小时操作，取消后自动退还权益。
|
|
|
|
---
|
|
|
|
## 四、会员卡
|
|
|
|
### 会员卡 (Membership Card)
|
|
会员购买的权益凭证，分为三种类型：
|
|
- **时长卡 (Duration Card)**：在有效期内无限次使用
|
|
- **次卡 (Count Card)**：按次数扣减
|
|
- **储值卡 (Stored Value Card)**：按金额扣减
|
|
|
|
### 会员卡权益 (Card Entitlement)
|
|
会员卡包含的可使用权益，如每日入场次数、可预约课程数。
|
|
|
|
### 会员卡状态 (Card Status)
|
|
会员卡的生命周期状态：激活、冻结、到期、已退款。
|
|
|
|
### 到期提醒 (Expiry Reminder)
|
|
会员卡到期前 7 天通过服务号模板消息向会员发送提醒。
|
|
|
|
---
|
|
|
|
## 五、签到
|
|
|
|
### 签到 (Check-in)
|
|
会员到场时的身份确认操作。需验证会员卡有效性和预约信息（如有团课预约）。
|
|
|
|
### 签到码 (Check-in Code)
|
|
会员出示的动态二维码，用于前台/设备扫描签到。
|
|
|
|
---
|
|
|
|
## 六、支付
|
|
|
|
### 支付 (Payment)
|
|
会员购买会员卡或课程时的在线支付操作，支持微信支付和支付宝支付。
|
|
|
|
### 退款 (Refund)
|
|
将已支付金额原路退回会员账户的操作。
|
|
|
|
### 对账 (Reconciliation)
|
|
每日将系统支付记录与微信/支付宝账单进行比对核验的过程。
|
|
|
|
---
|
|
|
|
## 七、权限与审计
|
|
|
|
### 角色 (Role)
|
|
权限的集合。系统中的角色包括管理员、店长、前台等，采用 RBAC（基于角色的访问控制）模型。
|
|
|
|
### 权限 (Permission)
|
|
对系统资源的操作许可。包括菜单访问权限、按钮操作权限、数据查看权限。
|
|
|
|
### 菜单 (Menu)
|
|
管理后台的导航入口，通过权限控制可见性。
|
|
|
|
### 操作日志 (Operation Log)
|
|
记录用户在系统中的关键操作（增删改），用于审计追溯。
|
|
|
|
### 登录日志 (Login Log)
|
|
记录用户的登录行为，包括登录 IP、时间、结果。
|
|
|
|
### 异常日志 (Exception Log)
|
|
记录系统运行时异常，用于问题排查。
|
|
|
|
---
|
|
|
|
## 八、配置
|
|
|
|
### 参数配置 (System Config)
|
|
系统级别的可调参数，如签到超时时间、预约截止时间等，通过管理后台的参数配置页面管理。
|
|
|
|
### 字典 (Dictionary)
|
|
系统使用的枚举值配置，如下拉选项、状态值等，通过字典管理页面维护。
|
|
|
|
### 轮播图 (Banner)
|
|
小程序首页的推广图片，通过管理后台管理。
|
|
|
|
### 通知公告 (Notice)
|
|
向会员或用户发布的系统公告，通过管理后台管理。
|
|
|
|
---
|
|
|
|
## 九、测试相关概念
|
|
|
|
### 冒烟测试 (Smoke Test)
|
|
每次提交后运行的快速验证测试，覆盖核心登录/登出流程，执行时间 ≤ 5 分钟。
|
|
|
|
### 用户旅程测试 (Journey Test / E2E)
|
|
模拟真实用户完整操作链路的端到端测试。覆盖从登录到完成业务操作的全流程。
|
|
|
|
### 角色边界测试 (Role Boundary Test)
|
|
验证不同角色（Admin/普通用户/未登录）的权限隔离是否正确的测试。
|
|
|
|
### Page Object
|
|
E2E 测试中的设计模式，将页面元素定位和操作封装为类，提高测试可维护性。
|
|
|
|
### TestDataManager
|
|
测试数据管理器，负责测试数据的自动生成（带唯一前缀）和清理回调注册。
|
|
|
|
### TestDataFactory
|
|
测试数据工厂，提供随机的测试数据对象（用户、角色、菜单等）。
|