入门 · 约课经营

平台方开通（3 步）

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

机构方准备

① 先配时段，才能排课

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

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

【截图位 S3】批量生成弹出窗，标注「起始日期 / 生成周数 / 添加时间段」

② 学员或家长自助预约

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

【截图位 S4】预约三步：步骤 1 选类型 → 步骤 2 确认 → 步骤 3 记录

③ 教练代约 / 管理

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

④ 场地自练

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

⑤ 预约状态

⑥ 课表底部功能分组

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

新增学员

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

【截图位 S5】新增学员表单，标注 7 个字段 + 分配教练多选

学员审批

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

【截图位 S6】学员审批列表：待审批 + 批准 / 拒绝按钮

学员详情

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

教练与管理员账号

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

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

① 定义课包（训练套餐）

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

【截图位 S7】训练套餐列表，标注「新建套餐 / 批量编辑」

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

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

③ 课后扣次作业流

完整链路与「最终扣费条件」见上方 核心链路。

④ 代课 / 换教练

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

⑤ 欠费管理

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

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

【截图位 S9】计次消耗统计页：标注筛选区 + 「导出数据」按钮

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

会发哪些通知

收得到通知的前提

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

收不到怎么排查

通知开关的边界（重要）

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Q7 学员忘记密码怎么办？

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

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

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

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

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