《入门 · 约课经营》客户使用教程

0 · 这份教程讲什么

一句话：把课约得上、学员管得住、课时扣得清。

1 · 开始之前：账号与前置准备

1.1 平台方开通

1. 创建 / 确认机构。
2. 给机构挂上计划 SW-入门-年付（含活跃学员 / 教练配额与到期日）。
3. 下发模块授权：admin、finance（core、booking 为基础，无需授权）。

1.2 机构方准备

2 · 快速上手 5 步（Day 1）

1. 建教练账号
   机构 → 系统管理 → 教练与管理员 → 新建（可同时建店长 / 组长）。
2. 配可约时段
   机构 → 系统管理 → 时间段设置 → 新增或批量生成未来排课。
3. 建学员档案
   学员 → 学员管理 → 新增学员（姓名、用户名、技术等级、登录密码、分配教练）。
4. 建课包 + 给学员开卡
   财务 → 训练套餐 → 新建套餐；再到学员详情 → 计次权益 → 新增订阅。
5. 约第一节课并走完扣次
   学员 / 家长在课表预约 → 教练确认 → 课后「课后登记」→「确认扣课时」→「课次明细」看扣次。

3 · 预约与排课

3.1 设置教练可约时间段（先配时段，才能排课）

路径：机构 → 系统管理 → 时间段设置

• 单个新增：选日期、开始 / 结束时间、容量（名额）。
• 批量生成未来排课：设起始日期 + 生成周数 + 多组「星期 / 开始 / 结束」，一次生成多周。
• 复制到指定日期范围：编辑某时段 →「复制到…」→ 选起止日期，重复的自动跳过。

3.2 教练排课 / 学员预约

学员或家长自助预约

1. 课表 → 我的预约 → 预约。
2. 进入预约流程：步骤 1 选择预约类型 → 步骤 2 确认与提交 → 步骤 3 查看记录。
3. 提交后状态为「待确认」，等待教练确认。

教练代约 / 管理

• 入口：课表 → 预约管理。
• 可代学员创建预约、查看筛选、确认、拒绝、改期、推荐替代时间。
• 「教练邀请」：教练向学员发出上课邀请，学员端在「教练邀请」确认。

场地自练

• 学员 / 家长：/booking/self-practice
• 教练：预约管理里把教练下拉切到「场地自练」。
• 自练提交后通知走「组长主收、优先教练抄送、店长 / 管理员兜底」。

3.3 预约状态

3.4 课表底部功能分组

4 · 学员档案

入口：顶栏 / 底栏「学员」→ /StudentManagement

4.1 新增学员

• 路径：学员 → 学员管理 → 新增学员。
• 字段：学员姓名、用户名（可自动生成）、技术等级、登录密码（可改）、出生日期、惯用脚、分配管理教练（可多选）。

4.2 学员审批

• 学员微信自助注册后为体验用户，需机构审批才算正式学员。
• 入口：学员 → 学员管理 → 待审批列表，或「运营提醒 / 待办」聚合。
• 机构管理员只能审批本机构申请。

4.3 学员详情

路径：学员列表点进 → /students/:id。可看基本信息、编辑、分配教练、课包与余课；未购模块的区块会锁定。

4.4 教练与管理员账号

路径：机构 → 系统管理 → 教练与管理员。用于新建教练、店长、组长并设置角色与机构；数量受档位上限约束（教练 + 管理者合计）。

5 · 课包与扣次

入口：顶栏 / 底栏「财务」→ /finance

5.1 定义课包（训练套餐）

• 操作：新建 / 编辑 / 启用停用 / 删除 / 批量编辑。
• 关键字段：套餐名称、描述、价格、正式训练单元次数、场地自练权益次数（两池独立）、单次时长、有效期（天数 / 自然月 + 保底）、最晚开卡期限、提醒阈值。
• 系统自带套餐不可编辑；机构自建套餐可编辑删除。

5.2 给学员开卡（学员订阅）

• 路径：学员详情 → 计次权益 → 新增 / 购买订阅；或财务 → 订阅管理。
• 首次上课激活：首次扣次时自动开卡、写开始 / 到期日。
• 手动日期生效：直接指定开始与到期日。
• 状态：待开卡 / 使用中 / 已耗尽 / 已过期 / 已取消。
• 退费：「全额退费并关闭订阅」，未消耗计次剔除、剩余清零，保留已消耗历史。

5.3 课后扣次作业流（核心）

学员预约 → 教练确认 → 上课
  → ① 教练「课后登记」
  → ② 组长/管理员「确认扣课时」
  → ③ 全部人「课次明细」查扣次结果

复核状态：draft 待教练提交 → submitted 待组长复核 → approved 已复核 → 可结算；rejected 已退回（教练改后重提）。

5.4 代课 / 换教练

• 预约教练保留为历史预约意图。
• 实际授课教练在复核时改（课程级 / 学员级）。
• 支持同节课多教练带不同学员。

5.5 欠费管理

路径：财务 → 欠费管理。学员课时不足时产生欠费记录；新订阅支付完成后可自动清偿（支持部分清偿）。

5.6 计次消耗统计与对账单导出

• 路径：财务 → 计次消耗统计（旧深链 /reports/monthly-consumption 会重定向）。
• 筛选：统计周期（按月 / 自定义日期）、月份、教练、学员榜单数量。
• 核心 KPI：计次消耗、出席人次、完成训练单元数、平均班容量、新订阅数、到期订阅数、未到人数、学员取消数。
• 维度分析：套餐、教练、时段分布、学员计次榜。
• 财务数字需点「显示财务」才展示；导出时也只在「显示财务」状态下带上财务列。
• 导出：页面右上「导出数据」→ CSV。手机端在「更多」菜单里。

6 · 微信通知

入门档的微信通知 = 预约链路模板消息（发送链路归 booking，入门档已含）。

6.1 会发哪些通知

6.2 收得到通知的前提

1. 收件人已关注该微信公众号（服务号）；
2. 已绑定 openid；
3. 对应通知类型开关开启，且微信通知总开关开启（总闸是 AND）。

6.3 常见问题

6.4 通知开关的边界（重要）

「通知管理」页签属增强能力。入门档未含：该页签会隐藏，机构不能自助开关通知类型；通知默认开启、按业务事件发送。该能力暂未对外开放，目前所有档位都不能自助配置通知策略。

7 · 学员 / 家长侧速查

8 · 权限速查

线上以实际角色权限为准。

9 · 本档不含能力（避免误宣传）

10 · 常见问题（FAQ）

Q1 教练说没收到「新预约」通知

确认教练已关注公众号（服务号）并绑定微信；看「服务号消息」而不是「订阅消息」。仍无则平台侧查通知日志。

Q2 家长说没收到「预约已被确认 / 改期」

确认家长已建立家庭授权且开启接收通知；确认孩子微信已绑定。多家长各自独立，谁开了通知谁才收。

Q3 为什么课后扣次余额没变化？

检查课次是否满足最终扣费条件：completed 且 is_confirmed。只提交课后登记、未通过确认扣课时，不会扣。

Q4 能约课，但看不到课后扣次页签？

课后扣次归经营财务模块。入门档已含，应可见；若不可见，检查模块授权是否到期或未下发。

Q5 能不能自己关掉某种微信通知？

入门档不能。通知开关属增强能力，暂未对外开放，所有档位目前都不能自助配置；入门档通知默认开启、按事件发送。

Q6 能不能导出一份 PDF 账单发给家长？

平台只提供 CSV 导出。需要 PDF 或打印，请用 Excel / WPS 打开 CSV 后自行另存或打印。

Q7 学员忘记密码怎么办？

系统有「忘记密码 / 重置密码」流程；也可由管理员在学员管理里重置。

Q8 学员自己注册了，为什么看不到？

新注册是体验用户，需机构审批通过并分配机构后才进入正式学员列表。

Q9 为什么「进度看板 / 训练回顾」进不去？

这两项属进度与专题 / 训练与任务模块，入门档未含，会显示小锁；需要时升级「专业 · 训练成长」。

11 · 截图拍摄清单（交付时用）

建议统一 1440 宽、亮色模式、隐藏真实姓名。