BP健身铁馆产品系统

一、行业背景
国内健身行业正从「前台办卡、人工值守」走向「多门店连锁、自助入店、按次/按时计费」。传统健身房普遍存在系统割裂：会员资料在 Excel、收银在 POS、团购核销靠人工、门禁与计费各管各的。连锁品牌尤其面临多店会员不通、充值规则不统一、无人值守难落地、营销与品牌表达弱等问题。同时，美团/抖音团购、企业团建年卡、私教预约等新业态，要求门店具备完整的线上会员运营与 IoT 设备联动能力。

二、行业场景
本项目面向连锁健身馆 / 铁馆 / 24 小时自助健身房，典型场景包括：

会员小程序选店、充值（余额/会员卡/私教卡）、微信支付、欠费补缴
人脸录入 + 闸机进出场，按分钟或套餐自动计费
团购券在线核销并自动发卡
企业客户批量购卡、成员管理
总部运营后台：门店、会员、设备、门禁异常、账单与品牌内容配置
三、立项原因
BP GYM 在多门店扩张过程中，原有方式已无法支撑：入场结算依赖人工、充值与门禁未打通、团购核销效率低、异常刷闸难管控、品牌形象缺少统一线上阵地。为降低运营成本、提升用户体验、支撑规模化复制，需建设一套「会员端 + 运营端 + 设备端」一体化的数字化平台。

四、解决的核心产品问题
会员全链路线上化：注册、充值、支付、卡券、记录查询统一在小程序完成。
无人值守闭环：人脸识别 → 闸机通行 → 自动计费 → 钱包扣费/欠费提醒 → 补缴恢复权限。
多店与多业态统一：计时计费、会员卡、私教课、企业年卡、第三方团购核销同一套账户与订单体系。
运营风控与效率：门禁异常刷闸监测、支付金额服务端校验、后台可视化看板与配置化运营。
品牌与留存：品牌中心 Tab 集中展示品牌故事与内容信息流，强化用户心智与复购。

一、会员小程序端
1. 健身首页
展示当前门店信息、健身卡套餐、教练列表；支持切换门店、团购验券发卡、购买私教课及企业年卡入口。

2. 账户与充值
支持余额充值、会员卡、私教卡等多种套餐；对接微信支付；欠费自动提醒与在线补缴。

3. 支付中心
统一创建支付单、提交支付、查询状态，服务端校验金额，防止篡改。

4. 人脸与入店
会员人脸录入，配合闸机实现刷脸进出场。

5. 团购核销
对接美团/抖音等平台团购券，验券后自动发放对应健身卡或权益。

6. 品牌中心
品牌介绍、品牌故事专题（竖向滑动）、品牌信息流（三列内容流），强化品牌传播。

7. 个人中心
会员资料、钱包余额、健身/充值记录、角色切换、消息设置等。

二、运营管理后台
1. 会员管理
会员档案、余额/积分/私教次数、会员卡有效期、充值与退款。

2. 门店与套餐
多门店配置、充值套餐（计时卡/会员卡/私教卡）、限购与门店分组。

3. 教练与约课
教练信息、排课、预约记录管理。

4. 企业年卡
企业套餐、申请审核、成员绑定、使用记录。

5. 设备与门禁
闸机设备、人脸检索日志、门禁异常刷闸监测与黑名单。

6. 计费结算
按分钟/规则自动计费，进出场账单、消费记录查询。

7. 支付管理
支付应用、渠道、订单、退款、钱包流水。

8. 品牌内容管理
品牌介绍区、故事专题模块、信息流内容的创建、排序与发布。

9. 数据看板
会员、设备、收入、课程等核心经营指标展示。

三、设备与系统能力
1. 闸机回调
接收第三方门禁回调，联动计费、权限与异常检测。
2. 多租户
支持多门店/多租户隔离。
3. 权限与安全
角色权限、支付校验、门禁异常隔离，保障主流程稳定。

一、负责的具体任务
本项目从 0 到 1 建设连锁健身馆数字化体系，主要交付包括：

后端：会员账户与钱包、充值套餐与订单、微信支付与退款、按分钟/规则自动计费、闸机回调与人脸通行、团购验券发卡、企业年卡、教练约课、门禁异常监测、品牌中心内容管理、运营后台权限与多租户等模块的设计与开发。

小程序端：健身首页、多店切换、充值支付、人脸录入、验券入卡、品牌中心、个人中心及记录查询等页面联调上线。

管理端：会员/门店/套餐/设备/账单/品牌内容等运营配置界面，以及经营数据看板。

联调与落地：对接微信支付、第三方门禁 WO 回调、阿里云人脸检索、美团/抖音核销等外部能力，并完成多门店试点部署与问题修复。

二、技术栈与架构
整体架构采用前后端分离、模块化单体：

后端：Java 17 + Spring Boot 3.5，基于芋道（Ruoyi-Vue-Pro）扩展；按业务拆分为 system、member、pay、device、coach、commission 等 Maven 模块；MyBatis-Plus + MySQL 持久化，Redis 缓存，RESTful API 对外服务。
管理端：Vue 3 + Vite + TypeScript + Element Plus，动态菜单与 RBAC 权限。
小程序：UniApp + Vue 3 + wot-design-uni，编译为微信小程序；自定义 TabBar，分包加载优化体验。
部署形态：yudao-server 统一网关式启动，小程序与管理端分别独立构建发布。
三、实现亮点
1. 门禁—计费—会员一体化闭环
闸机刷脸回调触发进出场识别，联动计费引擎与钱包扣费；异常刷闸监测与主流程隔离，检测失败不影响正常通行与结算，保障无人值守场景稳定运行。

2. 多端统一支付与风控
充值下单服务端校验应付金额，支付回调校验订单状态与金额