权益卡 3.0
权益卡是晓葆开放平台的核心服务能力，覆盖卡池管理 → 用户激活 → 权益预约 → 履约核销 → 第三方卡券的完整生命周期。合作方可将自有健康权益（体检、视频问诊、 健康站检测次数等）通过权益卡体系发放给用户，并通过 API 完成核销与履约管理。
产品概述
权益卡 3.0 开放平台面向两类合作方：
- 客户（权益使用方）：用户通过激活卡号使用权益，包括查询权益项、 预约健康服务、评价服务质量。开发者可将权益卡能力嵌入自有 App 或小程序中。
- 供应商（权益履约方）：提供具体服务的线下/线上服务方（健康站、体检中心、 诊所等），通过 API 核销用户权益，完成服务确认与记录。
核心实体关系
card_pool_batches（卡池批次）
↓ 生成卡号
card_pools（卡号池，每张卡含激活码）
↓ 用户激活
user_benefit_cards（用户权益卡，含有效期）
↓ 关联权益项
user_benefit_items（用户权益项，含剩余次数）
↓ 预约或直接使用
benefit_appointments（预约记录，可选）
benefit_fulfillment_records（履约记录，核销后生成）| 实体 | 说明 |
|---|---|
card_pool_batches | 一批权益卡的配置（卡名、权益项列表、有效期规则、发行方） |
card_pools | 单张卡的卡号和激活码，未激活前归属于批次 |
user_benefit_cards | 用户激活后的权益卡，含激活时间和过期时间 |
user_benefit_items | 权益卡下每个权益项的剩余次数（如「轻体检 × 12 次」） |
benefit_appointments | 用户预约到店服务的记录（部分权益需要提前预约） |
benefit_fulfillment_records | 实际使用记录，每次核销生成一条，不可撤销 |
两类角色
| 角色 | 身份 | 典型操作 | 鉴权 |
|---|---|---|---|
| 客户端 | 普通用户（个人或企业员工） | 激活权益卡、查询权益项、预约服务、评价体验 | JWT Bearer Token（用户登录后获取） |
| 供应商端 | 服务方（健康站、体检中心、医护机构等） | 核销权益（扣减次数）、查看待履约记录、回传服务状态 | AppKey + MD5 签名（S2S，即将开放） |
履约方式
权益项的履约方式决定用户如何使用权益：
| fulfillment_method | 说明 | 典型场景 |
|---|---|---|
APPOINTMENT | 健康站预约（绑定 service_points） | 体检、健康检测到指定健康站预约到店 |
FORM_BOOKING | 表单预约（省市区 + 地址） | 上门服务、非健康站的线下服务 |
PRE_ISSUED_CARD | 预发卡（第三方电子卡券） | 电子礼品卡、会员卡等预先采购的第三方卡券 |
API_REAL_TIME_ISSUE | 实时发卡（第三方 API 对接） | 在线问诊、健康咨询等需实时兑换的服务 |
API_DELAYED_ACTIVATION | 预发卡 + 延迟激活 | 需用户自行激活的混合模式 |
注意：预约（benefit_appointments）并非所有权益的必要步骤，仅 APPOINTMENT 和 FORM_BOOKING 两种履约方式需要提前预约，其余类型可直接核销。