v1.5 · 2026-11-15 · 已通过全链路回归
运动工作室 预约系统
运动工作室 预约系统
功能总览
微信小程序 + PHP 单入口后端 + MySQL 5.7。课程与场地预约、微信支付、到店核销、优惠券、会员卡,全部走真实数据与真实金额。
交付物构成
两个压缩包,一个演示页,各管一段。
| 文件 | 装什么 | 说明 |
|---|---|---|
| sports-space-backend.zip | 后端程序 | 解压后整个内容上传到网站根目录,访问 域名/install 填数据库信息即装完;自带 15 张表与演示数据。 |
| sports-space-frontend.zip | 小程序端 | miniprogram/ 用微信开发者工具打开;demo/index.html 是双击就能点的界面演示,11 个页面可交互。 |
| 功能介绍.html | 本页 | 功能清单、接口、数据表、部署步骤,可直接打印成文档。 |
| README.md | 说明书 | 两个包里各带一份,含数据库字段、接口参数、常见问题排查。 |
不用框架、不用 composer。 后端只有 7 个 PHP 文件,单入口路由;PHP 8.0 开箱即跑,Nginx 配置模板已放在包里。
小程序端 · 13 个页面
底部四个主 tab(首页 / 约课 / 订场 / 我的),其余从页面内跳转。
| 页面 | 路径 | 核心功能 | 状态 |
|---|---|---|---|
| 首页 | pages/index |
问候语与头像、14 天日期条、主推课程 banner、五个分类筛选、今日课程、为你推荐、顶部搜索入口、下拉刷新、分享 | 已完成 |
| 约课 | pages/course |
日期切换 + 瑜伽 / 普拉提 / 私教 / 小团课 / HIIT 分类,双列课程卡(评分、教练、时长、会员价),骨架屏 | 已完成 |
| 订场 | pages/court |
羽毛球 / 网球 / 篮球筛选,场地卡显示评分、楼层距离、今日空闲时段,下拉刷新 | 已完成 |
| 课程 / 场地详情 | pages/detail |
两种类型共用:封面大图、评分与标签、教练卡、日期 + 时段网格、会员价与划线原价、右上角收藏、评价区与全部评价、退改规则、确认弹层选券、拉起支付 | 已完成 |
| 搜索 | pages/search |
输入防抖 350ms,课程与场地双路搜索分组展示,空关键词给 5 个热门词,无结果给引导 | 已完成 |
| 我的订单 | pages/orders |
全部 / 待使用 / 已完成 / 已取消四档,订单卡带券抵扣角标;待支付给「取消 / 去支付」,待使用给「出示核销码」;下拉刷新 | 已完成 |
| 订单详情 | pages/order |
状态头、核销码条形码(仅在可核销时出现)、商品金额 / 券抵扣 / 实付三行、订单号、支付与核销时间、底部取消 / 去支付 / 联系门店 | 已完成 |
| 我的 | pages/profile |
头像昵称(可改)、余额 / 积分 / 次卡 / 课次四项统计、手机号一键授权(失败自动转手动输入)、出勤日历按订单日期标点、收藏区、优惠券 / 订单 / 核销入口 | 已完成 |
| 会员 | pages/membership |
顶部黑色会员状态卡(次卡 / 课时 / 余额 / 有效期)、四项权益、新人体验课、套餐列表(标注「含 30 天会员身份」等到账内容)、优惠券领取 | 已完成 |
| 优惠券 | pages/coupons |
「我的券 / 可领取」双 tab,显示面额、门槛、有效期、使用状态,领过的置灰 | 已完成 |
| 收藏 | pages/favorites |
收藏课程列表、取消收藏、空态引导去约课 | 已完成 |
| 核销码 | pages/checkin |
待核销项目可切换,竖向条形码 + 核销码数字,有效期按该时段结束时间算(不是写死 22:00),已核销的置灰 | 已完成 |
| 联系客服 | pages/service |
微信客服(open-type="contact")、一键拨号、门店地址地图导航、入馆须知、常见问题折叠 |
已完成 |
| 体验细节 | 做法 |
|---|---|
| 导航 | 自绘悬浮胶囊 custom-tab-bar,选中项背景变荧光绿并展开文字 |
| 加载态 | 首页 / 约课 / 订场 / 订单 / 详情 / 搜索用灰条骨架屏,不用转圈 |
| 登录失效 | 接口返回 401 时自动重登并重放原请求,只失败一次才提示 |
| 分享 | 所有主页面支持转发好友与朋友圈 |
| 需要先开通 | 不开通的表现 |
|---|---|
| 手机号授权 | 点授权失败,自动弹手动输入 11 位手机号 |
| 订阅消息模板 | 下单时不弹订阅框,支付流程不受影响 |
| 微信客服 | 按钮点了没反应,电话与地址仍可用 |
交易链路
从选时段到核销完成,中间每一步都有落库动作。
1
选时段详情页拉当天排期,满员时段灰掉2
确认弹层里选券,实时算抵扣与实付3
下单行锁校验容量,写单锁券,生成核销码4
支付微信 / 模拟 / 到店付5
到账回调改状态,会员卡发货、加积分6
核销后台输码或扫码,写核销时间与操作人7
退款后台一键退,券自动退回账户| 环节 | 落库动作 |
|---|---|
| 下单 | 写 orders(原价、抵扣、实付、券 ID、核销码);schedule.booked +1 或 court_slot.status = 1;member_coupon 置为已使用并绑定订单 |
| 支付成功 | 写 pay_log,pay_status = 1;会员卡类订单触发发货:加次卡 / 课时 / 余额 / 会员天数;课程与场地按实付金额加积分 |
| 取消 / 超时 | 释放名额,券退回未使用,订单置关闭 |
| 核销 | 写 verified_at 与 verify_by,订单转已完成;重复核销不重复扣,返回首次核销时间 |
| 退款 | 调微信退款或直接标记,写退款单号与时间;会员卡订单不退名额,券退回 |
业务规则
这些是代码里写死的判定,后台改不了,要改得动代码。
| 规则 | 具体判定 | 位置 |
|---|---|---|
| 课程容量 | 场次已约人数达到容量即不可下单,详情页该时段变灰 | PublicApi::createOrder |
| 场地时段 | 同一场地同一时段只能有一单,SELECT … FOR UPDATE 行锁防止并发超卖 | createOrder |
| 取消时限 | 开课前 / 开场前 2 小时可自助取消,之后只能联系门店 | cancelOrder |
| 超时关闭 | 下单 15 分钟未支付自动关闭并释放名额,下次进订单页时触发 | releaseExpired |
| 已支付订单 | 小程序端不能自助取消,只能后台退款 | cancelOrder |
| 优惠券 | 一人一张不可重复领;下单校验门槛,不足直接拒绝;下单时锁券,取消或退款自动退回 | claimCoupon / createOrder |
| 会员价 | is_member = 1 且 member_expire ≥ 今天 才按会员价结算,详情页同步显示会员价与划线原价 | courseDetail / createOrder |
| 核销条件 | 已支付 + 待使用 + 有核销码 + 未核销;会员卡订单不参与核销;已退款不能核销 | AdminApi::verify |
| 核销码 | YD + 年月日 + 4 位随机,生成时查重,冲突重试 8 次 | newCode |
| 订单状态 | 1 待使用 / 2 已完成 / 3 已取消 / 4 已退款;支付状态 0 待支付 / 1 已支付 / 2 已退款 / 3 已关闭 | orders 表注释 |
管理后台 · 13 个模块
纯静态页面 + 接口,跟小程序共用一套 PHP。带 ?demo=1 可在浏览器里空跑,账号密码随便填。
| 模块 | 能做什么 |
|---|---|
| 概览 | 今日订单数、今日营收、今日核销、待核销、7 天趋势柱状图、最新订单 |
| 课程 | 增删改查,含分类、教练、价格、会员价、体验价、标签、简介、热度 |
| 课程场次 | 按课程 + 日期排期,设置开始 / 结束时间、容量、已约人数、开关状态 |
| 场地 | 名称、类型、封面、楼层、距离、评分、单价、排序 |
| 场地时段 | 按场地 + 日期 + 整点生成可订时段,可手动关闭某个时段 |
| 教练 | 姓名、头像、头衔、简介 |
| 会员套餐 | 价格与划线价、有效期文案、适用范围;购买后到账的次卡 / 课时 / 余额 / 会员天数 |
| 优惠券 | 面额、使用门槛、发放总量、有效期文案、启停 |
| 订单 | 按状态筛选、搜单号、看支付单号与时间、一键退款、改状态、条件显示「核销」按钮 |
| 到店核销 | 大输入框输入或扫码,回车即核销;成功卡显示项目与核销时间;下方最近 20 条核销记录 |
| 会员 | 微信用户列表、手机号、余额、积分、次卡、课时、会员状态 |
| 系统设置 | 站点名称、公告、客服电话与微信、门店地址与经纬度、退改规则、入馆须知、AppID / Secret、改密码 |
| 支付设置 | 三种收款模式切换、商户号与 APIv3 密钥、证书上传或粘贴、异步通知地址 |
接口清单
前台 25 条走 /api/*,用 Bearer token;后台走 /api/admin/*,用会话 cookie。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/settings | 站点信息、公告、客服、门店经纬度、退改规则、支付模式 |
| GET | /api/home | 首页聚合:分类、主推、今日课程、推荐 |
| POST | /api/auth/login | 微信登录,返回 token 与会员信息,带 need_phone 标记 |
| POST | /api/auth/phone | 绑定手机号(授权 code 或明文手机号) |
| POST | /api/auth/profile | 修改昵称 |
| GET | /api/courses | 课程列表,支持 category day kw |
| GET | /api/courts | 场地列表,支持 type day |
| GET | /api/search | 课程 + 场地双路搜索,空关键词返回热门词 |
| GET | /api/detail | ?id=1&type=course|court&date=,含时段、收藏态、评价、退改规则、会员价 |
| GET | /api/reviews | 某课程全部评价 |
| POST | /api/favorite | 收藏 / 取消收藏(同一接口切换) |
| GET | /api/favorites | 我的收藏 |
| GET | /api/coupons | 我的券 / 可领取 / 按金额过滤的下单可用券 |
| POST | /api/coupons/{id}/claim | 领取优惠券,重复领取会被拒 |
| GET | /api/orders | 我的订单,含支付模式,会顺带触发超时关闭 |
| POST | /api/orders | 下单:type item_id date slot coupon_id;type=package 买会员卡 |
| GET | /api/orders/{id} | 单条订单,微信模式下会主动查单补状态 |
| POST | /api/orders/{id}/pay | 待支付订单重新拉起支付 |
| POST | /api/orders/{id}/cancel | 取消订单,未支付的会释放名额并退券 |
| POST | /api/pay/mock | 模拟支付,仅 mock 模式可用 |
| POST | /api/pay/notify | 微信支付回调,验签 + 解密后改单 |
| GET | /api/profile | 个人信息、四项统计、最近订单、收藏、可用券数、公告 |
| GET | /api/membership | 权益、我的会员状态、套餐(含到账内容)、优惠券 |
| GET | /api/checkin | 待核销项目与核销码、有效期 |
| GET | /api/service | 客服方式、常见问题、门店地址 |
后台接口
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/admin/login | 账号密码登录,写会话 |
| GET | /api/admin/me | 当前登录管理员 |
| GET | /api/admin/stats | 营收、订单、今日核销、待核销、7 天趋势 |
| GET/POST/PUT/DELETE | /api/admin/{资源} | course / schedule / court / court_slot / coach / package / coupon / member / orders 通用增删改查,支持分页与字段筛选 |
| POST | /api/admin/verify | 按核销码核销 |
| POST | /api/admin/orders/{id}/verify | 按订单 ID 核销 |
| POST | /api/admin/orders/{id}/refund | 退款,微信模式调退款接口,模拟模式直接标记 |
| POST | /api/admin/password | 改管理员密码 |
| POST | /api/admin/cert | 上传或粘贴支付证书 |
数据表 · 15 张
InnoDB / utf8mb4,安装时自动建表并播种演示数据,重复安装不会重复插入。
| 表 | 作用 | 关键字段 |
|---|---|---|
setting | 站点配置,键值对 | k / v |
admin | 管理员账号 | username / password |
member | 会员,微信身份与卡包 | openid / phone / cards / lessons / member_expire |
coach | 教练 | name / avatar / title |
course | 课程 | price / member_price / trial_price / coach_id |
schedule | 课程场次与容量 | date / start_time / capacity / booked |
court | 场地 | type / price / floor / distance |
court_slot | 场地时段 | date / hour / status |
package | 会员套餐与到账规则 | add_cards / add_lessons / add_balance / member_days |
coupon | 券模板 | amount / min_amount / total |
member_coupon | 券实例(谁的、用没用) | member_id / coupon_id / status / order_id |
favorite | 收藏关系 | member_id / course_id |
review | 课程评价 | course_id / rating / content |
orders | 订单主表 | origin_amount / discount / code / verified_at / pay_status |
pay_log | 支付与发货日志 | order_id / action / detail |
支付三种模式
后台「支付设置」里切换,代码里是白名单,填错自动回落模拟模式,不会把站搞挂。
| 模式 | 跑起来需要 | 表现 |
|---|---|---|
| wechat 正式收款 |
小程序 AppID / Secret、商户号、APIv3 密钥、商户证书、异步通知地址 | JSAPI 下单拿 prepay_id,前端二次签名拉起微信支付;回调验签解密后改单;退款走 V3 退款接口 |
| mock 默认 |
什么都不用配 | 点支付即成功,写 MOCK 开头支付单号。适合演示、验收、内部培训 |
| off 到店付 |
什么都不用配 | 下单后直接算已支付,订单备注 OFF。适合线下扫码付款的门店 |
切正式收款前先小额测一单。 证书、密钥、通知地址任一不对,表现都是「点了没反应」或「支付成功但订单还是待支付」,后台「支付设置」里有查询按钮可以先确认配置读到了。
部署步骤
后端 4 步,小程序 5 步。
| 后端(PHP 8.0 + MySQL 5.7 + Nginx) | |
|---|---|
| 1 | 解压 sports-space-backend.zip,把里面的文件全部传到网站根目录 |
| 2 | 确认 config/ 与 uploads/ 可写(755 / www 用户) |
| 3 | 浏览器打开 https://你的域名/install,填数据库与管理员账号密码,点安装 |
| 4 | 装完自动跳后台,先在「系统设置」填门店信息与 AppID / Secret |
| 小程序 | |
|---|---|
| 1 | 微信开发者工具打开 miniprogram/ 目录,填自己的 AppID |
| 2 | 改 utils/api.js 里的 baseUrl 为你的域名 |
| 3 | 小程序后台 → 开发管理 → 服务器域名,把域名加进 request 合法域名 |
| 4 | 后台填好 AppID / Secret 后重新登录一次,才能拿到真实 openid |
| 5 | 上传代码 → 提交审核 → 发布 |
没填 AppID / Secret 也能跑:走体验登录,用设备标识当身份,功能全可用,只是拉不起真实微信支付。本地调试和演示用这个最省事。
上线前要配的 6 件事
代码已经留好口子,缺的是资质和配置。
| 项目 | 在哪配 | 不配的后果 |
|---|---|---|
| 小程序 AppID / Secret | 后台「系统设置」 | 只能体验登录,真实用户进不来、支付拉不起 |
| 服务器域名白名单 | 微信公众平台 → 开发设置 | 真机上所有接口请求被拦 |
| 支付商户号与证书 | 后台「支付设置」 | 只能走模拟支付或到店付 |
| 订阅消息模板 ID | 小程序后台申请后填进 app.js 的 tmplNotice | 不弹订阅框,开课提醒发不出去 |
| 微信客服 | 小程序后台 → 客服 → 绑定客服人员 | 「在线客服」按钮点了无反应 |
| 手机号快速验证 | 需企业主体并开通该能力 | 授权失败,退回手动输入手机号 |
合规提醒: 预约类小程序若涉及预付卡(次卡、储值),部分地区要求单用途预付卡备案;会员储值金额与有效期建议在页面明示,退款规则写清楚,别用「最终解释权」这种表述。










产品规格与交付说明
✓全开源前端源码
✓全开源后端源码
✓数据库脚本
✓部署与二开文档
| 技术栈 | Nginx PHP8.0 Mysql5.7 |
|---|---|
| 交付方式 | 支付成功后自动发放下载凭证 |
| 授权范围 | 源码无授权、0加密、无域名锁、支持商业运营、支持转售 |
| 部署环境 | Nginx + PHP 8.0 + MySQL 5.7(以商品实际要求为准) |
购买常见问题
支持,代码无加密、无域名授权锁。
Nginx + PHP 8.0 + MySQL 5.7
支持,本站全部源码均支持商用!
购买后不支持退款,源码为全开源源码,有问题可以联系我们修复!
服务保障
✓
正版授权
源码具备合法授权,可商用可二开
⌘
部署答疑
环境问题协助排查,提供部署文档
◈
版本修复
版本内缺陷修复,长期二开可选
☁
私有化交付
源码与数据全部落在自有服务器
用户评价(0)
该商品暂无公开评价,购买完成并交易后即可评价。