组班云 · 功能需求文档

需求描述：机构按批次快速组建临时班级；班级内提供在线视频课堂与在线课件，学员报名入班即可学习。批次天然具备明确的生命周期，为 FR-06「结课解散」提供对象基础。

业务规则与边界：

• 容量满员后报名自动截止并提示；是否允许候补可配置；
• 未缴费学员是否可预览课件/视频由批次配置决定（默认不可）；
• 批次结束日期必须晚于开班日期；结课后内容访问按 FR-06 规则关闭。

验收标准：管理员 5 分钟内完成建班并拿到报名码；学员报名入班后可观看被授权的课件与视频；播放进度可被 FR-04 采集。

需求描述：培训师生通过腾讯会议在线开培训会议；腾讯会议的录屏自动上传到该临时组班的「课后在线会议」中，供学员回看，形成班级课程资产。

业务规则与边界：

• 录播可见范围 = 该批次在班学员；批次解散后按 FR-06 归档策略处理；
• 仅支持腾讯会议云端录制；本地录制提供管理员手动上传兜底入口；
• 录制文件涉及个人信息，存储与播放链接需鉴权防盗链。

验收标准：一场腾讯会议结束后，录播在约定时限（默认 ≤ 30 分钟）内自动出现在该批次课后在线会议中并可播放；失败场景有重试记录与告警。

需求描述：临时学员报名后在线支付培训费用；费用方案（金额、科目、优惠）由管理员配置，支付结果实时驱动入班。

业务规则与边界：

• 费用配置修改只对「未支付订单」生效，已支付订单不可篡改；
• 支付回调必须验签 + 幂等处理，重复回调不重复入班；
• 0 元批次（免费课）跳过收银台直接入班，但仍生成 0 元订单以便对账。

验收标准：管理员改价即时生效；学员全链路「报名 → 缴费 → 入班 → 凭证」无人工干预完成；订单、流水、渠道账单三方一致。

需求描述：老师拥有自己的工作台：管理自己的学员与课程，查看学员学习分析与班级进度报告，教学效果数据化。

业务规则与边界：

• 老师仅可见「自己作为授课老师绑定」的班级数据，禁止跨班越权；
• 学习分析为 T+0 准实时（事件驱动），结课报告为批次结束后一次性生成；
• 多老师同班时（主讲/助教）按匹配方式（FR-05）划分数据可见范围。

验收标准：学员产生学习行为后，老师在班级学情页可看到对应统计变化；结课后自动产出该班结课进度报告。

需求描述：平台为多租户 SaaS 架构：多个机构（租户）共用平台但数据隔离；每租户内多老师、多学员，通过灵活的「匹配方式」把老师、学员、课程、批次组合到一起；平台管理员统一管理全部租户。

业务规则与边界：

• 同一手机号（学员）可跨租户、跨批次存在，账号全局唯一、身份按租户隔离；
• 老师可被多个租户邀请授课，其课酬按租户分别结算；
• 租户停用后只读保留数据，恢复后无缝续用。

验收标准：两个租户并行运营互不可见（接口越权测试全部拒绝）；四种学员入班方式全部可用；平台控制台可查看租户级运营概览。

需求描述：每个批次有明确的结束日期，到期后自然进入「结束」状态：报名关闭、在线课程与会议入口随之关闭，班级完成使命后解散归档 —— 这是本产品与传统 LMS 的根本区别。

业务规则与边界：

• 到期判定以批次结束日期 24:00 为准，定时任务幂等、可补跑；
• 解散不可撤销；归档数据保留期限遵循租户协议与个人信息保护要求；
• 解散后学员账号不受影响，仍可报名其他批次。

验收标准：构造到期批次，24 小时内自动进入「已结束」且课程访问关闭；未完成结算的批次不能进入「已解散」；归档后财务数据仍可完整查询。

需求描述：平台提供统一财务中心，覆盖培训收入从「入账」到「落袋」的完整链路：逐笔对账、按批次结账、余额提现，让每一场临时培训都可核算。

业务规则与边界：

• 所有资金操作只增不改：冲正以红字流水实现，保证审计可回放；
• 退款优先从冻结/未结算金额扣减；余额不足时挂起并通知；
• 涉及资金二清合规问题：平台侧采用「持牌支付机构分账/代付」通道，具体通道接入前需合规评审。

验收标准：任一订单可完成「渠道账单 = 平台流水 = 业务订单」三方核对；批次结课到结算单生成全自动；提现全流程（申请 → 审批 → 打款 → 记账）闭环留痕。