1系统定位与当前状态
本系统是一套SaaS多租户教培管理平台。平台运营方统一管理所有客户机构，机构付费后获得独立工作区（工作区代码登录），机构内部员工按角色使用全部功能。目前已上线12大业务模块 + 微信服务号推送 + 代理商推广体系 + 老师端 + 家长端 + 深色大屏数据看板 + DDL 课件生产体系（讲义转课件 / 在线编辑器 / 模板市场 / 母版图表动画 / 学员端分发） + CRM 客户生命周期自动流转 + HTTPS 强制加密 + 每日自动备份。
平台运营方
开通新机构 · 分配工作区代码
套餐管理 · 定价配置
查看所有租户运营大盘
代理商管理 · 佣金结算
平台财务 · 收入统计 · 协议管理
平台共享微信服务号 · 机构服务号托管
12 大业务模块 已上线
CRM 客户管理 — 线索/跟进/订单/学员/退费/转介绍全漏斗（14 项功能）
OPS 运营工具 — 海报设计/积分商城/问卷/营销活动/地推等 33 项获客运营工具
EDU 教务管理 — 课时包/课程/班级/排课/消课/补课（15 项功能）
HR 人力资源 — 花名/通讯录/招聘/考勤/薪资/课酬（8 项功能）
FIN 财务管理 — 收支/应收/发票/业绩/工资/经营分析（9 项功能）
AST 资产管理 — 进销存/固定资产/领用归还/工位成本（5 项功能）
KPI 绩效考核 — 指标库/考核方案/评分/排名/薪酬联动（5 项功能）
KB 知识库 — FAQ 帮助中心，按租户与代理商分权维护
OA 审批待办 — 审批中心/待办中心/课时与奖励审批（4 项功能）
MSG 消息预警 — 通知中心/预警提醒，推企微群与服务号（2 项功能）
EXT 三方配置 — 企微/公众号/支付/云打印/考勤机/扫码枪（6 项功能）
ORG 组织管理 — 分校/员工/角色/功能开关/机构设置/日志（7 项功能）
辅助体系 已上线
老师端 — 教师专属工作台：课表/考勤/消课/点评
家长端 — 课时查看/消课记录/出勤情况，课消透明
代理商推广体系 — 注册/推广/佣金/预付款自助开通续费
微信服务号推送 — 上课提醒/消课通知，模板机构可自配
数据驾驶舱 — 深色大屏经营看板，可投屏演示
小程序课程预约 — 手机号留资入口，线索自动进 CRM
2SaaS多租户架构 · 全部已实现
系统按四个层级组织，数据从上到下逐级隔离。每个机构通过工作区代码（6位数字，系统自动生成，如 235608）登录，拥有独立的全部业务数据。若机构绑定了自定义域名（如 bjzqnjy.853858.com），访客直接访问该域名即可登录，系统自动识别机构并隐藏"工作区代码"输入框，只需输入账号密码；同时登录页会展示该机构的品牌（方形 Logo + 登录页标题）。
第二层：机构/租户 — 机构管理员 已上线
CRM客户管理
线索·订单·退费·公海·转介绍·投诉
ME 个人中心
我的薪资 / 我的协议 / 我的打卡
一体化数据引擎 — 全部模块共享同一数据源 + 自动化引擎
CRM成交数据 → 自动流入KPI计算 → 联动FIN财务收支 → 关联EDU课时消耗 → 触发ALT续费预警。全部核心模块（CRM / EDU / FIN / KPI / PSI / ORG / HR / 考勤等）在同一租户空间内数据互通，无需导出Excel、无需跨系统调API。机构间数据完全隔离。
自动化引擎：CRM 客户生命周期（11 状态枚举）按规则自动流转（高意向降级 / 试听超期 / 未成交转沉睡 / 在读转续费 / 沉睡冷冻），每小时后台调度一次；公海线索按租户配置的回收时长自动收回（默认 72 小时无跟进即回收）；地推成交后自动核算报酬并入财务账。
3CRM 客户管理 已上线
CRM是机构一线人员每天操作的业务系统。已实现线索全生命周期管理、订单与退费、公海线索、转介绍追踪、标签分类。
3.1 线索管理 + 客户生命周期自动流转
线索录入与导入
手动新增：客户名称/电话/来源/意向课程/备注
CSV批量导入：一键导入历史线索数据
线索来源标记：地推/转介绍/线上/社群等
线索分级：A/B/C/D 热度标签
公海线索：未跟进自动回收，支持重新分配
公海自动回收——租户可配置回收时长（默认 72 小时），分配后无跟进自动收回公海
11 值生命周期状态机 + 跟进与转化
跟进记录时间线：电话/微信/面谈（6 种跟进结果）
线索分配：指派跟进人
11 值状态枚举：new / low_intent / high_intent / appointed / trial_done / lost_trial / studying / renewal / churn / sleep / frozen
试听预约：精确调度到试听当天
转介绍追踪：老带新线索来源关联
生命周期自动流转——系统每小时按规则自动转状态，高意向降级/试听超期/未成交转沉睡/在读转续费/沉睡冷冻
3.1.1 线索集市（跨机构共享池）
共享与领取机制
线索管理新增四分组：我的线索 / 公海线索 / 线索集市 / 全部线索
提交即让渡：公海线索可一键「转集市」共享给全平台机构
免费领取 + 贡献积分与信誉等级（青铜 / 白银 / 黄金 / 铂金）+ 贡献榜
支持撤回、举报虚假线索、每日限额与在架上限
撞单防护：领取方机构内已存在同手机号客户时禁止重复领取并提示原因
三页（浏览领取 / 我的共享 / 我领取的）全支持分页，汇总条为全量统计
合规隐私与精准筛选
合规红线：领取前仅返回标签画像（姓名 / 电话 / 微信 / 来源全部不可见）
提交方须主动勾选单独同意并确认合规承诺书，支持按手机号隐私删除
筛选面板 8 个维度：品类 / 区域 / 行业 / 画像年龄 / 性别 / 质量分 / 上架时间 / 排序
区域支持省 / 市 / 区县 / 县级市与带尾缀写法（「武汉市」「洪山区」「昆山市」均可命中）
行业品类同义词归一（「体育」→「体育培训」、「画画」→「美术」），筛选不再出现碎片值
「线索集市」已作为平台预置来源写入线索字段设置，平台写死不可删除
3.1.2 线索批量工具与获客活码
批量打标签与线索批量分配
线索批量打标签：勾选多条线索一次性打标签，标签按租户校验且幂等去重
打标签弹窗优化：弹窗收窄不再压扁，「+添加标签」由原生下拉改为可点标签 chip
沉睡客户自动唤醒：批量打「待唤醒」标签并建待办，到期后自动翻转为「试听未成交」并通知负责人
线索来源标签补齐：新增「小程序获客 / 加微获客 / 员工活码 / 线索集市」平台预置来源
员工企微活码 + 可用性检测
员工活码：为员工创建企微客户联系活码，客户扫码加粉自动归因到该员工名下
员工可用性检测：一键检测所选员工能否接客户并展示结果
错误中文诊断：企微 41054 未激活 / 40098 未实名等错误给出原因与具体名单
建码失败自动回滚，不留僵尸码
3.1.3 招生微官网与二维码获客工具
招生微官网
机构可自助配置品牌头、留资条、联系栏、OG / 分享二维码等 9 个字段并持久化
留资直接进线索池（来源标记「招生微官网」）
网址转二维码 + 我的二维码记录
网址转二维码：租户自助生成，尺寸 240~800、容错等级、前景/背景色自定义并实时预览、下载 PNG
工具增强：叠中心机构 Logo、一次批量生成最多 50 条、支持 UTM 推广追踪参数、可生成短链跳转
二维码补白边（静区）：四周留 4 个模块浅色静区，深色底/裁切/打印时也能扫出
我的二维码记录：按机构留档（名称/网址/短链/点击数/时间），可重新下载、复制短链或删除
3.2 学员管理、订单与收费
学员档案
基本信息（姓名/年龄/年级/学校）
报读课程记录
关联家长/紧急联系人
剩余课时实时显示 + 颜色警示（≤4红/≤10橙/>10灰）
PC 端列表可自选列（列设置按员工保存偏好）
订单与收费
订单管理（金额/支付方式/日期）
订单金额与课时分离：total_amount(元) + total_hours(节) 两个独立字段
回款记录与应收统计
退费处理与记录
地推业绩报酬——成交时若线索有推荐人，按租户配置自动核算并入财务账
金额负数拦截：系统强制校验，拒绝录入负数订单
标签与看板
客户标签分类管理
转化漏斗：线索→意向→到访→成交
多维度数据看板
逾期优先排序：线索列表可按下次跟进时间倒序排列
投诉管理
投诉登记与处理跟踪
投诉分类 · 处理状态流转
与退费/纠纷处理联动
家长账号管理
批量开通家长登录账号
绑定孩子与报读课程
家长端课时/消课/出勤查看
家长端「课时包」透明页签：剩余课时/余额/次数、有效期、状态（生效中/冻结/已合并等）与最近 100 条消课流水（消课/转课等中文说明）
家长端「我的推荐」老带新：推荐码 + 专属链接 + 推荐海报，新家长扫码留资自动归因到老家长名下
学员中心功能开关：机构后台可分别开关「我的奖励/我的推荐/在线缴费/我的协议/课时包」页签
老师账号管理
开通教师登录账号
绑定授课班级与课程
老师端课表/考勤/消课确认
3.3 CRM 能力增强
结构化与自动化
自定义字段（/custom-fields）：线索/学员扩展字段，平台可配选项（/field-options）
自定义字段通用引擎：单表多实体，线索/学员/员工/课程/课时包/请假审批六类实体通用，字段类型支持文本/多行文本/下拉/数字/日期/手机号
新租户自动预置标准自定义字段（按 6 类实体幂等灌入，不覆盖已建字段）；入口提升到「机构设置」
生命周期配置（/lifecycle-config）：租户级 27 项参数，系统每小时自动调度转状态
智能预警（/alerts）：续费临界、出勤异常等多维度预警
线索与转化增强
批量分配（/leads/batch-assign）、重号检测（/leads/check-phone）
CSV 导入与模板（/leads/import、/leads/import-template）
公海回收（/leads/:id/to-pool）、标签（/leads/:id/tags）、试听管理（/trials）
资金与课时风控
退费审批流（/refunds → /:id/approve|reject）：退款须主管审批，防随意退费
课时变更审计（/hour-audits）：课时增减留痕，非管理员须审批（/approve|reject|cancel）
收款（/payments）、投诉联动退费/纠纷处理
续费与业绩
续费预测（/renewals、/renewals/stats）：按近 30 天出勤率推算 predictedDays，分级 urgent≤7 / warning≤14 / info
推广统计（/promo-stats）：推荐人业绩与地推报酬核算
转介绍追踪（/referrals）、学员导入/恢复/暂停、待办（/todos）
4EDU 教务管理 已上线 V16 更新部分功能
课程、班级、教师、教室一体化管理。智能排课避免冲突，考勤管理自动记录，课表视图一目了然。消课即扣课时，剩余课时实时计算。
课程管理
课程创建与分类
课时单价/总课时设置
课程关联学员与教师
课程支持自定义字段（通用引擎接入）
课程批量导入：下载模板填表上传，一次建好课程
排课管理
班级排课与教师排班
教室/场地管理
排课冲突检测
学员维度档期冲突检测：同一学员被排到时间重叠两节课直接拦截并点名是哪位学员、哪节课
课表双视图：按教室 / 按教师切换；教师视图显示每位老师本周节数与课时数，空白格可点直接排课并自动预填日期/时段/教师
补课自动排课：按工作时段/粒度/天数给出最多 3 个候选空档（自动避开教师、教室、学员三重冲突），人工确认后排定并通知授课教师
调课真功能化：调课/停课/复课实际改排课（回滚已扣课时、回退旧考勤、写变更日志、给家长发微信调课通知），OA 审批通过后自动执行
考勤与课时
考勤记录（到课/缺勤/请假）
消课即扣课时
剩余课时实时计算
课表视图（周/月）
课时包七大套餐方案：多课拆包（按课程分子行扣）、家庭共享（成员共享课时池）、全通会员（只记流水不扣量、包永不耗尽）、升班续报（耗尽自动建高优续报待办）、促销引流（可绑获客码做体验课）、分期付款（按期还款+核销+自动催缴）、赠送课时
课时包生命周期：延期（按天/月+留痕）、合并（剩余累加到同学员的另一包）、转让（改绑给同机构其他学员）、冻结（暂停消课但已冻结课时仍计入总课时）
消课扣减顺序机构开关：赠送课时先扣 / 正价课时先扣；储值口径与课时包口径互斥避免双扣
换课转班 + 休学复学：剩余课时跨课程包 1:1 平移，休学自动冻结该生全部课时包、复学解冻
4.1 教务能力增强（排课升级 + 售后流转）
课时与消课策略（机构可配）
课时管控级别、消课模式、消课扣费口径、迟到早退扣课四项策略独立成「课时与消课策略」卡片
口径切换后课时包 / 储值账户菜单显隐立即生效
消课联动细则可配：缺勤是否扣课、请假按比例扣课（0-100%），关闭时只留痕不扣课时
退费口径合规：退费金额只按可退现课时包剩余价值计算，赠送剩余课时仅展示不退款；转课汇总排除不可转增包
售后流转中心
学员档案旁新增聚合页，一次看全停学 / 复学 / 转课 / 退费 / 续费 / 请假 / 补课 / 调课全景时间线
可直接执行停复学与转课，差价默认仅记「待人工确认」
课时包批量导入（CSV）：按学员 ID 或姓名自动绑定，容量字段按账本权限校验
4.2 教研教案 / 校区保险（V16 新增）
教研教案全链路（教师写 · 教务审）
五域结构：教学目标 / 重难点 / 教学过程 / 板书设计 / 作业布置，支持 KaTeX 公式与 MathLive 手写公式（数理化友好）
一行一版本：版本列表 + 一键回滚到任意历史版本；平台种子模板库 5 套可复用
关联排课课时（lesson_no）、复制 / 拖拽排序；PDF 导出保 KaTeX 排版
审批流：提交 → 教务审批 → 通过；AI 初稿生成（5 段解析）+ AI 修订建议（默认关）；1-5 星评分仅后台可见
权限边界：租户后台可写、教师端只读，教学资产安全可控
校区保险与电子保单
保单台账：保单号 / 承保保司 / 起止日期 / 保费 / 被保人，七家保司 logo 展示
理赔登记：出险记录 / 理赔进度跟踪，闭环管理
电子保单 PDF 识别录入，上传即自动解析落库
家长端「校区保障」tab：向家长透明展示在校安全保障，增强信任
5FIN 财务管理 已上线 V16 更新部分功能
收支流水一目了然，收款登记与课程自动关联，应收实收自动统计。员工业绩与提成核算联动，工资管理告别Excel手工算。
收支流水
收款登记与流水记录
支出记录与分类
应收/实收汇总统计
应收欠费台账：总应收/总欠费/逾期欠费统计卡 + 欠款明细表（欠款方/类型/应收/已收/欠费/还款日/逾期/责任人）+ 手工挂账增删改查
欠费催收闭环：挂账收款（落回款收入流水）、减免、坏账核销、收清自动结清；欠费行可一键转待办并指派责任人，逾期待办自动标高优先级
员工工资
员工工资条管理
业绩提成核算
薪酬结构配置（基本+绩效+提成）
工资条列式展示：迟到/早退/缺勤/请假扣款、加班费、提成、全勤奖逐项列明算式，差额补「其他调整（人工修改）」行
薪酬 CSV 导出：导出字段与页面一致（管理员端与员工端同时生效）
财务概览
财务收支总览看板
月度/季度收支对比
机构盈亏/分校盈亏分析
平台财务统计（运营方）
5.4 经营分析看板（P0）
财务概况新增经营分析页，7 个看板支持自定义日期范围。收入口径 = 课消金额 + 教材对外销售出库 + 其他业务收入；成本 = 教材采购 + 工资 + 其他支出。
七个经营看板
经营总览：收入 / 成本 / 利润核心指标
单课程毛利：按课程拆解毛利结构
单师带课产出：按教师统计带课产出
学员终身价值与复购率
现金流走势
获客成本（CAC）与续费率
社保公积金与个税本地化
城市社保/公积金费率表：预置 10 城市，机构选参保城市可带出默认费率，「其他」城市不覆盖机构自定费率
专项附加扣除由 1 个合计框扩为 7 类分项（新增 3 岁以下婴幼儿照护），真实参与个税累计预扣计算
系统自动算 + 手动覆盖双轨：系统按规则自动计算，机构可手工覆盖（适配不规范的中小机构）
公众号欠费催缴提醒：订单欠费可手动单发催缴微信（模板字段机构端与平台端均可配置）
5.1 财务能力增强
精细化核算
分校盈亏（/branch-profit）：分校级收入/支出/利润一目了然
收支分类（/categories）：自定义收支科目，统计更清晰
记账复核（/records → /:id/review）：关键收支须复核，防错账
工资与业绩
工资（/payroll）：工资条生成与发放记录
员工业绩（/sales-performance）：按订单/回款核算个人业绩
总览对比（/overall-compare、/summary）：跨期收支对比与经营概览
5.5 对账中心（V16 新增）
一单一码收款与流水对账
支付配置可插拔多通道：支付宝 / 微信 / 随行付 / 收钱吧 / 拉卡拉 / 银联云闪付（机构自有商户号直连，平台不经手资金，零二清风险）
一单一码动态收款码（带金额 + 订单号，非静态码），家长扫码付款实时登记
银行 / 微信 / 支付宝流水导入，按「金额 ±0.01 + 时间窗 ±3 天 + 订单号」自动匹配对账，幂等防重
应收看板与欠费拦截
应收 / 实收 / 欠费看板，待确认收款一键确认或忽略
欠费拦截：未知学员 / 超额收款自动拦截，保护机构资金
持牌通道二期实联调骨架（随行付等）：统一下单 + 异步回调自动登记 + 原路退款，填真实测试号即端到端跑通
6KPI 绩效考核 已上线
与CRM天生一体——成交数据自动流入KPI计算，无需导出Excel。内置10 大岗位考核模板（54 项指标），机构一键套用或自选方案、自配权重、自定目标，支持排名看板与薪酬联动。
6.1 KPI 指标库结构
系统内置 10 大岗位考核模板，按 10 大分组（销售业绩岗/教学教研岗/学员服务岗/校区管理岗/市场获客岗/运营支持岗/教学管理岗/续费业绩岗/线下获客岗/服务管理岗）组织，每个模板含 5-7 项指标、合计 54 项通用指标，覆盖教培机构所有考核场景。每个机构根据自己的业务特点，从指标库中自由选取模板或自选指标、自行配置权重、自定目标值。说明：指标内置在系统代码 server/routes/kpi.js 顶部的 KPI_TEMPLATES 常量中，由平台发版统一维护，机构无需也无法自建指标（保持全平台口径一致）。
业绩营收 6项
营收达成率 · 回款率 · 人均产值 · 客单价 · 利润率 · 课时消耗确认收入
招生获客 7项
有效线索量 · 到访/体验量 · 到访转化率 · 线索转化率 · 获客成本(CAC) · 转介绍率 · 体验课转化率
教学质量 8项
考试通过率 · 完课率 · 到课率 · 成绩提升率 · 就业/升学率 · 技能认证率 · 教学事故数 · 作品产出/展演参与
客户满意 7项
NPS净推荐值 · 满意度评分 · 续费/续卡率 · 转介绍率 · 投诉率 · 退费率 · 社群/打卡活跃度
运营效率 7项
满班率 · 教室利用率 · 排课响应时长 · 首课开课及时率 · 师均课时量 · 工单处理时效 · 员工出勤率
团队发展 5项
培训完成率 · 内训组织次数 · 员工流失率 · 持证/资质达标率 · 教研产出
6.2 岗位模板库（一键套用）
系统预置10 大岗位 KPI 模板：课程顾问 / 教学老师 / 班主任学管师 / 校区校长 / 市场推广 / 前台教务客服 / 教学主管 / 续费专员 / 地推渠道 / 学管主管。机构一键套用模板，系统自动按岗位勾选指标、配置权重，再按实际情况微调即可，无需从零搭建。
6.3 机构自选KPI流程
登录后台 → 进入「KPI方案」 → 从指标库勾选指标（或直接套用岗位模板） → 为每个角色分配维度权重(总和=100%) → 设定目标值
→ 设定考核周期(月/季/年) → 保存方案 → 方案生效，下个周期开始执行
6.4 评分体系
| 完成率区间 | 得分系数 | 说明 |
|---|
| >= 120% | 1.2 | 超出目标20%以上 |
| 100% ~ 120% | 1.0 | 达到目标值 |
| 80% ~ 100% | 0.8 | 接近目标 |
| 60% ~ 80% | 0.6 | 明显差距 |
| < 60% | 0.3 | 严重未达标 |
S 90+
A 80-89
B 70-79
C 60-69
D <60
060708090100
| 等级 | 分数 | 绩效系数 | 说明 |
|---|
| S 卓越 | 90-100 | 1.3-1.5 | 绩效奖金130%-150% |
| A 优秀 | 80-89 | 1.1-1.2 | 绩效奖金110%-120% |
| B 良好 | 70-79 | 1.0 | 绩效奖金100% |
| C 待改进 | 60-69 | 0.7-0.8 | 绩效奖金70%-80% |
| D 不达标 | < 60 | 0.5 | 绩效奖金50%，连续两期启动面谈 |
7PSI 进销存系统 已上线
教材、教具、礼品等物资的入库、出库、库存一体化管理。产品分类清晰，库存实时更新，出库类型可追踪，杜绝物料流失和账实不符。
入库与出库
入库登记：产品/数量/供应商/金额
出库登记：领用类型/数量/领用人
出库类型追踪（教学用/销售用/损耗）
产品与库存
产品分类管理
库存实时更新与总览
库存预警（低库存提醒）
供应商档案与供货记录
8ORG 组织管理 已上线 V15 更新部分功能
多分校架构灵活配置，员工账号统一管理。角色权限精细管控，操作日志全程可追溯。机构设置一站式管理，从组织架构到系统配置全掌控。
分校管理
多分校架构配置
分校数据隔离与汇总
分校管理员分配
分校经营看板：学员/线索/签约/回款/员工六指标，支持本月/30天/全部范围与合计行
线索/学员/订单页全局分校筛选 + 运营大盘「分校业绩对比」卡
员工与角色
员工账号统一管理
自定义角色与权限配置
一人多角色（权限并集）
员工支持自定义字段（通用引擎接入）
教师账号批量导入：下载模板填表上传，一次建好教师账号（含登录账号）
企微通讯录一键同步员工：拉取企微成员勾选同步进员工档案，已绑定自动跳过、部门显示中文名称
系统配置
机构信息设置
操作日志全程可追溯
重复学员检测/自动释放
全站主题色切换：8 套高级预设主色，即时预览并随机构持久保存
机构类型模板：按行业（8 种）一键预置基础数据，租户自选类型、纯增量套用不覆盖，可恢复模板默认
8.2 平台统管与权限治理
平台统管减负（P0）
脱敏、撞单、帮助中心等 8 个机构功能开关改由平台统一管控
平台可锁定某项让机构端折叠为只读摘要，服务端强制护栏防绕过
角色权限数据修正：清理 144 条失效权限绑定，机构管理员/校长补齐全量权限、财务专员补绑财务权限
功能可见性 per-tenant
机构可按「全量 / K12 / 职业」行业模板预设勾选可见模块（进销存、固定资产、审批、待办、知识库、全套 KPI 等）
隐藏的模块菜单不显示、直链访问自动回首页
CRM / 教务 / 人事 / 财务 / 组织等核心模块永不可隐藏
8.1 预置角色及权限矩阵
| 功能权限 | 平台运营方 | 机构管理员 | 分校管理员 | 部门主管 | 普通员工 |
|---|
| 租户管理 | 全部 | 无 | 无 | 无 | 无 |
| 创建/管理分校 | 无 | 全部 | 无 | 无 | 无 |
| 员工管理 | 无 | 全部 | 本校 | 本部门 | 无 |
| 角色权限配置 | 无 | 全部 | 无 | 无 | 无 |
| KPI方案配置 | 无 | 全部 | 本校 | 本部门 | 无 |
| 薪酬规则配置 | 无 | 全部 | 无 | 无 | 无 |
| 数据报表查看 | 仅运营数据 | 全机构 | 本校 | 本部门 | 仅自己 |
| 数据导出 | 仅运营数据 | 全机构 | 本校 | 无 | 无 |
9HR 人事管理 已上线
员工全生命周期人事管理：档案、劳动合同、考勤、工资一体化。与考勤打卡、审批流、KPI考核、FIN财务联动，人事数据一处维护、处处使用。
员工档案
员工基本信息管理
入职/在职/离职状态管理
岗位/部门/校区归属
考勤与工资
员工考勤汇总（签到/请假/加班）
工资条管理 · 薪酬结构配置
与KPI绩效系数/业绩提成联动
9.1 人事能力增强
考勤与合同
考勤（/attendance、/attendance/today-summary）：签到/请假/加班明细与今日汇总
劳动合同上传（/contracts/upload）：合同 PDF/图片留档，到期提醒
头像上传（/avatar/upload）：员工头像管理
薪酬自动化
工资模板（/salary-templates）：薪酬结构模板化，快速套用
工资批次（/salaries/batch）：批量核算与发放，/salaries/summary 汇总
课时费（/lesson-fees）、员工自助工资条（/my-salaries）
9.3 招聘 · 假期额度 · 考勤判定
招聘流水线（P0-3）
候选人库：筛选 / 面试 / offer / 录用状态流转
一键把候选人转为员工档案（幂等）
应聘岗位与部门改用机构内置下拉（系统标准岗位库 + 分校列表）
假期额度台账（P0-2）
年假按工龄、调休按加班自动累计额度
HR 可手工覆盖额度（manual 标志位）——适配不规范的中小机构
员工可在「我的假期」查剩余天数
审批通过自动扣减、撤销自动回补
考勤异常判定（P0-4）
「判定缺卡」自动识别在职无考勤且无批准请假的缺勤（自动跳过周末）
考勤行支持手动改判，改判后不被自动覆盖
打卡时间窗软提示：机构可配上下班允许打卡时间窗，超窗打卡标黄并打「超窗」标签（仅提醒不拦截）
员工端「我的打卡」同步可见；打卡历史改北京时间口径并支持月份切换
10ALT 智能预警中心 已上线
预警中心是学员流失防控的核心工具，基于CRM数据自动分析异常情况并分级告警，帮助机构主动干预、减少流失。
9.1 续费预测
| 预警等级 | 耗尽天数 | 标签 | 建议动作 |
|---|
| 紧急 | ≤ 7天 | 立即联系 | 班主任当天联系家长沟通续费方案 |
| 警告 | ≤ 14天 | 本周跟进 | 本周内完成续费沟通 |
| 提醒 | ≤ 30天 | 提前准备 | 列入续费储备名单，提前规划 |
9.2 考勤异常
| 异常类型 | 触发条件 | 说明 |
|---|
| 连续缺勤 | 连续缺勤 ≥ 3次 | 可能面临流失风险，需要了解原因 |
| 出勤率过低 | 近30天出勤率 < 50% | 学习投入度明显下降 |
| 长期无消课 | 超过14天无消课记录 | 处于沉默状态，需要激活 |
| 欠费催收 | 订单欠费逾期 | 预警中心新增「欠费催收」统计卡与明细卡，欠费行可一键转待办并指派责任人，逾期待办自动标高优先级 |
11MSG 消息通知 + 微信服务号 + 家长端 已上线 V16 更新部分功能
通知中心、建议反馈、微信服务号推送、家长端服务一体化。机构内部消息流转与外部家长微信沟通无缝衔接。
通知中心
站内通知发布与接收
按角色/全员推送
已读/未读状态管理
建议反馈
员工提交建议与反馈
管理层查看与回复
建议分类与状态跟踪
微信服务号推送
平台共享服务号 · 机构可自配服务号
上课提醒：课程开始前自动推送
消课通知：每次消课实时通知剩余课时
模板可自定义——上课提醒/消课通知/活动通知/请假/低课时预警 5 类模板均可机构自配
「课时不足提醒」阈值跟随机构「学员课时预警」设置（此前固定为 5），与预警中心口径统一
通知提醒策略可配（系统默认 + 机构覆盖双轨）：机构可改催缴优先级、渠道（待办/企微）与提前天数
家长端（H5）
家长账号登录查看孩子信息
课时余额与消课记录
上课出勤情况
课时包透明页签：剩余课时/余额/次数、有效期、状态（生效中/冻结/已合并等）与最近 100 条消课流水（中文说明），降低家长投诉
我的推荐：推荐码 + 专属链接 + 推荐海报，新家长扫码留资自动归因到老家长名下
机构可分别开关「我的奖励/我的推荐/在线缴费/我的协议/课时包」五个页签
老师端（H5）
我的课表：今日/本周课程安排
课堂考勤：上课点名与到课登记
消课确认：课时消耗登记
知识库 / 帮助中心
常见问题（FAQ）自助查询（支持搜索 + 分类筛选 + 折叠展开）
平台知识库内容沉淀
员工使用帮助直达
代理商帮助中心——代理商后台独立「帮助中心」Tab，内置 20 条代理商常见问题与答疑
平台可维护——平台后台「帮助中心管理」用「租户帮助 / 代理商帮助」双 Tab 隔离，两类问答均可增删改
11.1 家长端学习动态 / 教师端今日工作台（V16 新增）
家长端学习动态
学员中心新增「学习动态」tab：即将上课（关联教案摘要）+ 已上课（课后记）
双开关默认关：机构开「学习动态」开关且教案勾选家长可见才透出，保护教学隐私
教师端今日课程工作台
教师登录默认落地「今日」页：今日课程 / 已消课 / 待上课三统计卡片
今日课程卡片带时间 / 教室 / 人数 / 已消课，点开即点名消课，与教务端排课同源
12代理商推广体系 已上线 V15 更新部分功能
代理商在线注册（双轨制：普通代理零费用入驻，新单固定 20% 返佣、续费无返佣；金牌代理缴纳 ¥3,980 履约保证金（可退），新单返佣 30% 起步、滚动 12 个月业绩达 ¥10万 升 40%、达 ¥30万 升 50%（只升不降），续费返 15% 限前 5 年）、登录后台，搜索可推广机构、关联推荐关系，系统按档位自动计算佣金。金牌履约保证金按累计佣金阶梯返还：累计达 ¥5万 返还 50%、达 ¥15万 返还剩余 50%（即全额，不限时间，达门槛即退，已返部分自动抵扣，不重复发放）；代理商达到返还门槛后在后台单独发起返还申请，平台审核通过后打款，与佣金结算相互独立。平台运营方统一审核代理商、佣金结算与保证金返还申请。
代理商端
在线注册（/register页面）
独立登录后台（/agent页面）
搜索可推广机构列表
关联推荐关系（选择机构）
查看推荐记录与佣金明细
独立「帮助中心」Tab（20 条常见问题答疑）
代理商合同（/:id/contract）、代注册租户（/register-tenant）
佣金体系
普通代理（免费）：新单固定 20% 返佣，续费无返佣
金牌代理（¥3,980 可退履约保证金）：新签阶梯返佣起步 30%，滚动 12 个月业绩达 ¥10万 → 40%、达 ¥30万 → 50%（只升不降）
金牌专属续费返佣：客户续费额度 × 15%；升级补差价部分 × 15%（限前 5 年）
保证金返还：累计佣金达 ¥5万 返 50%、达 ¥15万 全返（不限时间，达门槛即退，后台单独申请、平台审核打款）
成交后按自然月批量结算，次月 20 日统一可结算/出账单，线下打款
推荐同行介绍奖励（两档通用）：邀请其他代理商入驻（他填你的推荐码注册），他签下机构你拿该机构年费的 10%（限其注册后 12 个月内新签成交、单笔不封顶、年度累计封顶 ¥2万，与佣金同规则次月 20 日结算）；同行注册成功另得 ¥100 预付余额券
套餐金额映射：创业980/成长2980/进阶5980/旗舰9980
结算账户「收款方式」三项分开展示：银行转账 / 支付宝 / 对公账户从聚合一行改为三张独立可选卡片，只读态也可见（含说明文案与当前使用提示）
代理商门户体验升级
导航改版：顶部 9 个横排 tab 改为与主系统一致的左侧深色侧栏（总览 / 返佣明细 / 意向客户 / 推广记录 / 结算记录 / 结算账户 / 宣传素材 / 修改密码 / 我的协议 / 帮助中心 + 退出登录），移动端侧栏变抽屉
总览与帮助中心解除宽度限制撑满大屏
「我的推广链接」提升为左侧导航独立页：专属推广链接、复制与推广二维码独立成页
品牌更名：浏览器标签标题与侧栏 logo 由「代理合伙人」改为「代理商管理系统」
代理招募页宣传海报改写为「教培机构入驻指南」（三步上线 / 入驻权益 / 机构最关心的事），扫码文案改为「扫码免费试用」
结算安全三层加固（防资金风险）
① 二次密码确认——修改收款账户、提交结算申请时，须再次输入登录密码（bcrypt 校验），挡住「已登录设备被他人操作」。
② 改卡后结算冷却——收款卡号变更后 3 天内禁止申请结算，给真实代理发现异常并联系平台冻结（settlement_locked）留出时间。
③ 改卡须平台审核——代理商提交换卡后不再即时生效，进入「待平台审核」；平台在「代理管理 → 改卡审核」通过后才真正更新收款账户并刷新冷却时间，拒绝可填原因。
多层兜底——代码层（代理间越权隔离）+ 上述三道 + 平台审批（代理仅「申请」，平台通过才打款），资金风险基本堵死。
代理商推广流程
代理商注册（双轨制：普通代理零费用 / 金牌代理缴 ¥3,980 可退履约保证金）→ 平台审核通过 → 登录代理商后台 → 搜索未关联的机构 → 选择关联机构 → 系统按套餐和代理档位自动计算佣金（普通 20% 固定 / 金牌 30–50% 滚动 + 续费 15%）→ 成交后按自然月批量结算、次月 20 日可申请结算（提交须二次密码确认，仅结算次月 20 日已开放结算的返佣，未满自动挂起）→ 收款账户变更须平台审核通过后生效 → 金牌代理累计佣金达 ¥5万 / ¥15万 后可在后台单独发起保证金返还申请，平台审核通过后打款
13系统套餐定价 已上线 V15 更新部分功能
核心理念：所有套餐功能完全一致，不搞功能阉割。区别仅在于员工账号数量和分校数量，机构根据自身规模选择即可。每人每日仅需 ¥0.5。
| 套餐 | 价格 | 员工数 | 分校数 | 功能 | 适用场景 |
|---|
| 个人版 |
¥580/年 |
1人 |
1个 |
核心功能（裁剪团队模块） |
个人/工作室 |
| 创业版 |
¥980/年 |
5人 |
1个 |
全部20项功能 |
创业机构、个人工作室 |
| 成长版 |
¥2,980/年 |
15人 |
1个 |
全部20项功能 |
单校区中小机构 |
| 进阶版 |
¥5,980/年 |
40人 |
3个 |
全部20项功能 |
多校区成长型机构 |
| 旗舰版 |
¥9,980/年 |
100人 可扩容 |
不限 |
全部20项功能 |
大型连锁品牌机构 |
个人版为独立授课个人/工作室的轻量套餐：1 人 1 校、裁剪团队模块、台账制收款，与机构四档相互独立；个人用户注册即享 15 天免费试用，可独立转正，正式版可正常升级机构版套餐。
全部 20 项功能包含
① CRM客户管理（线索/订单/退费/公海/转介绍/投诉/生命周期自动流转） ② EDU教务（排课/班级/课表/消课/补课） ③ 考勤打卡（签到/请假/加班/审批，PC 端只读历史）
④ FIN财务管理（收支/盈亏/工资/业绩提成/地推报酬自动入账） ⑤ KPI绩效考核（50+指标/岗位模板/薪酬联动） ⑥ PSI进销存（入库/出库/库存/供应商）
⑦ ORG组织管理（多校区/员工/角色/权限） ⑧ HR人事管理（档案/合同/考勤/工资/员工自助工资条） ⑨ ALT智能预警（续费预测/考勤异常）
⑩ MSG消息通知（通知/建议/反馈） ⑪ 微信服务号推送（上课提醒/消课通知/5 类模板可自配） ⑫ 家长端（课时/消课/出勤）
⑬ 老师端（课表/考勤/消课） ⑭ 审批流程（请假/加班/申请） ⑮ 协议管理（平台-机构协议）
⑯ 知识库/帮助中心（FAQ） ⑰ 代理商推广（注册/推广/阶梯佣金） ⑱ 数据看板与分析（深色大屏/转化漏斗/数据导出）
⑲ 合同与协议在线签署（平台模板 / 机构·代理商签署 / 可终止） ⑳ 审批流引擎（申请 / 审批人 / 通过拒绝取消，接入退费与课时审计）
后续新增功能所有套餐均可使用。另提供15天免费试用，无需下载，开通即用。
旗舰版扩容包：旗舰版默认 100 员工，可购买扩容包，每增加 100 人 +¥5,000/年（上限 +500 人），分校数不限制；升级/续费差价自动计算。
14合同与协议管理系统 已上线 V15 更新部分功能 V16 更新部分功能
平台统一维护协议模板，机构与代理商在线签署，签署状态全程可追溯，支持到期/违约终止。彻底替代线下纸质协议，签署即生效、平台可管控，与代理商结算安全形成合规闭环。
协议模板（平台维护）
模板 CRUD：标题 / 正文 / 版本管理（/templates、/templates/:id）
两套协议模板：① 平台-机构入驻协议（type=tenant）② 平台-代理商推广协议（type=agent），均平台统一维护
签署时内容快照留档，后续改模板不影响已签协议
在线签署
机构端签署平台协议（/tenant/:id/sign、/tenant/mine）
代理商端签署推广协议（/agent/:id/sign、/agent/mine）
「我的协议」随时查阅签署状态与历史版本
状态与终止
状态机：待签署 / 已签署 / 已终止
终止（/:id/terminate）：到期不续或违约时平台操作终止
签署与终止记录留痕，审计可追溯
合规价值
平台-机构、平台-代理商权责书面化、可举证
签署即绑定租户 / 代理商身份，防抵赖
与代理商结算安全三层加固（二次密码 / 冷却 / 平台审核）形成闭环
学员结业证书
三类证书：结业证书 / 技能等级证书 / 优秀学员证书，支持单个与批量开具
证书编号租户内防重号，重复开具自动跳过
状态管理：已发放 / 撤销发放 / 作废
打印与另存 PDF：A4 横版证书版式，单张或批量打印，浏览器打印对话框可直接存 PDF
14.1 法大大电子合同（V16 新增）
学员协议电子签
机构填法大大 AppID 后，学员协议可发起 EUI 嵌入签署（实名 + 意愿认证 + 全流程存证）
模板模式（推荐）/ 上传 PDF 模式双通道，真实 FASC 5.0 接入，凭据机构自填、零硬编码
降级与存证
未配置法大大或异常时自动降级原手写签名，协议不中断
签署完成回调自动下载归档，出具第三方存证编号与存证链接，可作为维权证据
15审批流与工作流 已上线
统一的审批引擎，支撑人事请假/加班审批，并已接入 CRM 退费审批、课时变更审计等关键资金/课时业务流程。申请人提交 → 指定审批人 → 通过 / 拒绝 / 取消，全程状态可见、可追溯、可审计。
审批引擎
审批人配置（/approvers）：按业务设置审批链
申请列表与详情（/、/:id）
审批动作：通过（/approve）/ 拒绝（/reject）/ 取消（/cancel）
已接入业务
人事：请假 / 加班申请与主管审批
CRM 退费：退款申请进入审批（/crm/refunds/:id/approve|reject）
课时变更审计：课时增减须审批（/crm/hour-audits/:id/approve|reject|cancel）
调课/停课申请：OA 审批通过后自动执行实际改排课（回滚已扣课时、回退旧考勤、写变更日志、给家长发微信调课通知）
请假单支持自定义字段：提交时填写管理员自定义字段，审批详情可见（自定义字段通用引擎接入实体）
假期额度审批联动：通过自动扣减、撤销自动回补
16租户全生命周期管理（平台后台）已上线
16.1 开通新机构流程
1
填写机构信息
输入机构名称、设置工作区代码（6位数字，可自动生成或自定义）、选择套餐、填写管理员账号和密码
2
自动生成凭据
保存后系统弹出交付信息卡：域名地址、工作区代码、管理员账号、初始密码。一键复制全部信息发送给客户
3
机构管理员登录
访问机构登录页，输入工作区代码 + 管理员账号密码即可登录。系统预置默认管理员角色，包含全部权限
4
机构自主使用
管理员添加员工账号 → 员工登录后即可使用全部功能模块（CRM / EDU / FIN / KPI / PSI / ORG / HR / 考勤等）
16.2 登录方式
| 入口 | 登录方式 | 说明 |
|---|
| 平台管理后台 | 账号 + 密码 | 平台运营方使用。默认账号：admin / admin123。管理所有租户、套餐、代理商 |
| 机构登录页 | 工作区代码 + 账号 + 密码 | 机构员工使用。输入工作区代码（如 235608），再输入个人账号密码。若机构已绑定自定义域名，访问该域名登录页时"工作区代码"框会自动隐藏，只需输入账号密码 |
| 代理商后台 | 手机号 + 密码 | 代理商使用。访问 /agent 页面登录，查看推荐机构和佣金 |
| 代理商注册 | 在线注册 | 访问 /register 页面，填写信息提交注册，平台审核通过后可登录 |
| 老师端 | 手机号 + 密码 | 教师使用。访问 /teacher 页面登录，查看课表/班级/考勤/消课 |
| 家长端 | 手机号 + 密码 | 家长使用。访问 /parent.html 页面登录，查看孩子课时/消课/出勤 |
16.3 日常管理
| 管理项 | 操作 | 说明 |
|---|
| 创建机构 | 填写表单 → 保存 → 弹出交付信息卡 | 自动生成工作区代码、管理员账号，弹窗一键复制凭据发送客户 |
| 编辑机构 | 修改名称/套餐/状态/工作区代码 | 支持修改工作区代码、套餐升降级、启停机构 |
| 租户列表 | 查看所有租户 · 搜索/筛选 | 机构名称、工作区代码、管理员、开通时间、套餐、到期日、状态 |
| 运营大盘 | 跨租户运营总览 | 总租户数、活跃率、员工数、学员数、线索数、订单总额、已回款、试听预约 |
| 套餐配置 | 平台管理员可见套餐详情 | 4档套餐：创业版/成长版/进阶版/旗舰版，功能全部一致，仅限人数和分校数；旗舰版支持扩容包 |
| 代理商管理 | 查看代理商列表 · 审核注册 | 代理商信息、推荐机构数、佣金总额、结算状态 |
| 平台财务 | 收入统计 · 租户缴费 | 平台总收入、各套餐收入分布、租户缴费记录 |
| 系统配置 | 平台级参数配置 | 重复学员检测、自动释放时长、机构页脚文字等 |
16.4 平台运营增强
运营数据
月度趋势（/platform/monthly-trend）：租户数 / 活跃 / 营收逐月走势
批量统计（/platform/stats）：跨租户运营指标汇总
机构自助与服务
重置密码 / 手机（/platform/tenants/:id/reset-password、/reset-phone）
套餐升级（/platform/tenants/:id/upgrade）：升降级差价自动计算
机构上传 logo（/tenant/upload-logo）：品牌自定义
登录页品牌适配：走主域名登录时也显示机构自定义 Logo 与登录标题
16.5 数据字典与平台配置
数据字典统一入口
「数据字典」弹窗一处管全部：字段选项（退费原因 / 来源 / 行业 / 班次 / 意向课程）、客户状态显示名、跟进结果显示名、自定义字段
撤掉重复的旧「字段设置」入口，避免两处维护
客户状态与跟进结果仅改显示名、存库值不变，不影响自动流转与历史数据
平台方主体与代注册
平台方（甲方）主体信息可保存：签约主体名 / 信用代码 / 法人 / 地址 / 联系人
代理商代注册租户：代理可为线索机构代注册开通
平台统一运营监控：月度趋势与批量统计口径由平台维护，机构无需也无法自建 KPI 指标（保持全平台口径一致）
17数据隔离与安全
租户隔离
每个租户数据独立存储，CRM客户数据与KPI考核数据均在同一租户空间内，机构间完全不可见。即使URL拼接也无法越权。所有业务表加 tenant_id 索引，查询自动按租户过滤。
权限控制
前端菜单权限 + 后端API权限 + 数据行级权限三重控制。全部功能模块共享同一套角色权限体系，不需要重复配置。bcrypt 加密存储密码，登录失败次数限制防撞库。
操作日志
CRM（线索分配、成交修改、退费）+ KPI（方案变更、结果修改、权限调整）+ 全部关键操作均有日志记录，可追溯到人、到时间、到 IP。
数据备份
每日 03:00 自动备份数据库到本地目录，04:00 自动清理 7 天前的旧备份。租户关停后数据保留 90 天，过期后彻底清除。备份文件按日期命名，可一键恢复。
HTTPS 强制加密
nginx 80 端口自动 301 跳转到 443 HTTPS。Let's Encrypt 免费证书，certbot 自动续期。客户访问永远走加密链路，明文 HTTP 强制转 HTTPS。SSL 证书有效期 90 天，server 端提前 30 天自动续期。
数据校验
订单金额负数拦截、退费金额上限校验、KPI 权重总和 = 100% 校验、员工数量与套餐限额校验、课时数量正数校验——核心字段均有合法性校验，杜绝脏数据进入数据库。
一体化数据引擎的价值
传统方案需要对接6类外部数据源（CRM、排课、财务、考试、问卷、HR）。本平台将其中CRM、教务、财务、进销存4类全部内置，外部对接从6类缩减到2类（考试/问卷可选）。对于只使用本平台的中小机构，实现零外部对接、开箱即用。
18小程序课程预约首页自定义 已上线
各机构的「课程预约」小程序（wxapp-huoji）首页，支持 机构自定义展示文案：顶部标签（heroTags）、福利卡片（welfare）、预约流程步骤（steps）。机构后台「机构设置」提供 JSON 自助配置入口，平台后台可统一配置；小程序端按机构读取展示，字段留空则回落系统默认文案，实现每家机构各自一套首页话术，且全程不出现平台品牌。
机构侧配置
入口：机构后台「机构设置 → 小程序首页文案（JSON）」
三个字段：heroTags（字符串数组）、welfare（{name,desc} 数组）、steps（{t,d} 数组）
留空 = 使用系统默认文案；保存时校验 JSON 合法性
小程序侧消费
onLoad 按机构读取 home 文案并 setData 覆盖
缺字段自动回落本地默认，防脏数据
页面标题 / 文案全品类通用，不出现平台品牌
19问卷调查系统 已上线
机构可创建满意度调查、测评与 NPS 问卷，家长/学员通过公开页（survey-form.html?c=CODE）填写，结果自动回收并汇算 NPS（首个评分题为 NPS 题）。问卷数据回流学员档案，支撑满意度分析与通过率/成绩提升率采集。
机构端配置
入口：OPS「问卷调查」分类卡（survey-manage）
三表模型：surveys / survey_questions / survey_answers
题型：单选/多选/评分/NPS/文本，分享码与回收统计
公开填写与回收
公开填页面 survey-form.html?c=CODE，无需登录
NPS 自动汇算、测评结果回流学员档案
完整部署：挂载路由 + 建表 + 公开入口
20独立老师工作台 已上线
面向独立授课个人/工作室的轻量套餐：¥580/年·1人1校，复用多租户架构、裁剪团队模块、台账制收款。个人用户可独立注册并享 15 天试用，纳入代理商返佣体系。注册入口、landing 套餐卡、菜单白名单、价格真源四处同步上线。
轻量与隔离
¥580/年·1人1校，独立租户、数据隔离
裁剪团队/多角色模块，聚焦个人教学与学员管理
台账制收款，轻运营、零复杂配置
获客与权益
独立注册入口 + landing 套餐卡（4 处真源同步）
注册即 15 天试用，到期可转正
纳入代理商返佣体系，权益确认书平台发起
21营销活动模块 已上线
机构可创建满减、折扣、拼团、秒杀等营销活动，学员在线参与，活动数据回流 CRM 用于转化分析。与积分商城、公众号推送联动，形成招生—转化—复购闭环。
活动创建
满减 / 折扣 / 拼团 / 秒杀多类型
时间窗、适用范围、库存与名额可配
参与与回流
学员端在线参与、分享裂变
参与数据回流 CRM 转化分析
22积分商城模块 已上线
机构可配置积分规则、上架积分商品、管理兑换与账户，家长/学员在积分商城用行为积分兑换权益。积分引擎联动消课与财务（双轨记账），券类发放只写 marketing_coupon_grants，避免与课程券混用。
规则与商品
6 表 point_*：规则/商品/兑换/账户等
积分获取规则 + 商品上架 + 兑换管理
引擎与对账
积分引擎钩子接 consumeEngine / edu / crm
联动财务 records；券类只写 marketing_coupon_grants
23AI 大模型接入 已上线
平台接入大模型能力，覆盖话术生成、跟进建议、营销文案、报表解读、学员预警、招生方案六类场景，自动产出机构经营月报与平台月报。机构端与平台端均提供模型配置 UI，可切换模型与额度。
六大场景
话术生成 / 跟进建议 / 营销文案
报表解读 / 学员预警 / 招生方案
AI 诊断智能体：问卷自动诊断优化点
月报与配置
双月报：机构经营月报 + 平台月报
机构端 / 平台端配置 UI 全上线
24智能硬件对接 已上线
打通三类教培常用硬件：人脸考勤机（设备对接 + 考勤打卡落 edu_attendance）、云打印（证书/合同/课时表一键打印）、学员码扫码枪（scan_code 扫码签到）。硬件三件套第一步已上线，后续扩展更多设备协议。
考勤与打印
人脸考勤机：对接 + 打卡落 edu_attendance
云打印：证书 / 合同 / 课时表一键出
扫码签到
学员码扫码枪：scan_code 扫码签到
硬件三件套第一步，协议持续扩展
25自动触达 SOP 模板库 已上线
机构可创建可复用的触达剧本（SOP），编排节点、触发条件与渠道（待办 / 企微 / 公众号），一键套用到学员生命周期阶段（试听未成交、待续费、沉睡唤醒等），实现招生—转化—留存全链路自动化跟进。
剧本编排
节点 / 条件 / 渠道可视化编排
模板库沉淀、可复用可复制
生命周期触发
一键套用到学员生命周期阶段
与每日跟进推送、企微群打通
26学员端督学体系 已上线 V17.0 全新模块
对标 Forest / 番茄 ToDo 的学员端专注督学，把"学习过程"游戏化、可视化、可监管。学员用手机浏览器打开 student-focus.html 即可体验（用机构账号登录，专注数据按租户隔离）；机构、老师、平台三端可跨端管理同一批学员的督学状态。已全链路端到端可用、可演示、可测。
为什么做学员端督学
教培机构的核心交付是"学员是否真的在学"。本模块把专注时长、习惯、自习、考试节点全部在线化，家长/老师看得见、机构管得了、学员有动力——是机构续费留存与口碑的关键抓手。
26.1 学员端核心体验（Forest 式专注）
专注种树
计时专注 + 成长树动画（径向蓬松树冠）；五模式种五棵不同的树（原木/尖塔/铁塔/云朵/并生，配色各异），专注越长树越茂盛。
我的任务
新建/完成；列表行内「开始」直接专注、点开任务详情可手动「标记为完成」；关联任务专注结束可自动完成。
我的森林
成长统计 + 历史树阵，按督学模式展示不同树形，累计专注一目了然。
习惯打卡
习惯养成打卡，连续天数正确统计，形成正向反馈闭环。
考试倒计时
学员自定义考试名 + 时间，每秒刷新；数据存服务器（换设备/换浏览器仍可见），临近 3 天红色提醒。
主题与「我的」
绿/蓝/青/紫/橙 5 色主题持久化；「我的」页收纳账号、督学模式、主题色、头像、屏幕常亮、退出登录。
26.2 自习室（机构/教师建 · 学员加入）
创建与配置
教师端 / 机构后台 SPA 均可创建：填名称 + 简介 + 自定义人数上限 ≤ 200（默认 50，超 200 自动钳制）；满员真实拦截（409）。
加入与互动
学员端仅「输邀请码加入」（权限收紧，避免随意建室）；详情页 MVP 排行榜（成员时长/连续天数/奖牌）；同室在线人数、退出按钮、自定义头像上传。
26.3 督学模式（五模式 · 硬行为差异化）
五模式差异化
自由 / 学霸 / 严格 / 安心 / 陪跑，整页换色 + 行为差异：学霸（目标进度条）、严格（离场锁屏遮罩 + 心跳上报）、安心（极简 + 白噪音）、陪跑（同频专注脉冲）；各模式时长独立累计看板。
三端管理入口
学员端自取按模式渲染；教师端 / 机构后台「督学服务」设档（覆盖全部学员 ?all=1）；平台壳跨租户选机构设档。机构可锁定学员自改、解锁时学员端自行切换。
陪跑实时轮询：同租户当前在专注的同伴实时同步（count + 名单），脉动节奏随在线人数动态变化。
各模式时长看板：机构 / 老师后台可见每个学员在各模式下的累计专注分钟，家长视图自适应。
26.4 督学闭环与监管（防作弊四层防线）
老师 / 家长督学看板：班级专注排行（在学人数 / 今日专注合计 / 累计树木 + 前三金银铜），scope 自适应 teacher / parent。
防作弊四层：①机构下发带标准任务 ②心跳 + 离场留痕 ③达标才放行 ④机构端核验看板（风险分级 danger/warn/ok/none + 证据，驳回即作废）。专注时长按实际耗时记账并已重算历史，杜绝虚高。
学员端专属督学账号：运营工具 → 人员账号下新增"督学账号"开户体系（此前全站无学员端开户入口），绑定学员后即可独立登录学员端。
CRM 学员 360° 详情 · 督学穿透：第 7 页签「督学」+ 头部摘要；穿透扩至 12 目标（考勤 / 消课 / 欠费 + 课时审批 / 奖励审批 / 退费 / 续费 / 投诉 / 售后 / 收支 / 发票 / 保险）。
27DDL 课件生产体系 已上线 V18.0 全新模块
把"老师的自有讲义"直接变成"能上课的课件"。机构把讲义正文粘进系统，AI 结构化成课件大纲，在线轻编辑器可改，导出为 PowerPoint/WPS 能直接打开的 .pptx，也可反向导入已有 pptx / PDF 还原成可编辑课件，最后分发到学员端。全链路已端到端可用、可演示、可测。
为什么做课件生产体系
教培机构最大的隐性成本是"备课"。但教培机构**没有自己的版权教材内容**——教研产能的唯一合法来源是老师自己的讲义。所以这套体系不生产内容，只做结构化与呈现：AI 只把老师写好的讲义整理成课件骨架，剩下的编辑、排版、分发都在平台完成。
27.1 讲义 → 课件（AI 结构化）
AI 结构化：粘贴讲义正文 → 输出课件大纲 JSON（页 / 版式 / 元素 / 坐标 / 样式），一键落库生成课件记录。
合规红线（硬约束）：AI 只允许结构化老师自有讲义，严禁抓取教材 / 真题 / 押题 / 竞品题库；内置模板全部为纯占位文本。导出物 .pptx 绝不导回系统（防内容回流污染真源）。
真源唯一：全部内容存一份 slideDoc JSON（画布 1280×720 像素坐标，导出按 13.333×7.5 英寸等比映射），编辑 / 预览 / 导出三端口径一致。
27.2 在线课件编辑器
画布与元素
1280×720 画布等比缩放；文本框 / 形状（23 种 prst 几何）/ 图片；拖拽定位、改字号颜色加粗对齐、旋转、镜像、描边（虚线 / 箭头 / 渐变）、渐变填充、阴影辉光、羽化倒影。
图库与图片
图片按租户隔离存储于本机构目录（仅本课件可见），预览走鉴权接口，导出层直读盘；支持替换上传（≤5MB，png/jpg/gif）。
模板套用
内置 3 套视觉模板（考试风 / 极简 / 图文混排）一键套用，只换样式不丢内容；换色 / 换底 / 装饰线随模板联动。
27.3 导入：已有 pptx / PDF → 可编辑课件
pptx 导入（零依赖解析）
纯 Node 手写解析 OOXML，不装任何第三方库；还原项目符号、多 run 异色拆分、形状旋转、prstGeom 形状类型、水平/垂直镜像、渐变填充 + 描边、径向渐变 + alpha 透明度、阴影 a:effectLst、主题色 sysClr/schemeClr/prstClr、自动编号 buAutoNum、虚线/箭头描边、辉光、softEdge 羽化 + reflection 倒影、多级编号 + 多阴影 + 描边渐变，共 十四项保真增量。
PDF 导入
自写 PDF 解析器（传统 xref / xref 流 / 对象流 / 增量更新 / ToUnicode 中文 CID / 完整图形状态机 / 路径→形状 / 内嵌图片抽取 + 手写 PNG 编码器），把 PDF 页面还原为可编辑元素。
27.4 模板市场（平台内置 + 机构自有）
12 套内置脚手架
封面 / 章节 / 内容 / 图文 / 金句 / 结尾 六类，纯占位文本，合规不碰教材真题；列表支持分类筛选。
机构自有模板
当前课件可"存为机构模板"（按课件 ID 幂等入库），团队内复用；仅机构自有可删，平台内置与他人模板受保护。
一键克隆
从模板克隆成新课件直接进编辑器改，16:9 缩略预览卡片（自渲染，不依赖外部图片）。
27.5 母版 / 图表 / 动画（排版三件套）
可配母版
底色 / 主题配色 / 字体 / 页脚 + 真实页码域 / 四向装饰条，5 套预设可一键切换；导出时写入 PPTX 主题与母版层。
图表
柱状 / 条形 / 折线 / 饼 / 环形五类，自带标题、图例、数值标签；编辑器内纯 SVG 自绘预览，所见即导出所得。
动画
淡入 / 擦除 / 飞入 / 放大 / 旋转放大五种进入效果，可设延迟、时长与触发方式（单击 / 上一动画后），导出为 PPTX 原生动画时间线。
27.6 学员端课件分发
自动分发：按"所在班 / 课表"自动把课件推送到学员端，学员用手机浏览器即可看；1280×720 画布查看器 + 翻页 + 标记学完。
学习进度闭环：记录学习页码 / 已学完 / 累计学习时长，形成"老师布置—学员学完—机构掌握"的完整链路。
28系统功能模块总览
| 子系统 | 模块 | 状态 | 使用者 | 功能说明 |
|---|
CRM
已上线 |
线索管理 |
已上线 |
招生顾问 / 市场 |
新增线索、CSV批量导入、来源标记、分级标签、线索分配、状态流转、公海回收 |
| 订单与收费 |
已上线 |
教务 / 财务 |
订单管理（金额/支付方式/日期）、回款记录、退费处理、应收实收统计 |
| 学员管理 |
已上线 |
班主任 / 教务 |
学员档案、报读课程、课消记录、剩余课时、试听预约、转介绍追踪 |
| 标签与看板 |
已上线 |
全员(按权限) |
客户标签分类、转化漏斗、线索概览、营收趋势、学员分布 |
| 数据导出 |
已上线 |
管理员 |
CSV导出线索、学员、订单等业务数据 |
| 线索集市 |
已上线 |
招生顾问 / 市场 |
跨机构线索共享池：提交让渡、免费领取、贡献积分与信誉等级、8 维度筛选、撞单防护、领取前仅返回标签画像（合规隐私保护） |
EDU
已上线 |
课程管理 |
已上线 |
教务 |
课程创建与分类、课时单价/总课时设置、关联学员与教师 |
| 排课管理 |
已上线 |
教务 / 教师 |
班级排课、教师排班、教室管理、冲突检测、调课/补课/代课 |
| 考勤管理 |
已上线 |
教师 / 班主任 |
考勤记录（到课/缺勤/请假）、消课扣课时、课表视图（周/月） |
| 班级管理 |
已上线 |
教务 |
班级创建、班级学员名单、班级课程关联 |
FIN
已上线 |
收支流水 |
已上线 |
财务 |
收款登记、支出记录、应收/实收汇总统计 |
| 员工工资 |
已上线 |
管理员 / 财务 |
工资条管理、业绩提成核算、薪酬结构配置 |
| 财务概览 |
已上线 |
管理员 |
财务收支总览看板、月度/季度收支对比 |
KPI
已上线 |
指标库 |
已上线 |
平台方维护 |
10 大岗位模板 / 54 项通用指标（含名称、公式、适用场景、数据来源说明），内置于 server/routes/kpi.js 顶部 KPI_TEMPLATES，平台发版统一维护 |
| KPI方案 |
已上线 |
机构管理员 |
从指标库勾选指标、按角色配置权重、设定目标值、考核周期 |
| 评分与排名 |
已上线 |
系统自动 |
从CRM自动取数 → 按配置规则计算得分 → 评级 → 排名看板 |
| 薪酬联动 |
已上线 |
机构管理员 |
绩效系数映射、提成规则、薪酬计算（与FIN模块联动） |
PSI
已上线 |
入库管理 |
已上线 |
仓管 / 财务 |
入库登记（产品/数量/供应商/金额） |
| 出库管理 |
已上线 |
仓管 |
出库登记（领用类型/数量/领用人）、出库类型追踪 |
| 产品与库存 |
已上线 |
管理员 |
产品分类管理、库存实时更新、库存预警 |
ORG
已上线 |
分校管理 |
已上线 |
管理员 |
多分校架构配置、数据隔离与汇总、分校管理员分配 |
| 员工与角色 |
已上线 |
管理员 |
员工账号管理、自定义角色与权限、一人多角色 |
| 系统配置 |
已上线 |
管理员 |
机构信息设置、操作日志、重复检测、自动释放 |
HR
已上线 |
员工档案 |
已上线 |
管理员 / HR |
员工基本信息、入职/在职/离职状态、岗位/部门归属 |
| 劳动合同 |
已上线 |
管理员 / HR |
合同签订、到期提醒、续签管理 |
| 考勤与工资 |
已上线 |
管理员 / HR |
考勤汇总、工资条管理、与KPI/FIN联动 |
ALT
已上线 |
续费预测 |
已上线 |
班主任 / 管理者 |
7/14/30天三档预警、基于消课速度智能预测 |
| 考勤异常 |
已上线 |
班主任 |
连续缺勤/出勤率低/长期无消课、预警统计卡片 |
MSG
已上线 |
通知中心 |
已上线 |
全员 |
站内通知发布与接收、按角色/全员推送、已读/未读管理 |
| 建议反馈 |
已上线 |
员工 / 管理层 |
员工提交建议、管理层查看与回复、分类与状态跟踪 |
| 家长端 |
已上线 |
家长 |
家长账号登录、课时余额与消课记录、上课出勤情况 |
WeChat
已上线 |
微信服务号 |
已上线 |
机构 / 家长 |
平台共享服务号或机构自配服务号、关注绑定 |
| 模板消息推送 |
已上线 |
系统自动 |
上课提醒（课程开始前自动推送）、消课通知（实时通知剩余课时） |
Teacher
已上线 |
老师端工作台 |
已上线 |
教师 |
教师独立登录（/teacher）、我的课表、我的班级 |
| 课堂考勤与消课 |
已上线 |
教师 |
上课点名、到课登记、消课确认 |
Attendance
已上线 |
考勤打卡 |
已上线 |
全员 |
上班签到、请假申请、加班登记、考勤统计 |
| 审批流 |
已上线 |
员工 / 主管 |
请假/加班等申请提交、主管审批、审批记录 |
协议/知识库
已上线 |
协议管理 |
已上线 |
平台 / 机构 |
平台-机构合作协议、签署状态管理、员工我的协议 |
| 知识库 / FAQ |
已上线 |
全员 |
常见问题自助查询、知识库内容沉淀、使用帮助 |
Agent
已上线 |
代理商注册 |
已上线 |
代理商 |
在线注册（/register）、平台审核 |
| 佣金管理 |
已上线 |
代理商 / 平台 |
推荐机构关联、自动计算佣金、结算记录管理 |
DDL
已上线 |
讲义转课件 |
已上线 |
教研 / 教务 |
粘贴自有讲义 → AI 结构化为课件大纲 → 一键生成课件记录 |
| 课件编辑器 |
已上线 |
教研 / 教务 |
1280×720 画布在线编辑（文本/形状/图片/图表）、样式、旋转镜像、渐变描边、阴影羽化倒影 |
| 课件导入 |
已上线 |
教研 / 教务 |
已有 pptx（十四项保真还原）/ PDF 零依赖解析为可编辑课件 |
| 模板市场 |
已上线 |
教研 / 教务 |
12 套内置脚手架（封面/章节/内容/图文/金句/结尾）、机构自有模板、一键克隆 |
| 母版 / 图表 / 动画 |
已上线 |
教研 / 教务 |
可配母版（配色/字体/页脚页码/装饰条）、五类图表、五种进入动画，导出为 PPTX 原生能力 |
| 学员端课件 |
已上线 |
学员 |
按班级/课表自动分发、手机端查看、翻页与标记学完、学习进度回传 |
29API接口清单
系统共注册45+组API路由，覆盖全部业务模块。所有API需认证访问（JWT Token），未认证请求返回401。含 CRM 客户生命周期配置 / 公海自动回收 / 订单金额校验 / 地推业绩统计等接口；合同与协议系统、审批流引擎、CRM 增强（自定义字段/课时审计/续费预测/退费审批）、财务/人事/租户运营增强、代理商结算安全等一批接口。
| 路由 | 模块 | 说明 |
|---|
| /api/auth | 认证 | 登录、注册、Token验证 |
| /api | 租户管理 | 机构CRUD、套餐分配、运营大盘 |
| /api/branches | 分校 | 分校创建与管理 |
| /api/users | 用户 | 员工账号管理、角色分配 |
| /api/crm | CRM | 线索/学员/订单/退费/试听/标签/公海/投诉 |
| /api/kpi | KPI | 指标库/岗位模板/方案/评分/排名 |
| /api/finance | FIN | 收支流水/盈亏/工资/业绩提成 |
| /api/edu | EDU | 课程/排课/考勤/班级/消课 |
| /api/psi | PSI | 入库/出库/产品/库存/供应商 |
| /api/hr | HR人事 | 员工档案/劳动合同/考勤/工资 |
| /api/attendance | 考勤打卡 | 签到/请假/加班/考勤统计 |
| /api/approvals | 审批流 | 请假/加班申请、主管审批 |
| /api/wechat | 微信服务号 | 服务号绑定、上课提醒/消课通知推送 |
| /api/teacher | 老师端 | 教师课表/班级/考勤/消课 |
| /api/logs | 日志 | 操作日志记录与查询 |
| /api/platform-config | 配置 | 平台级系统参数配置 |
| /api/platform-finance | 平台财务 | 平台收入统计、租户缴费 |
| /api/suggestions | 建议反馈 | 建议提交、查看、回复 |
| /api/notifications | 通知 | 站内通知发布、接收、已读 |
| /api/export | 导出 | CSV数据导出 |
| /api/parent | 家长端 | 家长登录、查看孩子课时/消课/出勤 |
| /api/agents | 代理商 | 代理商注册/登录/推荐/佣金 +地推业绩 |
| /api/agents/bank-changes | 结算安全 | 改卡待审列表 / 平台审核通过 / 拒绝（收款账户变更须平台审核） |
| /api/agreements | 协议 | 平台-机构协议、签署状态、我的协议 |
| /api/crm/lifecycle-config | CRM 生命周期 | 租户级生命周期参数配置（27 项） |
| /api/crm/promo-stats | 地推 | 推荐人业绩统计与报酬计算 |
| /api/hr/my-salaries | 自助 | 员工自助查询个人工资条 |
| /api/faq | 帮助 | 常见问题查询（租户/平台级） |
| /api/faq/agent | 代理商 | 代理商帮助中心问答查询（20 条常见问题，target=agent） |
| /api/knowledge | 知识库 | 知识库内容管理与查询 |
| /api/agreements | 协议 | 模板CRUD / 机构·代理商在线签署 / 终止（含 /templates、/tenant|agent/:id/sign、/:id/terminate） |
| /api/approvals | 审批流 | 申请 / 审批人 / 通过 / 拒绝 / 取消，已接入退费与课时变更审计 |
| /api/crm/* | CRM增强 | 自定义字段 / 课时审计 / 续费预测 / 退费审批 / 生命周期配置 / 推广统计 / 线索批量分配·导入·公海 / 试听 / 预警 / 投诉 |
| /api/finance/* | FIN增强 | 分校盈亏 / 收支分类 / 工资 / 记账复核 / 员工业绩 / 总览对比 |
| /api/hr/* | HR增强 | 考勤明细 / 合同上传 / 工资模板批次 / 课时费 / 头像 / 自助工资条 |
| /api/tenants/* | 平台运营 | 月度趋势 / 批量统计 / 重置密码手机 / 套餐升级 / 机构 logo |
| /api/agents/* | 代理商 | 结算安全（二次密码 / 冷却 / 改卡平台审核）/ 代理商合同 / 代注册租户 / 返佣按自然月批量结算、次月 20 日开放结算 |
| /api/slides | DDL课件 | 讲义→课件生成 / 课件列表 / 取详情 / 保存编辑 / 导出 .pptx / 下载 .pptx / 删除 |
| /api/slides/templates | 模板市场 | 模板列表（分类筛选）/ 一键克隆 / 存为机构模板 / 删除（仅机构自有可删） |
| /api/slides/import-pptx · /import-pdf | 课件导入 | 已有 pptx / PDF 零依赖解析为可编辑课件（pptx 十四项保真还原） |
| /api/slides/:id/image · /media/:file | 课件图库 | 图片上传（租户隔离，仅本课件可见）/ 鉴权读图 |
| /api/student/slides | 学员端课件 | 学员课件列表 / 取内容 / 上报学习进度（页码 / 学完 / 时长） |
| /api/export | 数据安全 | 数据导出中心：15 类后端导出 + 前端 28 项分组入口，租户隔离核验 |
| /api/platform-config/ai-models | 模型配置 | AI 适配层读注册表，平台后台可切换模型 |
30实施路径
V17.0 新增/变更（相对 V16.0，2026-10-24 → 2026-10-27）
学员端督学体系（全新模块，对标 Forest）
专注种树（五模式种五棵不同树）/ 我的任务（行内开始 + 任务详情手动完成）/ 我的森林 / 习惯打卡 / 考试倒计时（数据存服务器换设备可见）
自习室：教师/机构创建（简介 + 人数上限≤200）、学员输邀请码加入、详情排行榜、同室在线、退出、自定义头像
督学模式五模式（自由/学霸/严格/安心/陪跑）硬行为差异化；三端入口（学员自取 / 教师·机构设档 / 平台跨租户）；机构锁 + 各模式时长看板
陪跑实时轮询（同频专注同伴实时同步）；老师/家长督学看板（班级专注排行金银铜）
防作弊四层防线（下发任务/心跳留痕/达标放行/核验看板风险分级）；专注时长按实际耗时记账并重算历史
学员端专属督学账号开户体系；CRM 学员 360° 详情「督学」页签 + 12 目标穿透
V18.0 新增/变更（相对 V17.0，2026-10-28 → 2026-10-30）
DDL 课件生产体系（全新模块，第 27 章）
讲义→课件：AI 只结构化老师自有讲义，输出 slideDoc JSON 真源（1280×720 画布坐标），生成 / 编辑 / 导出口径一致
在线轻编辑器：文本 / 形状（23 种几何）/ 图片（租户隔离）/ 拖拽定位 / 旋转镜像 / 渐变描边 / 阴影辉光 / 羽化倒影
导入保真：pptx 零依赖解析还原十四项（项目符号 / 异色 run / 旋转 / prstGeom / 镜像 / 渐变 / 透明度 / 阴影 / 主题色 / 自动编号 / 虚线箭头 / 辉光 / 羽化倒影 / 多级编号）；PDF 自写解析器（xref 流 / 对象流 / 增量更新 / 中文 CID / 图形状态机）
模板市场：12 套内置脚手架（六类）+ 机构自有模板 + 一键克隆；seed 已落部分唯一索引，重启不翻倍
排版三件套：可配母版（配色 / 字体 / 页脚 + 真实页码域 / 四向装饰条）+ 五类图表（柱条折线饼环）+ 五种进入动画（淡入/擦除/飞入/放大/旋转）
学员端分发：按班级/课表自动推送，手机端查看器 + 翻页 + 标记学完 + 进度回传
数据安全与平台能力
数据安全中心导出补全：15 类后端导出 + 前端 28 项分组入口，租户隔离核验 + 扇出 bug 修复
AI 适配层改读 platform_config 注册表，平台后台「模型配置」可切换
全站手机号归一化：粘贴带空格 / 横杠自动清理，归一口径与发码验码一致
租户密码查询与重置；小程序订阅消息通知接入配置化；推荐代理三项（退款作废联动 / 推广记录隐私化 / 推荐同行业绩）
基建治理：DB 缺失租户索引告警（MISSING_TENANT_IDX）+ staging schema 漂移修复（只同步 schema 不整库覆盖）