1项目概述

1.1 项目背景

随着健身行业数字化转型加速，传统健身房需要一套完整的会员管理移动端应用，实现会员卡管理、课程预约、教练匹配等核心业务的线上化。本项目旨在为健身俱乐部打造一款面向会员的移动端产品，提升会员体验和运营效率。

1.2 目标用户

• 健身俱乐部现有会员：需要管理会员卡、预约课程、查看训练记录
• 潜在新会员：了解场馆信息、教练资源，促进转化

1.3 产品目标

1. 实现会员卡电子化，支持扫码签到和人脸签到
2. 提供在线课程购买、会员卡购买和私教预约功能
3. 搭建会员与教练的线上沟通桥梁
4. 支持美团/抖音团购券在线核销
5. 提升会员留存率和复购率

2功能架构

3页面需求详细说明

3.1 首页

3.2 会员中心

3.3 会员二维码弹窗

3.4 会员信息

3.5 切换门店

3.6 场馆详情

3.7 教练列表

3.8 教练详情

3.9 预约课程

3.10 私教记录

↓ v2.0 新增需求 ↓

3.11 一键登录 / 手机号登录

3.12 首页（升级版）

3.13 课程商城（课程列表）

3.14 课程购买

3.15 会员卡列表/购买

3.16 会员卡购买（确认订单）

3.17 我的订单

3.18 团购核销（美团/抖音）

3.19 人脸录入

3.20 会员卡激活

3.21 私教课激活

4非功能性需求

5核心数据模型

6核心交互流程

6.1 课程预约流程

6.2 签到流程

6.3 会员二维码签到流程

6.4 课程购买流程（新增）

6.5 会员卡购买流程（新增）

6.6 人脸录入流程（新增）

6.7 团购核销流程（新增）

6.8 会员卡激活流程（新增）

6.9 私教课激活流程（新增）

7版本规划

8多场馆微信支付架构

8.1 方案选型：微信支付服务商模式

本项目采用微信支付服务商模式（API v3），实现"一套小程序 + 多场馆独立收款"的核心需求。该方案的优势：

8.2 核心架构

┌─────────────────────┐
│   微信小程序 (1个)    │  ← 服务商的 AppID（sp_appid）
│    FITCARD 健身卡     │
└──────────┬──────────┘
           │ 下单请求（携带 store_id）
┌──────────▼──────────┐
│    后端服务 (1套)     │  ← 根据 store_id 查询对应的 sub_mchid
│  payment-service    │
└──────────┬──────────┘
           │ 调用微信支付 API（JSAPI）
┌──────────▼──────────┐
│   服务商商户号        │  ← sp_mchid（仅发起支付，不收款）
│   (父商户号)         │
└──────────┬──────────┘
           │
    ┌──────┴──────┬───────────┬───────────┐
    ▼             ▼           ▼           ▼
┌────────┐  ┌────────┐  ┌────────┐  ┌────────┐
│子商户A  │  │子商户B  │  │子商户C  │  │子商户D  │
│北京旗舰店│  │上海国贸店│  │深圳南山店│  │杭州西湖店│
│sub_mchid│  │sub_mchid│  │sub_mchid│  │sub_mchid│
└────────┘  └────────┘  └────────┘  └────────┘
    ▲             ▲           ▲           ▲
    └─────────────┴───────────┴───────────┘
              资金直达各场馆账户，不经平台

8.3 关键配置参数

8.4 数据库设计

8.5 支付流程

8.5.1 统一下单流程

8.5.2 关键 API 调用（JSAPI 统一下单）

POST https://api.mch.weixin.qq.com/v3/pay/partner/transactions/jsapi
Content-Type: application/json
Authorization: WECHATPAY2-SHA256-RSA2048 ...

{
  "sp_appid":  "wx1234567890abcdef",   // 服务商小程序 AppID
  "sp_mchid":  "1234567890",            // 服务商商户号
  "sub_appid":  "wx1234567890abcdef",   // 子商户 AppID（共用小程序）
  "sub_mchid":  "100001",                // ← 核心：根据 store_id 动态切换
  "description":  "季卡会员 - 北京旗舰店",
  "out_trade_no": "ORDER20260415001",
  "notify_url":   "https://api.fitcard.com/pay/notify",
  "amount": {
    "total":    49900,        // 单位：分（¥499.00）
    "currency": "CNY"
  },
  "payer": {
    "sp_openid": "oXXXX..."  // 用户在服务商小程序下的 openid
  }
}

8.6 回调通知处理

8.7 退款流程

8.8 场馆（子商户）入驻流程

8.9 安全与风控

8.10 对账与结算

8.11 后端接口设计

8.12 异常场景处理

9美团/抖音团购核销接入

9.1 美团团购核销 — 开通申请流程

美团团购核销接入需通过美团技术服务合作中心完成，分为服务商和自研品牌商两种身份。

第一步：官网注册

• 访问 美团技术服务合作中心（developer.meituan.com）
• 点击「注册」，选择对应身份类型（服务商 / 自研品牌商）

第二步：提交资质材料

第三步：审核与签约

1. 运营审核（通常 1-2 个工作日）
2. 法人/授权人短信实名认证
3. 签订电子合同
4. 缴纳保证金（服务商需缴纳，金额根据业务评估自动生成）

第四步：获取开发者凭证

审核通过后，在控制台获取 developerId 和 SignKey，用于后续 API 调用签名。

9.2 美团团购核销 — 技术对接流程

9.3 抖音团购核销 — 开通申请流程

抖音团购核销接入需通过抖音开放平台完成，创建生活服务商家应用。

第一步：前置准备

• 入驻 抖音来客（life.douyin.com），获取来客账户 ID

第二步：创建应用

• 访问抖音开放平台（open.douyin.com）
• 注册并认证「生活服务商家应用代开发」能力
• 平台审核周期约 10 个工作日

第三步：对公认证

• 在「认证服务能力 - 对公认证」页签完成对公认证

第四步：申请接口权限

9.4 抖音团购核销 — 技术对接流程

关键接口调用

1. 获取 Access Token

GET https://open.douyin.com/oauth/client_token/
    ?grant_type=client_credential
    &client_key={APPID}
    &client_secret={APP_SECRET}

2. 验券准备（查询券状态）

• 从用户出示的二维码 URL 中提取 encrypted_data 参数
• URL 格式：https://developer.toutiao.com/api/apps/trade/v2/share?encrypted_data=xxx

3. 确认核销

• 调用核销接口完成验券，接口需确保幂等性设计，避免重复核销

9.5 集成方案对比

9.6 小程序统一核销架构

建议采用统一核销网关设计，将美团和抖音的核销差异封装在后端，前端保持统一体验：

┌─────────────────────┐
│   微信小程序          │
│  (核销入口页面)       │  ← 统一 UI，用户无需感知平台差异
└──────────┬──────────┘
           │ 券码/扫码数据
┌──────────▼──────────┐
│   核销网关服务        │  ← 自动识别券码类型，路由到对应平台
│  (统一后端服务)       │
└──────────┬──────────┘
           │
    ┌──────┴──────┬──────────┐
    ▼             ▼          ▼
┌───────┐  ┌───────┐  ┌───────┐
│美团API │  │抖音API │  │其他平台│  ← 可扩展接入更多团购平台
└───────┘  └───────┘  └───────┘

核心功能模块

9.7 注意事项

美团侧

• 必须完成二级等保和防火墙采购才能上线（硬性要求）
• 建议通过第三方服务商接口降低接入成本（如已有服务商资质）
• 批量核销注意单次上限 50 张

抖音侧

• 需先入驻抖音来客，再创建开放平台应用（顺序不可颠倒）
• 苹果开发者账号必须注册，否则 iOS 用户无法看到核销入口
• 小程序内不允许上线外卖/配送能力，仅限到店核销

通用建议

• 两个平台核销流程差异较大，建议抽象统一核销模型（输入 → 查询 → 确认 → 结果）
• 务必做好幂等性控制，防止网络重试导致重复核销
• 建议先接入沙箱环境测试，再申请正式权限
• 核销记录需持久化存储，支持后续对账和争议处理

参考文档

• 美团技术服务合作中心：developer.meituan.com
• 抖音开放平台：open.douyin.com/platform/doc
• 抖音来客：life.douyin.com