快速入口

已上线微信小程序(微信打开):weixin://dl/business/?appid=wx3c0b6f4d7877b1f3&path=projects/workfit/pages/default/index/default_index&env_version=release (历史链接,若失效请更新)

二维码:
克莱尔搏击小程序二维码

一句话介绍

XxSportsHall 是一个从零开发并可交付的 WeChat Mini Program + CloudBase 项目,围绕拳馆/健身房的“购课 → 约课 → 核销 → 运营配置”构建三端合一的业务闭环。

解决什么

线下约课通常依赖微信聊天/表格,容易出现未付费占名额、排期冲突难追踪、核销与统计靠人工等问题。本项目把关键状态流转收敛到云函数侧:先购课获得课时/权益,再约课占名额并扣课时,最终由教练扫码/手动核销;管理端在小程序内完成课程、课程包、门店、教练、排期与运营物料配置,形成可上线可运营的交付形态。

代码结构以交付为导向:小程序端在 miniprogram/,云函数端集中在 cloudfunctions/mcloud(单入口 + 路由),需求/排期/发布清单等沉淀在 docs/。云函数入口会统一设置 TZ=Asia/Shanghai,并对支付回调、云调用支付回调与定时任务等系统事件做分流处理后再进入业务路由,避免“无 OPENID 场景”误入常规鉴权链路导致失败。

核心亮点

  • 三端合一:学员/教练/管理端同一小程序内按权限展示入口与页面
  • 业务强分离:先购课再约课,状态机集中在服务层避免页面分散逻辑
  • 后端单入口:云函数 cloudfunctions/mcloud 通过 route 路由分发,Controller/Service/Model 分层
  • 关键链路闭环:支付→权益生成→预约扣课时→核销→统计/运营配置