8 分校统一系统：报名意向 → 试听 → 注册 → 排课点名 / 补课 → 出勤评语 → 收费收据 → 库存 → 转班 → 学期评估报告。已并入 2026-11-02 五项决策。
| 议题 | 决定 | 落点 |
|---|---|---|
| 转化口径 | 已定 以首次缴费完成（payment_status 首次变为 Paid）为准，不是 Active 状态。Active 但未缴费者单列「待缴费」群体。 | §06 / F-13 / §15 |
| 转班审批 | 已定 要双方 Admin 会签（原分校 + 目标分校），再由 Principal 终审。 | §02 / F-22 / §11 |
| 已缴费用归属 | 已定 学生若在 A 分校上了 5 节课后转班，本学期已缴费用与已开收据永久留在 A 分校，不转移、不退、不自动分账；新分校自下一学期起才计费。系统只在转班通过时发一条结算提醒通知（提醒相关分校向原分校确认结算），不改账单金额。 | F-22 / §10 / §11 |
| 评语审批代理人 | 已定 可设代理人：Principal 可指定代理人并设有效期，代理期间拥有评语 / 评估报告 / 转班审批权，审批记录须标注「代 Principal〈姓名〉审批」并留痕。仍不设超时自动通过。 | F-25 / §02 / §07 / §12 / §14 |
| 收据合规栏位 | 已定 收据需含 SST 注册号 / 税号 / 公司注册号（具体数值与抬头由甲方提供）。 | F-20 / §10.3 / §16 |
为 Talent Sparkz 口才培训中心（全马 8 分校）打造一套统一的运营管理系统：家长端 App + 老师端 + 分校 Admin 后台 + 院长看板 + 一个无需下载 App 的报名意向网页，覆盖从招生线索到学期评估报告的完整闭环。
| 角色 | 数据可见范围 | 核心职责 |
|---|---|---|
| 家长 主要用户 | 仅自己子女（跨分校也可见） | 填报名表、看课表/出勤/评语、选补课、看账单收据、申请转班、收通知 |
| 老师 内部用户 | 自己任教的班级 | 点名、写周出勤备注、课程进度与评语（署名留存）、学期评估报告 |
| Admin 分校行政 运营后台 | 仅所属分校 | 线索跟进、排课、补课审批、收费录入、库存发放与补货、转班发起与会签 |
| Principal 院长 审批 + 全局 | 全部 8 分校 | 看数据看板、审批评语/评估报告/转班、查看全部分校待付款、指定审批代理人 |
强烈建议做成一个统一的「审批队列」，而不是三套独立流程，开发量与维护成本都最低。
| 事项 | 发起 | 审批人 | 通过后动作 |
|---|---|---|---|
| 学生评语推给家长（好/坏评语） | 老师 | Principal（可由 F-25 代理人代批） | 写入学生档案 + 推送家长 App |
| 学期评估报告推给家长 | 老师 | Principal（可由代理人代批） | 报告存档 + 推送家长 App |
| 转班（跨分校） | 家长 / Admin | 原分校 Admin + 目标分校 Admin 会签 → Principal 终审（已定） | 迁移分校与课表 + 结算提醒通知 + 通知双方分校及家长 |
| 补课申请 | 家长 | Admin | 占用时段名额 + 通知家长 |
| 试听确认 | Admin | — | WhatsApp 联系家长、更新状态 |
每条学生记录除主状态外，还有 4 个独立维度：
| 维度 | 取值 | 说明 |
|---|---|---|
status 主状态 | Pending / Trial Scheduled / Trial Done / Active | 仅 Admin 可改，全部留痕。注意：Active ≠ 转化 |
branch_id 分校 | BR01 ~ BR08 | 转班只改这个字段，不改主状态；见 §11 |
payment_status | Pending / Paid / Receipt Issued | Admin 手动更新；首次变为 Paid = 转化（F-13 口径）；见 §10 |
stock_issued | T-shirt / Notebook 是否已发 + 日期 + 经办人 | 写在学生个人资料里，发放即扣库存；见 §09 |
P0 上线必需 · P1 首版应有 · P2 可延后 ｜ NEW = v1.0 新增 ｜ v1.1 = 本次决策 / 新增
| 编号 | 模块 / 需求描述（含验收标准） | 优先级 |
|---|---|---|
| A · 报名与试听 | ||
| F-01 | 报名意向链接（Web，无需下载 App）：字段见 §05，中英双语；提交后生成学生记录（状态 Pending）并通知学校管理员组；同手机号重复提交自动关联；成功页提示「我们会尽快联系您」。验收：手机浏览器 2 分钟内完成提交，管理员 10 秒内收到通知。 | P0 |
| F-02 | 管理员试听确认：新线索列表、一键 wa.me 跳转 WhatsApp（预填模板）、记录试听日期、试听后「继续注册」或「暂缓 Pending（必填原因）」。验收：收到通知到状态变更 ≤ 2 分钟，全程留痕。 | P0 |
| F-03 | 学生资料库：姓名（英/中）、年龄、学校、家长姓名与电话、时段偏好、上课期望、备注；搜索/筛选/编辑/软删除；家长按手机号绑定；含 T-shirt / Notebook 发放栏位（F-17）；资料变更留审计日志。 | P0 |
| F-04 | 正式注册 → Active + 排课：分配班级/时段，系统生成 10 节课课表，家长端立即可见。此为 Active，不等于转化（转化以首次缴费为准）。 | P0 |
| B · 排课 · 点名 · 补课 | ||
| F-05 | 学期课表：管理员建学期、设每周时段，自动排 10 课次（Lesson 1–10 + 日期），支持手动顺延；调整时通知受影响家长。 | P0 |
| F-06 | 老师手动点名：按「今日课程」列名单，逐个勾选出席 / 缺席 / 迟到；支持课后补改；离线暂存联网上传。 | P0 |
| F-07 | 出勤查看：家长与老师随时查看课次编号、日期、状态（含补课状态）。 | P0 |
| F-08 | 补课申请与审批：缺席课次出现入口 → 家长选可补时段（含剩余名额）→ 通知 Admin 审批 → 批准占名额 / 拒绝填原因重选；同一缺席课次只允许一个待审申请。 | P0 |
| F-09 | 通知中心：新报名→Admin；补课申请→Admin；审批结果→家长；课表变更→家长；转班结算提醒→双方 Admin；未读角标 + 历史列表。 | P0 |
| F-10 | 家长账号与多孩：手机号登录，一个账号绑定多名子女，首页切换。 | P1 |
| F-11 | 管理报表：出勤率、时段人数、转化率（首次缴费口径）、收款、库存；CSV 导出。 | P2 |
| F-12 | — | |
| C · 院长看板 · 出勤评语 · 课程进度 · 审批代理 | ||
| NEWF-13 | 试听池数据看板（Trial Pool Dashboard）：院长可看 询问数 / 试听数 / 转化数 / 转化率；v1.1转化以「首次缴费完成」为准（非 Active），Active 未缴费单列「已注册待缴费」群体；按 8 分校、周/月/学期、时段偏好筛选；可导出。详见 §06。 | P0 |
| NEWF-14 | 周出勤记录（Weekly Attendance）：在点名基础上扩展 —— 上课日期、课次、出席状态、本节课备注 Remark、Concern 关注标记；可按周导出给院长。详见 §07。 | P0 |
| NEWF-15 | 学生评语 → 家长通知（需院长审批）：老师写好/坏评语 → 自动关联学生档案 → 提交 Principal 或 F-25 代理人审批 → 通过才推送家长 App；驳回退回修改。未审批内容家长不可见。 | P0 |
| NEWF-16 | 课程进度更新与评语（组 / 个人）：老师可选择「整组 Group」或「单个学生 Individual」录入进度与评语；自动带入老师姓名作为记录用途（不可编辑）+ 时间戳；关联学期与课次。详见 §08。 | P0 |
| v1.1F-25 | 审批代理人（Approval Delegate）：Principal 可指定 1 名或多名代理人并设生效 / 失效日期；代理期间可审批评语、评估报告、转班；所有代理审批记录标注「代 Principal〈姓名〉审批」并留痕；不设超时自动通过；代理人权限变更全程可追溯。验收：Principal 设代理人后，评语审批队列自动转派；审批记录可见代理标识与原委托人。 | P0 |
| D · 库存 · 收费 · 收据 | ||
| NEWF-17 | 物资库存（T-shirt / Notebook）：学生个人资料新增「是否已发」栏位；勾选发放 → 系统自动从该分校库存扣减；每分校每品项设最低水位，低于水位通知 Admin；补货/更正需填原因留痕。详见 §09。 | P0 |
| NEWF-18 | 收费记录（Admin 人工核对银行后录入）：金额、Course fees、付款方式、付款日期、Remark；Pending Payment 列表 Admin 与 Principal 均可见；首次缴费事件须写入转化统计（F-13）。无在线支付。 | P0 |
| NEWF-19 | 账单模板（Admin 生成给家长）：固定品项 Registration fees / Course fees / T-shirt / Notebook / Extra class / Total / Due by (date)，可增删行、系统自动算合计、必填到期日；生成后推送家长 App。详见 §10。 | P0 |
| NEWF-20 | 收据自动生成：Admin 标记为 Paid 后，系统自动生成带唯一编号的收据（PDF + 站内），推送到家长 App 并通知；含学生、分校、品项、总额、付款方式、日期、经办人，v1.1以及 SST 注册号 / 税号 / 公司注册号。 | P0 |
| E · 多分校 · 转班 · 评估报告 | ||
| NEWF-21 | 8 分校架构：所有业务数据带 branch_id；Admin/老师按分校隔离，Principal 看全部；同一个 App、同一数据库，不做数据复制导入导出。详见 §11。 | P0 |
| NEWF-22 | 转班（Transfer Class）：家长或 Admin 发起（选目标分校 + 原因 + 生效日）→ v1.1原分校 Admin + 目标分校 Admin 会签 → Principal 终审 → 通过后学生资料与课表迁到目标分校；已缴费用/收据留原分校、新分校自下学期起计费，系统只发结算提醒通知（不自动分账、不改账单）；通知双方分校 Admin 与家长。详见 §10.4 / §11。 | P0 |
| NEWF-23 | 评估报告提醒：第 10 节课点名完成后，系统自动通知该班老师（+ Admin）为每位学生填写学期评估报告。 | P0 |
| NEWF-24 | 评估报告审批与发送：老师提交 → Principal 或 F-25 代理人审批 → 通过后推送家长 App + 通知；驳回退回修改；报告存入学生档案、可导出 PDF。详见 §12。 | P0 |
| 字段 | 控件 | 校验 / 说明 |
|---|---|---|
| Student's Name (英) | 文本 | 必填 |
| 学生姓名 (中) | 文本 | 必填 |
| Age / 年龄 | 数字 | 必填，4–17 |
| School / 学校 | 文本 | 必填 |
| Preferred Public Speaking session / 选择口才班时段 | 下拉 | 必填，选项由 Admin 维护（建议带「余位」） |
| Parent's Contact Number / 家长联络电话 | 电话 | 必填，+60 格式；作为家长账号匹配键 |
| Expectation for this course / 上课期望 | 多行文本 | 必填，同步给 Admin 与授课老师 |
给院长看的招生漏斗，数据全部由 F-01~F-04、F-18 自动汇总，不需要任何人手工统计。
| 指标 | 定义（口径） | 来源 / 维度 |
|---|---|---|
| No. of Enquiry 询问数 | 提交报名意向的去重学生数（按家长手机号去重） | F-01；按分校 / 周 / 月 / 学期 / 时段偏好 |
| No. of Trial 试听数 | 状态到达 Trial Scheduled 或 Trial Done 的学生数 | F-02；含「已约」与「已完成」两个子数 |
| No. of Converted 转化数 v1.1 已定 | 首次缴费完成（payment_status 首次变为 Paid）的学生数。不以 Active 状态为准 | F-18 / F-20；按首次缴费日期归入对应周/月/学期，不回溯 |
| 已注册待缴费 Pending Payment | 状态为 Active、但尚未首次缴费的学生数 | F-18；供院长追收，与转化数分开显示 |
| 整体转化率 / 试听转化率 | 首次缴费数 ÷ Enquiry ／ 首次缴费数 ÷ Trial | 自动计算，可看趋势 |
| 暂缓原因分布 | 试听后 Pending 的原因统计 | F-02 的原因字段 |
| 字段 | 说明 |
|---|---|
| Date / 上课日期 | 该节课实际日期，自动带出课表日期 |
| Lesson No. / 课次 | Lesson 1–10 |
| Attendance / 出席状态 | 出席 / 缺席 / 迟到 / 已补课 |
| Remark for this class / 本节课备注 | 老师填写，描述这节课整体情况 |
| Concern 标记 / 需关注 | 可针对某些学生打标，便于院长与 Admin 追踪 |
| Individual comment / 学生评语 | 好 / 坏评语，自动关联到学生个人档案；走 F-15 审批后才推家长 |
| Teacher / 记录老师 | 自动带入老师姓名 + 时间戳，不可编辑 |
老师录入时先选范围，系统据范围决定评语落在哪里：
| 范围 | 落库方式 | 适用场景 |
|---|---|---|
| Group 整组 | 1 条组记录，关联该班该课次全班名单 | 全班进度、整体课堂表现 |
| Individual 个人 | 1 条记录 / 学生，写入学生档案 | 个别学生的进度、优点、需加强 |
| 栏位 | 说明 |
|---|---|
| T-shirt given | 是/否 + 发放日期 + 尺码 + 经办 Admin |
| Notebook given | 是/否 + 发放日期 + 经办 Admin |
| Item 品项 | 金额 (RM) | 备注 |
|---|---|---|
| Registration fees / 报名费 | ____ | 可留空 |
| Course fees / 课程费 | ____ | 对应学期 |
| T-shirt | ____ | 尺码可注记 |
| Notebook | ____ | — |
| Extra class / 加课 | ____ | 节数 |
| TOTAL 合计 | 自动求和 | — |
生成后推送家长 App + 通知；家长可在 App 内查看账单明细与状态。
TS-BR01-2026-0001：品牌-分校-年份-流水）。| 项目 | 处理方式 | 说明 |
|---|---|---|
| 本学期已缴费用 | 留在 A 分校 | 已消耗 5 节课的成本归 A |
| 本学期未结账单 | 留在 A 分校 | 由 A 分校 Admin 继续追收 |
| 已开收据 | 留在 A 分校 | 编号含 BR01，不改写 |
| B 分校新账单 | 下一学期起才生成 | 不在转班当下立即计费 |
| 结算提醒通知 | 系统自动发（纯通知） | 收件人：原分校 Admin + 目标分校 Admin（可抄送 Principal）；内容含学生姓名、原分校已上课次数、费用归属原分校、新分校下学期起计费 |
所有业务表带 branch_id（BR01~BR08）：学生、班级/课表、出勤、评语、课程进度、库存、账单、收据、评估报告。权限按分校隔离，同一个 App、同一数据库，切换分校只是筛选维度，不做数据复制。
| 角色 | 可见范围 |
|---|---|
| Principal（含代理人） | 全部 8 分校（可下钻单分校） |
| Admin | 仅所属分校（可配置是否允许跨分校） |
| Teacher | 自己任教的班级 |
| Parent | 自己子女，跨分校也可见 |
branch_id 并记录一条转班事件（含双方会签人、终审人、生效日）。branch_id 必须在 MVP 阶段就写进数据模型与权限层。等系统上线后再补多分校，几乎等于重写一遍（见 §17）。| 报告字段 | 来源 |
|---|---|
| 学期 / 分校 / 班级 | 系统自动带入 |
| 出勤统计（10 节：出席 / 缺席 / 补课） | 自动从 F-06/F-07 汇总 |
| 课程进度完成度 | 自动预填自 F-16，老师可改 |
| 优点 / 强项、需改进、下阶段建议 | 老师填写（可带入已审批评语） |
| 老师姓名、提交日期 | 自动带入、不可编辑（记录用途） |
| 审批人 / 审批日期 / 审批意见 | 系统记录；若为代理审批，标注代理人 + 原委托人（F-25） |
① 试听池数据看板（询问 / 试听 / 首次缴费转化 / 待缴费） ② 统一审批队列（评语 / 评估报告 / 转班终审） ③ Pending Payment 总览 ④ 库存低水位总览 ⑤ 报表与导出 ⑥ 审批代理人设置（F-25）
Web 公开页：报名意向表单（移动端优先）+ 提交成功页；校长/院长建议用 Web 后台而非手机 App（看板表格多）。
iOS + Android App（建议 Flutter 跨端）；报名表为响应式 Web；Admin / Principal 为 Web 后台。最低 iOS 14 / Android 8。
中文 + English 双语切换；报名表与账单收据双语并列。
报名提交 < 2s；点名保存 < 1s；推送到达 < 30s；App 冷启动 < 2.5s。
未成年人资料：PDPA 2010 家长同意勾选；数据存马来西亚/新加坡区域；家长可申请删除；财务记录与含 SST / 税号 / 公司注册号的收据依当地税务要求留存；所有资料/状态/金额变更留审计日志。
branch_id 行级隔离（8 分校）；未审批内容家长不可见；审批代理人（F-25）可设有效期、代理审批须标注身份；审批动作不可篡改、可追溯；驳回必填意见；不设超时自动通过。
库存扣减原子操作、不可为负；收据编号全局唯一且转班后不改写；首次 Paid 事件只计一次转化；金额 RM 两位小数；弱网时点名离线暂存、联网自动上传。
wa.me/<phone> 深链 + 预填文案，无需官方 API；若要自动发群需 WhatsApp Business API（见 §18）。| 阶段 | 包含内容 | 交付物 |
|---|---|---|
| MVP | F-21 分校数据模型（第一天就要做） + F-01 报名表 + F-02 试听确认 + F-03 学生资料库 + F-13 试听池看板（首次缴费口径须先定义好事件） | 报名链接 + Admin/Principal 后台，替代人工登记，院长看得到漏斗 |
| v1.0 | F-04~F-09 排课 / 点名 / 补课 / 通知 + 家长端 App 上架 | iOS / Android 上架版本 |
| v1.1 | F-14 周出勤备注 + F-15 评语审批 + F-25 审批代理人 + F-16 课程进度 + F-17 库存 + F-10 多孩 | 教学与物资模块上线，代理人可代批 |
| v1.2 | F-18 收费 + F-19 账单模板 + F-20 收据（含税务栏位）+ F-22 转班（双方会签 + 结算提醒） | 财务与多分校流转 |
| v1.3 | F-23 / F-24 学期评估报告 + F-11 报表 | 完整闭环 |
first_paid_at 字段与转化事件，v1.2 接上 F-18 即可，避免返工。| 问题 | 影响 | 建议 / 决策时间 |
|---|---|---|
| 转班课次衔接：上了 5 节后转班，剩余 5 节在新分校怎么排？（跟班插入 / 从 Lesson 1 重上 / 原课表保留到期末） | 高 | v1.2 前定；用户尚未指定 |
| 税务栏位具体数值：SST 注册号、公司注册号（SSM）、税号、收据抬头与 Logo 由甲方提供 | 高 | v1.2 前提供，影响收据 PDF 模板 |
| 结算提醒通知的收件人与措辞（「请 B 分校向 A 分校结算」还是「请 A 分校保留本学期收款」） | 中 | v1.2 前确认文案；逻辑不变，只改文字 |
| 代理人人数上限、有效期上限、可否跨分校指定 | 低 | v1.1 前定；默认 1–2 名、最长 30 天 |
| T-shirt 是否分尺码？各品项最低水位数值？ | 中 | 建议按尺码分别设水位；数值由甲方给 |
| 付款方式枚举（Bank transfer / Cash / QR / Cheque / 分期？） | 中 | v1.2 前定 |
| 「通知管理员组」是只用 App 推送，还是要自动发进 WhatsApp 群（需 Business API、有费用）？ | 中 | MVP 前定；默认 App 推送 + 邮件兜底 |
| 补课政策上限（每学期最多补几节、名额满了怎么办）？ | 中 | 建议每缺席 1 节补 1 节、每学期上限 2 次 |
| 评估报告是否需要家长签收 / 回执？ | 低 | 建议先做「已读」即可，v1.3 评估 |
| 8 分校 Admin 是否允许跨分校操作？老师是否共用设备点名？ | 低 | 影响权限与账号体系，开发前确认 |
| 家长端是否需要「主动请假」（区别于缺席）？ | 低 | 建议 v1.1 加入，与补课流程打通 |
| 未来是否接入在线支付？ | 低 | 本期 Non-goal，数据结构预留即可 |