# 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
测试数据工厂，提供随机的测试数据对象（用户、角色、菜单等）。