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