器械扫码教学系统

器械管理

动作管理

每个动作属于一个器械;建好后再到「分类管理」里把动作加进分类

分类管理

分类由你自己创建,再把动作加进分类;每个分类可生成二维码贴在训练区域

课程管理

设置课程名称 / 周期 / 简介,把周期里的每一天设为「健身日」或「休息日」,健身日再添加当天的动作。会员在用户端把课程加入行程后,日历会按天展示并可直接跟练

📦 备课打包(课程包)

把会员专享课程预先打包成「第 1 组 / 第 2 组」……教练扫会员码时可以整包赠送,包内所有课程一次全部解锁,无需当场挑选

教练管理

维护教练档案(头像 / 姓名 / 擅长领域 / 简介),再到「动作管理」里给每个动作选择拍摄教练;用户端动作页和课程页会展示教练信息

用户管理

会员用手机号或微信登录后都会出现在这里

用户联系方式注册 / 最近登录使用情况操作
还没有用户登录

私教排课

会员提交的排课申请在这里审核。开课时由教练点「开始上课」并出示扣课二维码,会员本人扫码确认后才扣 1 节课时;没来由教练点「未到」,不扣课时。私教会员(有效期 / 课时)在「用户管理」里设置

上课时间会员教练时段状态留言 / 回复操作
暂无排课记录

会员 · 至尊会员

套餐定价、会员名单、兑换码;教练给会员扫会员码也能当场开通。会员可看全部会员动作、会员课程与商城会员价。

会员套餐

价格填「元」,支持两位小数;划线价留空不显示。会员续费时从原到期日往后叠加,不会覆盖剩余天数。

在期会员

生成兑换码

兑换码记录

给会员开通 / 续费

让会员打开「我的 → 我的会员码」,把二维码内容(形如 12.abcdef…)复制过来;教练端用摄像头扫也行。开通后立即生效。

赠送会员动作

把单个「会员专属动作」单独开给某位会员,不用开整张会员卡。到期自动回收;重复赠送会从原到期日往后叠加。

赠送记录

商城

上架蛋白粉、手套、次卡等商品。配送一律「到付」;自提会生成 6 位自提码,教练扫码或输码核销。

订单

自提核销

输入会员出示的 6 位自提码(教练端也能扫码核销),核销后订单变成「已完成」。

短信通知

私教课的每个节点自动发短信:会员提交预约 / 改签 / 解除 → 通知教练;审核结果、上课前 → 通知会员。模板正文直接照抄到阿里云短信控制台提交审核,审核通过后把「模板 CODE」填回来就生效

1阿里云建模板(右边 8 条正文照抄) 2模板审核通过 → 把 CODE 填进卡片 3打开总开关 → 填签名 4发一条测试短信验证
正在读取发送统计…

① 开关与通道

不打开开关,一条业务短信都不会发(不影响系统其它功能)

正在读取通道状态…

⚠️ 阿里云短信签名必须和「模板所属签名」一致;签名、模板都要审核通过才能发。同一个阿里云账号下,建议直接复用登录短信的签名,留空即可。

② 上课前提醒

开课前 N 分钟给会员发一条提醒短信(每条课只发一次)

分钟

提醒靠「定时任务」触发。把下面这条地址填进宝塔「计划任务」(类型选「访问URL」,周期 10 分钟),或者服务器 crontab 每 10 分钟 curl 一次,就会自动发:

—

没有配定时任务也不会报错,只是不会自动发课前提醒;后台点「立即跑一次」可以手动补发。

③ 短信模板清单(8 条)

阿里云:国内消息 → 模板管理 → 添加模板(类型选「通知短信」),正文直接粘贴(含 ${变量});审核通过后把模板 CODE 填进对应卡片,留空表示这个事件不发短信

填好手机号后,点每条模板卡片上的「发测试」就能收到按模板正文拼好的短信

④ 发送记录

最近 50 条,发送失败或「未发送」都会写清原因(如教练没填手机号、模板 CODE 没填);上面的累计数字永久保留,清日志也不会归零

时间接收方事件模板结果
还没有发送记录

用户反馈

系统设置

场馆信息会显示在会员扫码页;登录方式决定会员怎么进入「我的」

🔒 密钥只写不可查看 短信 / 微信 / OSS / 一键登录的 Secret 保存后不再回显,任何人(包括管理员)都无法查看。修改无需密码:直接输入新 Secret 保存即可覆盖,留空则保持原值。

场馆信息

会员打开扫码页第一眼看到的内容

手机号验证码登录(阿里云短信)

会员用手机号 + 验证码登录,训练记录自动认人

前提:① 阿里云已开通「短信服务」并充值;② 签名和模板都审核通过; ③ 模板内容里必须有 ${code} 变量(如:您的验证码是 ${code},5 分钟内有效)。

微信网页授权登录

会员在微信里打开扫码页,点一下就能用微信身份登录

微信公众平台还要配 3 个地方(否则会报 redirect_uri 错误)
  1. 「设置与开发 → 账号设置 → 功能设置 → 网页授权域名」填:—
  2. 同一页面的「JS 接口安全域名」也填同一个域名
  3. 用户端必须是 https,且是已认证的服务号(订阅号不支持网页授权)

授权回调地址:—

阿里云 OSS 对象存储

视频/图片传到 OSS,会员从 OSS 或 CDN 直接播放——不占服务器带宽,打开更快

正在读取服务器上的实际生效状态…

Bucket 在哪个地域就选哪个,选错会报「must be addressed using the specified endpoint」。在哪看:阿里云控制台 → OSS → Bucket 列表 → 该 Bucket 的「地域」列(如 华北2(北京))。

⚠️ 这里不要填 oss-cn-beijing.aliyuncs.com(那是上面的「地域」,填这里会导致视频读不出来,报 SecondLevelDomainForbidden)。没有自己的加速域名就留空,系统会自动用 Bucket 的默认域名。

开通步骤见管理端包里的 阿里云OSS配置教程.md:建 Bucket → 建 RAM 子账号 → 填这四项 → 上传测试 → 绑 CDN 域名。

「📱 学员端播放自检」:拿库里最近上传的视频,按学员端的方式生成地址并实测能否播放——后台测试通过但手机放不出来时,点这个。本地存储的视频会直接查服务器磁盘上文件在不在。

本机号码一键登录(阿里云号码认证 · H5)

会员用手机流量网络时,点一下就用自己的手机号登录,不用再收验证码

会员登录页会出现「本机号码一键登录」按钮(SDK 会弹出运营商授权页,会员补填手机号中间 4 位并同意协议后才算登录成功,合规且有防错保护)。只在手机流量网络下生效——连 WiFi 的会员看不到成功授权,会自动退回验证码登录,所以短信验证码登录仍需保留开启。

前提:① 阿里云已开通「号码认证服务」并创建 H5 一键登录 认证方案; ② 方案里填的「页面地址 / 源地址」要和真实访问域名一致(留空则自动取用户端站点地址); ③ RAM 子账号要有 dypns:GetAuthToken 和 dypns:GetPhoneWithToken 权限。

🧩 功能模块

不需要排课、暂时不卖货,都可以整块关掉;会员端与教练端对应入口会一起隐藏。

关掉「绑定手机号」后,会员端「我的」里不再出现绑定入口,接口层也会拒绝绑定请求;关掉「手机号登录」后登录页只剩微信登录(一键登录同时失效)。

🔐 登录方式

决定会员能用什么方式进入「我的」;关掉就彻底不显示,无法绕过

登录页只显示这里打开的方式:三种全开显示三个标签、开两个显示两个、只开一个就不显示标签直接进入对应面板(始终保证至少一种可登录)。账号密码无需配置短信或微信凭证,打开就能用;密码加密保存,后台不可查看。

👑 会员专属能力

关掉某一项 = 所有人都能用;打开 = 只有会员能用(非会员看到「开通会员」提示)

🎫 会员资料与客服

会员称呼、权益文案、联系教练,以及「联系系统客服」弹窗里的说明

会员绑定了私教教练时优先显示自己的教练;没绑定就显示这里的教练。教练二维码在「教练管理 → 编辑」里上传。

🔒「联系系统客服」的跳转地址已内置在程序里,不支持修改(避免被改成别的客服页)。这里只调整弹窗里给会员看的说明文字。

📅 私教排课规则

会员改签 / 取消的截止时间与超时策略,设置后会员端「私教会员管理」立即生效

例:填 2 表示开课前 2 小时内不能免费改签 / 取消。填 0 表示任何时候都可以免费改签 / 取消。

仅「允许取消但扣课时」策略生效。扣掉的课时会计入会员的「已用课时」。

🧾 日志抓取(排查问题)

遇到「点了没反应 / 提示报错」时:点「开始抓取」→ 把出问题的操作重做一遍 → 点「结束」,再下载日志文件。用户端也能抓:让会员在「隐私条款 → 抓取日志」里结束,把 6 位数字报给你,在这里输入后导出。

未开始 下载 .log

抓取内容:接口报错、页面 JS 报错、关键操作、构建号与浏览器环境(手机号自动打码)。日志只保留 7 天。

会员端登录方式:「手机号验证码」「微信网页授权」和(可选的)「本机号码一键登录」。昵称不再作为登录方式:训练记录一律按会员 UID 归属,改昵称不会丢记录。

🔐

部署授权

系统尚未完成部署授权。请把下面的识别码和服务器信息发给软件提供方,获取验证码后填入即可激活。

站点识别码 --------

验证码 10 分钟内有效。激活成功后本页自动消失,无需重新登录。