迪诺学堂标识

05-教务教学中心详细PRD

EDU · 管理课程、班级、排课、调课、请假、补课、签到、课消、课堂点评和作业测评。

系统 迪诺学堂
版本 v1.0
日期 2026-06-23
阶段 模块详细 PRD

01 · 模块定位

教务教学中心

合同激活后可入班排课，学员签到后自动课消，教师完成课堂点评并进入学员学习档案。

业务目标

管理课程、班级、排课、调课、请假、补课、签到、课消、课堂点评和作业测评。

使用终端

PC Web 教务工作台、教师/员工 App、家长端通知、学员端学习入口。

验收主线

合同激活后可入班排课，学员签到后自动课消，教师完成课堂点评并进入学员学习档案。

02 · 范围边界

明确本模块负责什么、依赖什么、不负责什么

边界清晰后，原型、接口和数据库设计才能避免重复建设。

模块内范围

  • 课程班级
  • 排课引擎
  • 签到课消
  • 请假补课
  • 课堂反馈
  • 测评作业
  • 直播课务编排
  • 请假审批
  • 补课安排池
  • 补课课次确认
  • 转班转课测算
  • 调班调课执行
  • 试听到访签到
  • 试听反馈评价
  • 补课改期取消
  • 补课重新安排
  • 补课课消冲正

上游依赖

  • 组织校区与账号权限
  • 课程/客户/合同等主数据
  • 审批流、消息模板、文件中心
  • 必要的第三方接口密钥

下游输出

  • 业务状态和待办
  • 消息通知和审批记录
  • 报表指标和数据快照
  • 审计日志和接口回执

03 · 确认口径、后台配置与默认实施规则

教务教学中心必须承接的已确认规则

本章节来自待决策与澄清清单的收口结果，已经转为本模块 PRD 的正式需求、配置项或默认实施规则。
分类事项本模块落地要求责任方
默认实施规则接口设计说明书组织方式采用单独 HTML 文件集中管理接口协议；模块 PRD 保留模块级接口摘要，避免每个模块重复写通用协议。产品/研发
默认实施规则接口错误码与重试中间件所有外部接口和内部异步任务统一错误码、幂等键、重试次数、告警阈值和回执归档策略。后端/测试/运维

04 · 业务流程

教务教学中心主流程

流程用于指导原型图的页面顺序、按钮状态和异常分支。
01课程班级

课程班级需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。

02排课引擎

排课引擎需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。

03签到课消

签到课消需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。

04请假补课

请假补课需形成从家长申请、教务审批、课消回滚或冻结、补课安排、家长确认、教师执行到补课完成的完整闭环。

05课堂反馈

课堂反馈需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。

06测评作业

测评作业需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。

07直播课务编排

直播课务编排需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。

08请假审批

请假审批需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。

05 · 功能清单

按子模块拆到可设计、可开发、可测试的颗粒度

每一行功能都需要在原型中体现入口、状态、按钮、字段和反馈。
一级功能二级功能功能说明规则/验收
课程班级基础维护课程班级支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
课程班级业务处理课程班级需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
课程班级异常闭环排课冲突处理失败原因可见、可重试、可转人工、可追溯
排课引擎基础维护排课引擎支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
排课引擎业务处理排课引擎需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
排课引擎异常闭环签到异常处理失败原因可见、可重试、可转人工、可追溯
签到课消基础维护签到课消支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
签到课消业务处理签到课消需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
签到课消异常闭环课消待确认处理失败原因可见、可重试、可转人工、可追溯
请假补课基础维护请假补课支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
请假补课业务处理请假补课需形成从家长申请、教务审批、课消回滚或冻结、补课安排、家长确认、教师执行到补课完成的完整闭环。必须联动状态、权限、消息、审批和指标
请假补课异常闭环补课时间未确认处理失败原因可见、可重试、可转人工、可追溯
课堂反馈基础维护课堂反馈支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
课堂反馈业务处理课堂反馈需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
课堂反馈异常闭环补课课次容量不足处理失败原因可见、可重试、可转人工、可追溯
测评作业基础维护测评作业支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
测评作业业务处理测评作业需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
测评作业异常闭环教师课表冲突处理失败原因可见、可重试、可转人工、可追溯
直播课务编排基础维护直播课务编排支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
直播课务编排业务处理直播课务编排需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
直播课务编排异常闭环转课补差未支付处理失败原因可见、可重试、可转人工、可追溯
请假审批基础维护请假审批支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
请假审批业务处理请假审批需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
请假审批异常闭环试听未到访处理失败原因可见、可重试、可转人工、可追溯
补课安排池基础维护补课安排池支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
补课安排池业务处理补课安排池需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
补课安排池异常闭环试听反馈缺失处理失败原因可见、可重试、可转人工、可追溯
补课课次确认基础维护补课课次确认支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
补课课次确认业务处理补课课次确认需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
补课课次确认异常闭环补课改期超时处理失败原因可见、可重试、可转人工、可追溯
转班转课测算基础维护转班转课测算支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
转班转课测算业务处理转班转课测算需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
转班转课测算异常闭环补课已课消取消处理失败原因可见、可重试、可转人工、可追溯
调班调课执行基础维护调班调课执行支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
调班调课执行业务处理调班调课执行需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
调班调课执行异常闭环补课资源释放失败处理失败原因可见、可重试、可转人工、可追溯
试听到访签到基础维护试听到访签到支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
试听到访签到业务处理试听到访签到需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
试听到访签到异常闭环排课冲突处理失败原因可见、可重试、可转人工、可追溯
试听反馈评价基础维护试听反馈评价支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
试听反馈评价业务处理试听反馈评价需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
试听反馈评价异常闭环签到异常处理失败原因可见、可重试、可转人工、可追溯
补课改期取消基础维护补课改期取消支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
补课改期取消业务处理补课改期取消需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
补课改期取消异常闭环课消待确认处理失败原因可见、可重试、可转人工、可追溯
补课重新安排基础维护补课重新安排支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
补课重新安排业务处理补课重新安排需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
补课重新安排异常闭环补课时间未确认处理失败原因可见、可重试、可转人工、可追溯
补课课消冲正基础维护补课课消冲正支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
补课课消冲正业务处理补课课消冲正需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
补课课消冲正异常闭环补课课次容量不足处理失败原因可见、可重试、可转人工、可追溯

功能到数据对象/接口/表映射

功能域承接对象核心表代表接口状态机/状态字段研发落地校验
课程班级Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/01course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
排课引擎Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/02course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
签到课消Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/03course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
请假补课Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/04course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
课堂反馈Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/05course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
测评作业Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/06course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
直播课务编排Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/07course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
请假审批Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/08course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
补课安排池Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/09course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
补课课次确认Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/10course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
转班转课测算Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/11course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
调班调课执行Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/12course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
试听到访签到Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/13course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
试听反馈评价Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/14course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
补课改期取消Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/15course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
补课重新安排Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/16course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
补课课消冲正Course/Product、CoursePackage、Class、Schedule/Lessonedu_course、edu_product_package、edu_class、edu_lesson接口资源组 /api/v1/edu/features/17course_type、class_status、lesson_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计

06 · 原子级功能需求

用于研发任务拆分和测试用例追踪

需求编号可直接进入项目管理工具。
编号需求描述入口页面关键动作输入校验输出结果异常处理验收标准
FR-EDU-001支持一对一、小组课、班课、体验课、公开课、线上课和录播课公开课直播转化观看评分、意向标签或顾问跟进校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务线索沉淀失败或跟进任务未分配主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-EDU-002排课检测教师、教室、学员、助教、设备和营业时间冲突签到处理排课调课校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务签到异常主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-EDU-003请假、补课、插班、转班、调课均需记录规则和审批请假补课/补课安排请假审批、补课安排或家长确认校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务补课时间未确认、候选课次过期或课消回滚失败主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-EDU-004人工签到和人脸签到均可进入课消规则人脸授权撤回任务授权撤回、模板删除或失败重试校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务设备离线、删除回执缺失或模板删除失败主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-EDU-005教师填写课堂点评、作业批改、测评和学习反馈作业草稿箱/作业提交保存草稿、恢复草稿或提交作业校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务草稿冲突、附件失败或作业已关闭主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-EDU-006请假补课需形成从家长申请、教务审批、课消回滚或冻结、补课安排、家长确认、教师执行到补课完成的完整闭环。请假补课/补课安排请假审批、补课安排或家长确认校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务补课时间未确认、候选课次过期或课消回滚失败主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-EDU-007补课安排必须提供独立入口，用于兜底学员请假时无法立即确认补课时间的场景，支持待安排池、推荐课次、人工安排和超时提醒。请假补课/补课安排请假审批、补课安排或家长确认校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务补课时间未确认、候选课次过期或课消回滚失败主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-EDU-008转班、转课、调班、调课需联动课表、班级容量、教师冲突、合同权益、优惠分摊、补差或退差和家长确认。转班转课测算权益重算、补差退差或课表调整校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务班级容量不足、补差未支付或家长确认超时主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-EDU-009试听预约需联动到访签到、教师试听反馈、家长评价、顾问跟进、未到访唤醒和试听后转化任务。试听反馈台到访签到、教师反馈或转化跟进校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务试听未到访、反馈缺失或转化任务未分配主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-EDU-010补课已确认后需支持家长申请改期或取消，教务可重新安排候选课次，原补课课次资源需释放并保留改期原因、处理人和消息触达记录。请假补课/补课安排请假审批、补课安排或家长确认校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务补课时间未确认、候选课次过期或课消回滚失败主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-EDU-011补课已签到或已课消后发生取消、异常或重复课消时，必须进入课消冲正、人工复核和财务监管一致性校验流程。请假补课/补课安排请假审批、补课安排或家长确认校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务补课时间未确认、候选课次过期或课消回滚失败主流程、异常流、权限流、接口失败和数据一致性均可通过测试

07 · 关联闭环补充需求

教务教学中心在跨模块闭环中的责任边界

本章节承接最终闭环核对清单，明确本模块需要补齐的页面、接口对象、异常兜底和验收口径。
闭环项本模块责任关键场景页面/功能补充关联对象/接口验收口径
补课改期取消负责请假、补课安排、候选课次、人工安排、取消和课消冻结/回滚家长请假时无法确认补课时间，或补课时间需后续人工安排请假审批、补课安排池、候选课次、家长确认、补课取消、课消回滚LeaveRequest/MakeupArrangement、Attendance/Consumption、/api/v1/edu/makeup-arrangements请假后必须形成补课状态；超时、取消、改期和完成均有消息和审计
合同补充协议转班转课、课时权益调整时触发合同补充协议需求转班、转课、调课导致权益、价格或有效期变化转班转课申请、权益重算、补充协议触发确认ClassCourseTransfer、Contract/Order/Payment、DiscountSimulation/BenefitAllocation权益变化需要合同确认时，教务单据不得直接完结

08 · 页面与原型设计说明

页面清单、布局要求、按钮字段和状态

原型图设计需要覆盖列表、详情、表单、弹窗、空状态、异常状态和权限状态。
终端页面用户页面目标布局结构关键按钮关键字段异常状态原型备注
PC Web校区课表教务/前台排课、调课、请假、补课、冲突校验教务页以日历/课表为主，课次详情展示学员列表、签到课消、请假补课、教师点评和异常处理。排课、调课、提交请假、审批请假、安排补课、确认签到、课消确认、发布作业课次、班级、教师、教室、请假状态、补课候选、签到状态、课消状态、上课时间、补课状态教师冲突、教室冲突、补课时间未确认、候选课次过期、课消回滚失败、签到异常需覆盖请假后无法确认补课时间进入补课安排池、家长确认、改期取消、资源释放和课消冲正。 建议 Figma Frame：EDU-校区课表；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web签到处理教务/前台处理人工签到、人脸签到、异常确认和课消设备页按校区、设备、人员、事件四层组织，识别流水支持照片、置信度、课次匹配和异常处理入口。新增设备、人员下发、查看心跳、确认异常、撤回授权、重试下发、查看回执设备编号、设备品牌、所属校区、人员编号、人脸照片、置信度、匹配课次、删除回执、班级、课次设备离线、人员下发失败、低置信度、跨校区识别、模板删除失败、回执缺失需覆盖设备在线/离线、人员模板下发、识别异常确认、家长撤回授权、设备离线延迟删除和隐私审计。 建议 Figma Frame：EDU-签到处理；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
教师 App今日课程教师查看课表、签到确认、课堂点评、作业发布教务页以日历/课表为主，课次详情展示学员列表、签到课消、请假补课、教师点评和异常处理。排课、调课、提交请假、审批请假、安排补课、确认签到、课消确认、发布作业课次、班级、教师、教室、请假状态、补课候选、签到状态、课消状态、上课时间、补课状态教师冲突、教室冲突、补课时间未确认、候选课次过期、课消回滚失败、签到异常需覆盖请假后无法确认补课时间进入补课安排池、家长确认、改期取消、资源释放和课消冲正。 建议 Figma Frame：EDU-今日课程；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web直播课务编排教务/校长在排课中选择直播课型并联动直播房间、教师端、学员端和课消规则直播列表展示今日直播、未开始、进行中和回放；课堂页突出播放器、签到、互动、答题、举手和课后任务。进入直播、直播签到、提交答题、举手上麦、查看回放、同步进度、结束课堂直播课次、开播时间、教师/助教、观看权限、签到状态、互动得分、回放状态、学习进度、班级、课次直播未开播、无观看权益、播放鉴权失效、断流、回放生成中、学习进度同步失败需覆盖开播前、直播中、断流重试、回放生成中、回放可看、补看任务和学习档案回写。 建议 Figma Frame：EDU-直播课务编排；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/家长端请假申请与审批家长/教务/教师家长提交请假，教务审批，教师确认课次状态，系统处理课消冻结、回滚或补课安排教务页以日历/课表为主，课次详情展示学员列表、签到课消、请假补课、教师点评和异常处理。排课、调课、提交请假、审批请假、安排补课、确认签到、课消确认、发布作业课次、班级、教师、教室、请假状态、补课候选、签到状态、课消状态、上课时间、补课状态教师冲突、教室冲突、补课时间未确认、候选课次过期、课消回滚失败、签到异常需覆盖请假后无法确认补课时间进入补课安排池、家长确认、改期取消、资源释放和课消冲正。 建议 Figma Frame：EDU-请假申请与审批；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web补课安排池教务/校长集中处理请假时未确定补课时间的学员，推荐补课课次并推送家长确认教务页以日历/课表为主，课次详情展示学员列表、签到课消、请假补课、教师点评和异常处理。排课、调课、提交请假、审批请假、安排补课、确认签到、课消确认、发布作业课次、班级、教师、教室、请假状态、补课候选、签到状态、课消状态、上课时间、补课状态教师冲突、教室冲突、补课时间未确认、候选课次过期、课消回滚失败、签到异常需覆盖请假后无法确认补课时间进入补课安排池、家长确认、改期取消、资源释放和课消冲正。 建议 Figma Frame：EDU-补课安排池；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web补课重新安排教务/校长处理补课改期、取消、候选课次重选、资源释放和课消冲正教务页以日历/课表为主，课次详情展示学员列表、签到课消、请假补课、教师点评和异常处理。排课、调课、提交请假、审批请假、安排补课、确认签到、课消确认、发布作业课次、班级、教师、教室、请假状态、补课候选、签到状态、课消状态、上课时间、补课状态教师冲突、教室冲突、补课时间未确认、候选课次过期、课消回滚失败、签到异常需覆盖请假后无法确认补课时间进入补课安排池、家长确认、改期取消、资源释放和课消冲正。 建议 Figma Frame：EDU-补课重新安排；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web请假详情授权用户围绕补课兜底完善请假详情的入口、字段、状态、异常提示、处理进度和验收反馈教务页以日历/课表为主，课次详情展示学员列表、签到课消、请假补课、教师点评和异常处理。排课、调课、提交请假、审批请假、安排补课、确认签到、课消确认、发布作业课次、班级、教师、教室、请假状态、补课候选、签到状态、课消状态、上课时间、补课状态教师冲突、教室冲突、补课时间未确认、候选课次过期、课消回滚失败、签到异常需覆盖请假后无法确认补课时间进入补课安排池、家长确认、改期取消、资源释放和课消冲正。 建议 Figma Frame：EDU-请假详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web家长确认页授权用户围绕补课兜底完善家长确认页的入口、字段、状态、异常提示、处理进度和验收反馈教务页以日历/课表为主，课次详情展示学员列表、签到课消、请假补课、教师点评和异常处理。排课、调课、提交请假、审批请假、安排补课、确认签到、课消确认、发布作业课次、班级、教师、教室、请假状态、补课候选、签到状态、课消状态、上课时间、补课状态教师冲突、教室冲突、补课时间未确认、候选课次过期、课消回滚失败、签到异常需覆盖请假后无法确认补课时间进入补课安排池、家长确认、改期取消、资源释放和课消冲正。 建议 Figma Frame：EDU-家长确认页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web课次详情授权用户围绕课消回滚完善课次详情的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、维护课程、排课调课班级、课次、教师、教室、上课时间、签到状态、课消状态、补课状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：EDU-课次详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web考勤异常授权用户围绕课消回滚完善考勤异常的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、维护课程、排课调课班级、课次、教师、教室、上课时间、签到状态、课消状态、补课状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：EDU-考勤异常；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web课消确认授权用户围绕课消回滚完善课消确认的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、维护课程、排课调课班级、课次、教师、教室、上课时间、签到状态、课消状态、补课状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：EDU-课消确认；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web课后点评授权用户围绕教学反馈完善课后点评的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、维护课程、排课调课班级、课次、教师、教室、上课时间、签到状态、课消状态、补课状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：EDU-课后点评；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web作业批改授权用户围绕教学反馈完善作业批改的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、维护课程、排课调课班级、课次、教师、教室、上课时间、签到状态、课消状态、补课状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：EDU-作业批改；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web测评报告授权用户围绕教学反馈完善测评报告的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、维护课程、排课调课班级、课次、教师、教室、上课时间、签到状态、课消状态、补课状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：EDU-测评报告；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web成长档案授权用户围绕教学反馈完善成长档案的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、维护课程、排课调课班级、课次、教师、教室、上课时间、签到状态、课消状态、补课状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：EDU-成长档案；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。

09 · 页面到接口的前后端闭环矩阵

把原型页面、后端接口、数据对象、状态和消息审批绑定到一起

设计原型时，每个关键页面必须能解释前端展示什么、后端提交什么、状态怎么变、异常怎么处理。
原型页面关键接口关联对象状态流审批/权限触发消息/待办触达原型验收要求
校区课表POST/GET /api/v1/edu/makeup-arrangementsCourse/Product草稿 -> 待审批 -> 已同意 -> 已驳回 -> 已取消 -> 补课待安排 -> 补课待确认 -> 补课已预约 -> 已补课 -> 已关闭请假审批与补课安排：家长请假通过但未确认补课时间，或补课候选课次需家长确认处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
签到处理POST/GET /api/v1/edu/transfersCoursePackage已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正补课改期取消审批：已确认补课需要改期、取消或已课消后冲正处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
今日课程POST/GET /api/v1/edu/makeup-arrangementsClass草稿 -> 待审批 -> 已同意 -> 已驳回 -> 已取消 -> 补课待安排 -> 补课待确认 -> 补课已预约 -> 已补课 -> 已关闭请假审批与补课安排：家长请假通过但未确认补课时间，或补课候选课次需家长确认处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
直播课务编排POST/GET /api/v1/edu/transfersSchedule/Lesson已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正补课改期取消审批：已确认补课需要改期、取消或已课消后冲正处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
请假申请与审批POST/GET /api/v1/edu/makeup-arrangementsAttendance草稿 -> 待审批 -> 已同意 -> 已驳回 -> 已取消 -> 补课待安排 -> 补课待确认 -> 补课已预约 -> 已补课 -> 已关闭请假审批与补课安排：家长请假通过但未确认补课时间，或补课候选课次需家长确认处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
补课安排池POST/GET /api/v1/edu/transfersConsumption已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正补课改期取消审批：已确认补课需要改期、取消或已课消后冲正处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
补课重新安排POST/GET /api/v1/edu/makeup-arrangementsLeaveRequest草稿 -> 待审批 -> 已同意 -> 已驳回 -> 已取消 -> 补课待安排 -> 补课待确认 -> 补课已预约 -> 已补课 -> 已关闭请假审批与补课安排：家长请假通过但未确认补课时间，或补课候选课次需家长确认处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
请假详情POST/GET /api/v1/edu/transfersMakeupArrangement已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正补课改期取消审批：已确认补课需要改期、取消或已课消后冲正处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
家长确认页POST/GET /api/v1/edu/makeup-arrangementsHomework草稿 -> 待审批 -> 已同意 -> 已驳回 -> 已取消 -> 补课待安排 -> 补课待确认 -> 补课已预约 -> 已补课 -> 已关闭请假审批与补课安排：家长请假通过但未确认补课时间，或补课候选课次需家长确认处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
课次详情POST/GET /api/v1/edu/transfersHomeworkReview已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正补课改期取消审批：已确认补课需要改期、取消或已课消后冲正处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
考勤异常POST/GET /api/v1/edu/makeup-arrangementsGrowthRecord草稿 -> 待审批 -> 已同意 -> 已驳回 -> 已取消 -> 补课待安排 -> 补课待确认 -> 补课已预约 -> 已补课 -> 已关闭请假审批与补课安排：家长请假通过但未确认补课时间，或补课候选课次需家长确认处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
课消确认POST/GET /api/v1/edu/transfersCourse/Product已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正补课改期取消审批：已确认补课需要改期、取消或已课消后冲正处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口

10 · 原型、UI、研发、测试交付补充

把关键闭环补强为下一阶段可执行任务

本章节为正式 PRD 的交付要求，面向原型图、UI、开发、联调和测试分工。
能力域功能补充要求原型交付要求UI 交互要求研发实现要求测试验收要求
补课兜底新增补课安排池、候选课次、确认截止、超时提醒、教务代安排和家长确认流程。请假详情、补课安排池、家长确认页 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；请假后未确认时间的学员不会丢失，均进入补课待安排状态。
课消回滚补齐课消冻结、自动课消、人工确认、冲正审批和财务监管报送联动。课次详情、考勤异常、课消确认 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；任何课消变更均可追溯原因、审批、财务影响和监管状态。
教学反馈补齐课堂点评、作业批改、阶段测评、成长档案更新和家长端通知。课后点评、作业批改、测评报告、成长档案 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；学习结果能回写学员端、家长端、教师端和服务中心。

11 · 数据对象与字段字典

明确页面、接口、数据库共同使用的数据语言

字段涉及敏感、人脸、财务、绩效时，原型需体现脱敏、授权和审计。

核心对象

对象说明
Course/Product课程产品；落地表：edu_course
CoursePackage课包与价格；落地表：edu_product_package
Class班级；落地表：edu_class
Schedule/Lesson课次和排课；落地表：edu_lesson
Attendance上课签到记录；落地表：edu_attendance
Consumption课消记录；落地表：edu_consumption
LeaveRequest学员请假申请；落地表：edu_leave_request
MakeupArrangement补课安排兜底入口；落地表：edu_makeup_arrangement
Homework作业任务；落地表：edu_homework
HomeworkReview作业批改与点评；落地表：edu_homework_review
GrowthRecord学习成长档案；落地表：edu_growth_record

关联引用对象

对象说明
Organization集团、区域、校区、部门组织树；引用来源：FND / sys_organization
User/Employee统一登录账号；引用来源：FND / sys_user
Employee员工基础档案；引用来源：FND / sys_employee
Role角色定义；引用来源：FND / sys_role
ApprovalFlow审批流配置；引用来源：FND / sys_approval_flow
MessageTemplate消息模板与多端触达配置；引用来源：FND / sys_message_template
AuditLog全平台操作审计日志；引用来源：FND / sys_audit_log
IntegrationLog接口调用日志；引用来源：OPEN / int_integration_log
SensitiveFieldPolicy敏感字段脱敏策略；引用来源：SEC / sec_sensitive_field_policy
Guardian监护人/家长资料；引用来源：CRM / crm_guardian
Student学员基础档案；引用来源：CRM / stu_student
Contract合同主表；引用来源：CON / con_contract
Order订单和应收；引用来源：CON / ord_order
LiveRoom直播间；引用来源：LIVE / live_room
FaceAttendanceEvent人脸识别回传事件；引用来源：FAC / dev_face_event
ServiceTicket服务工单；引用来源：SER / ser_service_ticket

完整字段字典

对象字段类型必填规则数据级别
Course/ProductidBIGINT是主键，雪花或号段生成，禁止复用普通
Course/Producttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Course/Productorg_idBIGINT否所属组织，集团级或公共配置为空普通
Course/Productcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Course/Productcreated_byBIGINT是创建人账号 ID普通
Course/Productcreated_atDATETIME是创建时间普通
Course/Productupdated_byBIGINT否最后更新人账号 ID普通
Course/Productupdated_atDATETIME否最后更新时间普通
Course/Productis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Course/Productdeleted_atDATETIME否删除时间，未删除为空普通
Course/Productdeleted_byBIGINT否删除人账号 ID，未删除为空普通
Course/ProductversionINT是乐观锁版本号，写操作必须校验普通
Course/Productcourse_codeVARCHAR(64)是课程编码，唯一普通
Course/Productcourse_nameVARCHAR(128)是课程名称普通
Course/ProductsubjectVARCHAR(32)是学科普通
Course/Productcourse_typeVARCHAR(32)是班课/一对一/直播/录播普通
Course/Productgrade_scopeJSON否适用年级普通
Course/ProductenabledTINYINT是是否启用普通
CoursePackageidBIGINT是主键，雪花或号段生成，禁止复用普通
CoursePackagetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
CoursePackageorg_idBIGINT否所属组织，集团级或公共配置为空普通
CoursePackagecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
CoursePackagecreated_byBIGINT是创建人账号 ID普通
CoursePackagecreated_atDATETIME是创建时间普通
CoursePackageupdated_byBIGINT否最后更新人账号 ID普通
CoursePackageupdated_atDATETIME否最后更新时间普通
CoursePackageis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
CoursePackagedeleted_atDATETIME否删除时间，未删除为空普通
CoursePackagedeleted_byBIGINT否删除人账号 ID，未删除为空普通
CoursePackageversionINT是乐观锁版本号，写操作必须校验普通
CoursePackagepackage_codeVARCHAR(64)是课包编码，唯一普通
CoursePackagecourse_idBIGINT是课程 ID普通
CoursePackagelesson_hoursDECIMAL(8,2)是课时数普通
CoursePackagesale_priceDECIMAL(18,2)是销售价格普通
CoursePackagevalid_daysINT是有效期天数普通
CoursePackagecampus_scopeJSON否适用校区普通
ClassidBIGINT是主键，雪花或号段生成，禁止复用普通
Classtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Classorg_idBIGINT否所属组织，集团级或公共配置为空普通
Classcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Classcreated_byBIGINT是创建人账号 ID普通
Classcreated_atDATETIME是创建时间普通
Classupdated_byBIGINT否最后更新人账号 ID普通
Classupdated_atDATETIME否最后更新时间普通
Classis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Classdeleted_atDATETIME否删除时间，未删除为空普通
Classdeleted_byBIGINT否删除人账号 ID，未删除为空普通
ClassversionINT是乐观锁版本号，写操作必须校验普通
Classclass_noVARCHAR(64)是班级编号，唯一普通
Classcourse_idBIGINT是课程 ID普通
Classteacher_idBIGINT否主讲教师 ID普通
Classclassroom_idBIGINT否默认教室 ID普通
ClasscapacityINT是班级容量普通
Classclass_statusVARCHAR(32)是筹备中/开班/结课/停课普通
Schedule/LessonidBIGINT是主键，雪花或号段生成，禁止复用普通
Schedule/Lessontenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Schedule/Lessonorg_idBIGINT否所属组织，集团级或公共配置为空普通
Schedule/Lessoncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Schedule/Lessoncreated_byBIGINT是创建人账号 ID普通
Schedule/Lessoncreated_atDATETIME是创建时间普通
Schedule/Lessonupdated_byBIGINT否最后更新人账号 ID普通
Schedule/Lessonupdated_atDATETIME否最后更新时间普通
Schedule/Lessonis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Schedule/Lessondeleted_atDATETIME否删除时间，未删除为空普通
Schedule/Lessondeleted_byBIGINT否删除人账号 ID，未删除为空普通
Schedule/LessonversionINT是乐观锁版本号，写操作必须校验普通
Schedule/Lessonlesson_noVARCHAR(64)是课次编号，唯一普通
Schedule/Lessonclass_idBIGINT是班级 ID普通
Schedule/Lessonteacher_idBIGINT是授课教师 ID普通
Schedule/Lessonclassroom_idBIGINT否教室 ID普通
Schedule/Lessonstart_atDATETIME是上课开始时间普通
Schedule/Lessonend_atDATETIME是上课结束时间普通
Schedule/Lessonlesson_statusVARCHAR(32)是待上课/上课中/已下课/已取消/需补课普通
AttendanceidBIGINT是主键，雪花或号段生成，禁止复用普通
Attendancetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Attendanceorg_idBIGINT否所属组织，集团级或公共配置为空普通
Attendancecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Attendancecreated_byBIGINT是创建人账号 ID普通
Attendancecreated_atDATETIME是创建时间普通
Attendanceupdated_byBIGINT否最后更新人账号 ID普通
Attendanceupdated_atDATETIME否最后更新时间普通
Attendanceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Attendancedeleted_atDATETIME否删除时间，未删除为空普通
Attendancedeleted_byBIGINT否删除人账号 ID，未删除为空普通
AttendanceversionINT是乐观锁版本号，写操作必须校验普通
Attendancelesson_idBIGINT是课次 ID普通
Attendancestudent_idBIGINT是学员 ID普通
Attendancecheckin_typeVARCHAR(32)是人工/人脸/补签/家长确认普通
Attendancecheckin_atDATETIME否签到时间普通
Attendanceattendance_statusVARCHAR(32)是到课/请假/旷课/迟到/待确认普通
Attendancesource_event_idBIGINT否来源设备或操作事件普通
ConsumptionidBIGINT是主键，雪花或号段生成，禁止复用普通
Consumptiontenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Consumptionorg_idBIGINT否所属组织，集团级或公共配置为空普通
Consumptioncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Consumptioncreated_byBIGINT是创建人账号 ID普通
Consumptioncreated_atDATETIME是创建时间普通
Consumptionupdated_byBIGINT否最后更新人账号 ID普通
Consumptionupdated_atDATETIME否最后更新时间普通
Consumptionis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Consumptiondeleted_atDATETIME否删除时间，未删除为空普通
Consumptiondeleted_byBIGINT否删除人账号 ID，未删除为空普通
ConsumptionversionINT是乐观锁版本号，写操作必须校验普通
Consumptionlesson_idBIGINT是课次 ID普通
Consumptionstudent_idBIGINT是学员 ID普通
Consumptioncontract_idBIGINT是合同 ID普通
Consumptionconsumed_hoursDECIMAL(8,2)是消耗课时普通
Consumptionconsume_amountDECIMAL(18,2)否课消金额普通
Consumptionconsume_statusVARCHAR(32)是待确认/已课消/已冲销/异常普通
LeaveRequestidBIGINT是主键，雪花或号段生成，禁止复用普通
LeaveRequesttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
LeaveRequestorg_idBIGINT否所属组织，集团级或公共配置为空普通
LeaveRequestcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
LeaveRequestcreated_byBIGINT是创建人账号 ID普通
LeaveRequestcreated_atDATETIME是创建时间普通
LeaveRequestupdated_byBIGINT否最后更新人账号 ID普通
LeaveRequestupdated_atDATETIME否最后更新时间普通
LeaveRequestis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
LeaveRequestdeleted_atDATETIME否删除时间，未删除为空普通
LeaveRequestdeleted_byBIGINT否删除人账号 ID，未删除为空普通
LeaveRequestversionINT是乐观锁版本号，写操作必须校验普通
LeaveRequestleave_noVARCHAR(64)是请假编号，唯一普通
LeaveRequeststudent_idBIGINT是学员 ID普通
LeaveRequestlesson_idBIGINT是课次 ID普通
LeaveRequestleave_reasonVARCHAR(512)是请假原因普通
LeaveRequestproof_file_idsJSON否证明附件普通
LeaveRequestleave_statusVARCHAR(32)是待审核/已通过/已驳回/已撤销普通
LeaveRequestapproval_statusVARCHAR(32)否审批状态，未发起为空普通
LeaveRequestapproval_instance_idBIGINT否关联审批实例 ID普通
MakeupArrangementidBIGINT是主键，雪花或号段生成，禁止复用普通
MakeupArrangementtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
MakeupArrangementorg_idBIGINT否所属组织，集团级或公共配置为空普通
MakeupArrangementcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
MakeupArrangementcreated_byBIGINT是创建人账号 ID普通
MakeupArrangementcreated_atDATETIME是创建时间普通
MakeupArrangementupdated_byBIGINT否最后更新人账号 ID普通
MakeupArrangementupdated_atDATETIME否最后更新时间普通
MakeupArrangementis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
MakeupArrangementdeleted_atDATETIME否删除时间，未删除为空普通
MakeupArrangementdeleted_byBIGINT否删除人账号 ID，未删除为空普通
MakeupArrangementversionINT是乐观锁版本号，写操作必须校验普通
MakeupArrangementarrangement_noVARCHAR(64)是补课安排编号，唯一普通
MakeupArrangementleave_request_idBIGINT否关联请假单普通
MakeupArrangementstudent_idBIGINT是学员 ID普通
MakeupArrangementcandidate_lessonsJSON否候选补课课次普通
MakeupArrangementmakeup_preferenceJSON否家长期望时间普通
MakeupArrangementconfirm_deadlineDATETIME否确认截止时间普通
MakeupArrangementarrange_statusVARCHAR(32)是待安排/待确认/已确认/已完成/已取消普通
HomeworkidBIGINT是主键，雪花或号段生成，禁止复用普通
Homeworktenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Homeworkorg_idBIGINT否所属组织，集团级或公共配置为空普通
Homeworkcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Homeworkcreated_byBIGINT是创建人账号 ID普通
Homeworkcreated_atDATETIME是创建时间普通
Homeworkupdated_byBIGINT否最后更新人账号 ID普通
Homeworkupdated_atDATETIME否最后更新时间普通
Homeworkis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Homeworkdeleted_atDATETIME否删除时间，未删除为空普通
Homeworkdeleted_byBIGINT否删除人账号 ID，未删除为空普通
HomeworkversionINT是乐观锁版本号，写操作必须校验普通
Homeworkhomework_noVARCHAR(64)是作业编号，唯一普通
Homeworklesson_idBIGINT是课次 ID普通
HomeworktitleVARCHAR(128)是作业标题普通
Homeworkcontent_schemaJSON是题目、附件、提交要求普通
Homeworkdeadline_atDATETIME否截止时间普通
Homeworkpublish_statusVARCHAR(32)是草稿/已发布/已关闭普通
HomeworkReviewidBIGINT是主键，雪花或号段生成，禁止复用普通
HomeworkReviewtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
HomeworkRevieworg_idBIGINT否所属组织，集团级或公共配置为空普通
HomeworkReviewcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
HomeworkReviewcreated_byBIGINT是创建人账号 ID普通
HomeworkReviewcreated_atDATETIME是创建时间普通
HomeworkReviewupdated_byBIGINT否最后更新人账号 ID普通
HomeworkReviewupdated_atDATETIME否最后更新时间普通
HomeworkReviewis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
HomeworkReviewdeleted_atDATETIME否删除时间，未删除为空普通
HomeworkReviewdeleted_byBIGINT否删除人账号 ID，未删除为空普通
HomeworkReviewversionINT是乐观锁版本号，写操作必须校验普通
HomeworkReviewsubmit_idBIGINT是作业提交 ID普通
HomeworkReviewteacher_idBIGINT是批改教师 ID普通
HomeworkReviewscoreDECIMAL(6,2)否得分普通
HomeworkReviewcommentTEXT否评语普通
HomeworkReviewwrong_question_jsonJSON否错题记录普通
HomeworkReviewreview_statusVARCHAR(32)是待批改/已批改/需订正普通
GrowthRecordidBIGINT是主键，雪花或号段生成，禁止复用普通
GrowthRecordtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
GrowthRecordorg_idBIGINT否所属组织，集团级或公共配置为空普通
GrowthRecordcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
GrowthRecordcreated_byBIGINT是创建人账号 ID普通
GrowthRecordcreated_atDATETIME是创建时间普通
GrowthRecordupdated_byBIGINT否最后更新人账号 ID普通
GrowthRecordupdated_atDATETIME否最后更新时间普通
GrowthRecordis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
GrowthRecorddeleted_atDATETIME否删除时间，未删除为空普通
GrowthRecorddeleted_byBIGINT否删除人账号 ID，未删除为空普通
GrowthRecordversionINT是乐观锁版本号，写操作必须校验普通
GrowthRecordstudent_idBIGINT是学员 ID普通
GrowthRecordrecord_typeVARCHAR(32)是课堂/作业/测评/签到/教师评价普通
GrowthRecordbiz_typeVARCHAR(64)是来源业务类型普通
GrowthRecordbiz_idBIGINT是来源业务 ID普通
GrowthRecordrecord_contentJSON是成长记录内容普通
GrowthRecordvisible_to_parentTINYINT是家长端是否可见普通

引用对象字段字典

引用表对象字段类型必填规则数据级别
sys_organizationOrganizationidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_organizationOrganizationtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_organizationOrganizationorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_organizationOrganizationcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_organizationOrganizationcreated_byBIGINT是创建人账号 ID普通
sys_organizationOrganizationcreated_atDATETIME是创建时间普通
sys_organizationOrganizationupdated_byBIGINT否最后更新人账号 ID普通
sys_organizationOrganizationupdated_atDATETIME否最后更新时间普通
sys_organizationOrganizationis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_organizationOrganizationdeleted_atDATETIME否删除时间，未删除为空普通
sys_organizationOrganizationdeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_organizationOrganizationversionINT是乐观锁版本号，写操作必须校验普通
sys_organizationOrganizationorg_codeVARCHAR(64)是组织编码，租户内唯一普通
sys_organizationOrganizationorg_nameVARCHAR(128)是组织名称普通
sys_organizationOrganizationorg_typeVARCHAR(32)是集团/区域/校区/部门/法人主体普通
sys_organizationOrganizationparent_idBIGINT否上级组织 ID，根节点为空普通
sys_organizationOrganizationsort_noINT否同级排序普通
sys_organizationOrganizationenabledTINYINT是是否启用普通
sys_userUser/EmployeeidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_userUser/Employeetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_userUser/Employeeorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_userUser/Employeecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_userUser/Employeecreated_byBIGINT是创建人账号 ID普通
sys_userUser/Employeecreated_atDATETIME是创建时间普通
sys_userUser/Employeeupdated_byBIGINT否最后更新人账号 ID普通
sys_userUser/Employeeupdated_atDATETIME否最后更新时间普通
sys_userUser/Employeeis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_userUser/Employeedeleted_atDATETIME否删除时间，未删除为空普通
sys_userUser/Employeedeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_userUser/EmployeeversionINT是乐观锁版本号，写操作必须校验普通
sys_userUser/Employeeuser_noVARCHAR(64)是账号编号，唯一普通
sys_userUser/Employeelogin_nameVARCHAR(64)是登录名，唯一普通
sys_userUser/EmployeemobileVARCHAR(32)否手机号，敏感脱敏展示敏感
sys_userUser/Employeepassword_hashVARCHAR(255)否密码哈希，禁止前端返回高敏
sys_userUser/Employeeuser_typeVARCHAR(32)是员工/学员/家长/外部账号普通
sys_userUser/Employeelogin_statusVARCHAR(32)是正常/锁定/停用/待激活普通
sys_employeeEmployeeidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_employeeEmployeetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_employeeEmployeeorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_employeeEmployeecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_employeeEmployeecreated_byBIGINT是创建人账号 ID普通
sys_employeeEmployeecreated_atDATETIME是创建时间普通
sys_employeeEmployeeupdated_byBIGINT否最后更新人账号 ID普通
sys_employeeEmployeeupdated_atDATETIME否最后更新时间普通
sys_employeeEmployeeis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_employeeEmployeedeleted_atDATETIME否删除时间，未删除为空普通
sys_employeeEmployeedeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_employeeEmployeeversionINT是乐观锁版本号，写操作必须校验普通
sys_employeeEmployeeemployee_noVARCHAR(64)是工号，唯一普通
sys_employeeEmployeeuser_idBIGINT否关联账号 ID普通
sys_employeeEmployeeemployee_nameVARCHAR(64)是员工姓名普通
sys_employeeEmployeeprimary_campus_idBIGINT否主校区 ID普通
sys_employeeEmployeejob_titleVARCHAR(64)否岗位名称普通
sys_employeeEmployeehire_statusVARCHAR(32)是在职/试用/离职/停用普通
sys_roleRoleidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_roleRoletenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_roleRoleorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_roleRolecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_roleRolecreated_byBIGINT是创建人账号 ID普通
sys_roleRolecreated_atDATETIME是创建时间普通
sys_roleRoleupdated_byBIGINT否最后更新人账号 ID普通
sys_roleRoleupdated_atDATETIME否最后更新时间普通
sys_roleRoleis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_roleRoledeleted_atDATETIME否删除时间，未删除为空普通
sys_roleRoledeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_roleRoleversionINT是乐观锁版本号，写操作必须校验普通
sys_roleRolerole_codeVARCHAR(64)是角色编码，唯一普通
sys_roleRolerole_nameVARCHAR(128)是角色名称普通
sys_roleRolerole_levelVARCHAR(32)是总部/区域/校区/个人普通
sys_roleRoledata_scope_typeVARCHAR(32)是数据范围类型普通
sys_roleRoleenabledTINYINT是是否启用普通
sys_approval_flowApprovalFlowidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_approval_flowApprovalFlowtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_approval_flowApprovalFloworg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_approval_flowApprovalFlowcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_approval_flowApprovalFlowcreated_byBIGINT是创建人账号 ID普通
sys_approval_flowApprovalFlowcreated_atDATETIME是创建时间普通
sys_approval_flowApprovalFlowupdated_byBIGINT否最后更新人账号 ID普通
sys_approval_flowApprovalFlowupdated_atDATETIME否最后更新时间普通
sys_approval_flowApprovalFlowis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_approval_flowApprovalFlowdeleted_atDATETIME否删除时间，未删除为空普通
sys_approval_flowApprovalFlowdeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_approval_flowApprovalFlowversionINT是乐观锁版本号，写操作必须校验普通
sys_approval_flowApprovalFlowflow_codeVARCHAR(64)是审批流编码，唯一普通
sys_approval_flowApprovalFlowbiz_typeVARCHAR(64)是业务类型普通
sys_approval_flowApprovalFlowflow_nameVARCHAR(128)是审批流名称普通
sys_approval_flowApprovalFlowcondition_jsonJSON否触发条件普通
sys_approval_flowApprovalFlownode_jsonJSON是节点、审批人和超时规则普通
sys_approval_flowApprovalFlowversion_noINT是审批流版本号普通
sys_approval_flowApprovalFlowenabledTINYINT是是否启用普通
sys_message_templateMessageTemplateidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_message_templateMessageTemplatetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_message_templateMessageTemplateorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_message_templateMessageTemplatecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_message_templateMessageTemplatecreated_byBIGINT是创建人账号 ID普通
sys_message_templateMessageTemplatecreated_atDATETIME是创建时间普通
sys_message_templateMessageTemplateupdated_byBIGINT否最后更新人账号 ID普通
sys_message_templateMessageTemplateupdated_atDATETIME否最后更新时间普通
sys_message_templateMessageTemplateis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_message_templateMessageTemplatedeleted_atDATETIME否删除时间，未删除为空普通
sys_message_templateMessageTemplatedeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_message_templateMessageTemplateversionINT是乐观锁版本号，写操作必须校验普通
sys_message_templateMessageTemplatetemplate_codeVARCHAR(64)是模板编码，唯一普通
sys_message_templateMessageTemplatetemplate_nameVARCHAR(128)是模板名称普通
sys_message_templateMessageTemplatechannelVARCHAR(32)是站内信/短信/微信小程序/企微/Push普通
sys_message_templateMessageTemplatereceiver_ruleJSON是接收人规则普通
sys_message_templateMessageTemplatecontent_templateTEXT是模板内容普通
sys_message_templateMessageTemplateenabledTINYINT是是否启用普通
sys_audit_logAuditLogidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_audit_logAuditLogtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_audit_logAuditLogorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_audit_logAuditLogcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_audit_logAuditLogcreated_byBIGINT是创建人账号 ID普通
sys_audit_logAuditLogcreated_atDATETIME是创建时间普通
sys_audit_logAuditLogupdated_byBIGINT否最后更新人账号 ID普通
sys_audit_logAuditLogupdated_atDATETIME否最后更新时间普通
sys_audit_logAuditLogis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_audit_logAuditLogdeleted_atDATETIME否删除时间，未删除为空普通
sys_audit_logAuditLogdeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_audit_logAuditLogversionINT是乐观锁版本号，写操作必须校验普通
sys_audit_logAuditLogoperator_idBIGINT是操作人 ID普通
sys_audit_logAuditLogbiz_typeVARCHAR(64)是业务类型普通
sys_audit_logAuditLogbiz_idBIGINT否业务主键 ID普通
sys_audit_logAuditLogaction_codeVARCHAR(64)是操作编码普通
sys_audit_logAuditLogbefore_snapshotJSON否变更前快照普通
sys_audit_logAuditLogafter_snapshotJSON否变更后快照普通
sys_audit_logAuditLogip_addressVARCHAR(64)否操作 IP普通
int_integration_logIntegrationLogidBIGINT是主键，雪花或号段生成，禁止复用普通
int_integration_logIntegrationLogtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
int_integration_logIntegrationLogorg_idBIGINT否所属组织，集团级或公共配置为空普通
int_integration_logIntegrationLogcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
int_integration_logIntegrationLogcreated_byBIGINT是创建人账号 ID普通
int_integration_logIntegrationLogcreated_atDATETIME是创建时间普通
int_integration_logIntegrationLogupdated_byBIGINT否最后更新人账号 ID普通
int_integration_logIntegrationLogupdated_atDATETIME否最后更新时间普通
int_integration_logIntegrationLogis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
int_integration_logIntegrationLogdeleted_atDATETIME否删除时间，未删除为空普通
int_integration_logIntegrationLogdeleted_byBIGINT否删除人账号 ID，未删除为空普通
int_integration_logIntegrationLogversionINT是乐观锁版本号，写操作必须校验普通
int_integration_logIntegrationLogrequest_idVARCHAR(128)是请求 ID，幂等键普通
int_integration_logIntegrationLogsystem_codeVARCHAR(64)是外部系统编码普通
int_integration_logIntegrationLogapi_pathVARCHAR(512)是接口路径普通
int_integration_logIntegrationLogbiz_typeVARCHAR(64)否业务类型普通
int_integration_logIntegrationLogbiz_idBIGINT否业务 ID普通
int_integration_logIntegrationLogrequest_payloadJSON否请求报文，敏感字段脱敏敏感
int_integration_logIntegrationLogresponse_payloadJSON否响应报文普通
int_integration_logIntegrationLogcall_statusVARCHAR(32)是成功/失败/超时/重试中普通
sec_sensitive_field_policySensitiveFieldPolicyidBIGINT是主键，雪花或号段生成，禁止复用普通
sec_sensitive_field_policySensitiveFieldPolicytenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sec_sensitive_field_policySensitiveFieldPolicyorg_idBIGINT否所属组织，集团级或公共配置为空普通
sec_sensitive_field_policySensitiveFieldPolicycampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sec_sensitive_field_policySensitiveFieldPolicycreated_byBIGINT是创建人账号 ID普通
sec_sensitive_field_policySensitiveFieldPolicycreated_atDATETIME是创建时间普通
sec_sensitive_field_policySensitiveFieldPolicyupdated_byBIGINT否最后更新人账号 ID普通
sec_sensitive_field_policySensitiveFieldPolicyupdated_atDATETIME否最后更新时间普通
sec_sensitive_field_policySensitiveFieldPolicyis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sec_sensitive_field_policySensitiveFieldPolicydeleted_atDATETIME否删除时间，未删除为空普通
sec_sensitive_field_policySensitiveFieldPolicydeleted_byBIGINT否删除人账号 ID，未删除为空普通
sec_sensitive_field_policySensitiveFieldPolicyversionINT是乐观锁版本号，写操作必须校验普通
sec_sensitive_field_policySensitiveFieldPolicyfield_codeVARCHAR(128)是字段编码，唯一普通
sec_sensitive_field_policySensitiveFieldPolicybiz_typeVARCHAR(64)是业务类型普通
sec_sensitive_field_policySensitiveFieldPolicymask_ruleVARCHAR(64)是脱敏规则普通
sec_sensitive_field_policySensitiveFieldPolicyview_requires_approvalTINYINT是明文查看是否需审批普通
sec_sensitive_field_policySensitiveFieldPolicywatermark_requiredTINYINT是是否加水印普通
crm_guardianGuardianidBIGINT是主键，雪花或号段生成，禁止复用普通
crm_guardianGuardiantenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
crm_guardianGuardianorg_idBIGINT否所属组织，集团级或公共配置为空普通
crm_guardianGuardiancampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
crm_guardianGuardiancreated_byBIGINT是创建人账号 ID普通
crm_guardianGuardiancreated_atDATETIME是创建时间普通
crm_guardianGuardianupdated_byBIGINT否最后更新人账号 ID普通
crm_guardianGuardianupdated_atDATETIME否最后更新时间普通
crm_guardianGuardianis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
crm_guardianGuardiandeleted_atDATETIME否删除时间，未删除为空普通
crm_guardianGuardiandeleted_byBIGINT否删除人账号 ID，未删除为空普通
crm_guardianGuardianversionINT是乐观锁版本号，写操作必须校验普通
crm_guardianGuardianfamily_idBIGINT是家庭 ID普通
crm_guardianGuardianguardian_nameVARCHAR(64)是监护人姓名普通
crm_guardianGuardianmobileVARCHAR(32)是手机号，敏感敏感
crm_guardianGuardianrelationshipVARCHAR(32)是与学员关系普通
crm_guardianGuardianwechat_openidVARCHAR(128)否微信 OpenID，敏感敏感
crm_guardianGuardianverify_statusVARCHAR(32)是未验证/已验证/已解绑普通
stu_studentStudentidBIGINT是主键，雪花或号段生成，禁止复用普通
stu_studentStudenttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
stu_studentStudentorg_idBIGINT否所属组织，集团级或公共配置为空普通
stu_studentStudentcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
stu_studentStudentcreated_byBIGINT是创建人账号 ID普通
stu_studentStudentcreated_atDATETIME是创建时间普通
stu_studentStudentupdated_byBIGINT否最后更新人账号 ID普通
stu_studentStudentupdated_atDATETIME否最后更新时间普通
stu_studentStudentis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
stu_studentStudentdeleted_atDATETIME否删除时间，未删除为空普通
stu_studentStudentdeleted_byBIGINT否删除人账号 ID，未删除为空普通
stu_studentStudentversionINT是乐观锁版本号，写操作必须校验普通
stu_studentStudentstudent_noVARCHAR(64)是学员编号，唯一普通
stu_studentStudentfamily_idBIGINT否家庭 ID普通
stu_studentStudentstudent_nameVARCHAR(64)是学员姓名普通
stu_studentStudentgenderVARCHAR(16)否性别普通
stu_studentStudentbirthdayDATE否出生日期普通
stu_studentStudentgradeVARCHAR(32)否年级普通
stu_studentStudentschool_nameVARCHAR(128)否学校名称普通
stu_studentStudentbiz_statusVARCHAR(32)是业务状态，取值来自状态机字典普通
stu_studentStudentremarkVARCHAR(512)否业务备注，敏感内容按权限脱敏普通
con_contractContractidBIGINT是主键，雪花或号段生成，禁止复用普通
con_contractContracttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
con_contractContractorg_idBIGINT否所属组织，集团级或公共配置为空普通
con_contractContractcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
con_contractContractcreated_byBIGINT是创建人账号 ID普通
con_contractContractcreated_atDATETIME是创建时间普通
con_contractContractupdated_byBIGINT否最后更新人账号 ID普通
con_contractContractupdated_atDATETIME否最后更新时间普通
con_contractContractis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
con_contractContractdeleted_atDATETIME否删除时间，未删除为空普通
con_contractContractdeleted_byBIGINT否删除人账号 ID，未删除为空普通
con_contractContractversionINT是乐观锁版本号，写操作必须校验普通
con_contractContractcontract_noVARCHAR(64)是合同编号，唯一普通
con_contractContractstudent_idBIGINT是学员 ID普通
con_contractContractfamily_idBIGINT否客户家庭 ID普通
con_contractContracttemplate_idBIGINT是合同模板 ID普通
con_contractContractemployee_idBIGINT否创建合同的销售/市场/课程顾问员工 ID普通
con_contractContractsource_terminalVARCHAR(32)是来源终端，教师端 App/小程序或 PC 管理端普通
con_contractContractsimulation_idBIGINT否关联优惠试算 ID普通
con_contractContractextra_discount_apply_idBIGINT否关联额外折扣申请 ID普通
con_contractContracthand_sign_statusVARCHAR(32)是待手写签字/已手写签字/签字作废普通
con_contractContractsign_statusVARCHAR(32)是待家长签署/已手写签字/已作废普通
con_contractContractpayment_statusVARCHAR(32)是待支付/支付中/支付成功/支付失败/已关闭普通
con_contractContractenterprise_seal_statusVARCHAR(32)是未触发/盖章中/已盖章/盖章失败/已归档普通
con_contractContractcontract_statusVARCHAR(32)是草稿/生效/履约中/已终止/已退费普通
con_contractContractsupervision_statusVARCHAR(32)否监管报送状态普通
con_contractContractcurrencyVARCHAR(8)是币种，默认 CNY普通
con_contractContractamountDECIMAL(18,2)是含税金额，必须大于等于 0普通
con_contractContracttax_amountDECIMAL(18,2)否税额，按发票或税率计算普通
con_contractContractapproval_statusVARCHAR(32)否审批状态，未发起为空普通
con_contractContractapproval_instance_idBIGINT否关联审批实例 ID普通
ord_orderOrderidBIGINT是主键，雪花或号段生成，禁止复用普通
ord_orderOrdertenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
ord_orderOrderorg_idBIGINT否所属组织，集团级或公共配置为空普通
ord_orderOrdercampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
ord_orderOrdercreated_byBIGINT是创建人账号 ID普通
ord_orderOrdercreated_atDATETIME是创建时间普通
ord_orderOrderupdated_byBIGINT否最后更新人账号 ID普通
ord_orderOrderupdated_atDATETIME否最后更新时间普通
ord_orderOrderis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
ord_orderOrderdeleted_atDATETIME否删除时间，未删除为空普通
ord_orderOrderdeleted_byBIGINT否删除人账号 ID，未删除为空普通
ord_orderOrderversionINT是乐观锁版本号，写操作必须校验普通
ord_orderOrderorder_noVARCHAR(64)是订单编号，唯一普通
ord_orderOrdercontract_idBIGINT是合同 ID普通
ord_orderOrderstudent_idBIGINT是学员 ID普通
ord_orderOrderreceivable_amountDECIMAL(18,2)是应收金额普通
ord_orderOrderdiscount_amountDECIMAL(18,2)否优惠金额普通
ord_orderOrderpaid_amountDECIMAL(18,2)是已收金额普通
ord_orderOrderorder_statusVARCHAR(32)是待支付/支付中/已支付/已关闭普通
live_roomLiveRoomidBIGINT是主键，雪花或号段生成，禁止复用普通
live_roomLiveRoomtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
live_roomLiveRoomorg_idBIGINT否所属组织，集团级或公共配置为空普通
live_roomLiveRoomcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
live_roomLiveRoomcreated_byBIGINT是创建人账号 ID普通
live_roomLiveRoomcreated_atDATETIME是创建时间普通
live_roomLiveRoomupdated_byBIGINT否最后更新人账号 ID普通
live_roomLiveRoomupdated_atDATETIME否最后更新时间普通
live_roomLiveRoomis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
live_roomLiveRoomdeleted_atDATETIME否删除时间，未删除为空普通
live_roomLiveRoomdeleted_byBIGINT否删除人账号 ID，未删除为空普通
live_roomLiveRoomversionINT是乐观锁版本号，写操作必须校验普通
live_roomLiveRoomroom_noVARCHAR(64)是直播间编号，唯一普通
live_roomLiveRoomlive_typeVARCHAR(32)是教学直播/活动直播/集团会议直播普通
live_roomLiveRoomprovider_codeVARCHAR(32)是启用供应商普通
live_roomLiveRoombiz_typeVARCHAR(64)是绑定业务类型普通
live_roomLiveRoombiz_idBIGINT是绑定业务 ID普通
live_roomLiveRoomstart_atDATETIME否计划开始时间普通
live_roomLiveRoomend_atDATETIME否计划结束时间普通
live_roomLiveRoomroom_statusVARCHAR(32)是待开播/直播中/已结束/异常普通
dev_face_eventFaceAttendanceEventidBIGINT是主键，雪花或号段生成，禁止复用普通
dev_face_eventFaceAttendanceEventtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
dev_face_eventFaceAttendanceEventorg_idBIGINT否所属组织，集团级或公共配置为空普通
dev_face_eventFaceAttendanceEventcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
dev_face_eventFaceAttendanceEventcreated_byBIGINT是创建人账号 ID普通
dev_face_eventFaceAttendanceEventcreated_atDATETIME是创建时间普通
dev_face_eventFaceAttendanceEventupdated_byBIGINT否最后更新人账号 ID普通
dev_face_eventFaceAttendanceEventupdated_atDATETIME否最后更新时间普通
dev_face_eventFaceAttendanceEventis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
dev_face_eventFaceAttendanceEventdeleted_atDATETIME否删除时间，未删除为空普通
dev_face_eventFaceAttendanceEventdeleted_byBIGINT否删除人账号 ID，未删除为空普通
dev_face_eventFaceAttendanceEventversionINT是乐观锁版本号，写操作必须校验普通
dev_face_eventFaceAttendanceEventdevice_idBIGINT是设备 ID普通
dev_face_eventFaceAttendanceEventdevice_event_idVARCHAR(128)是设备侧事件号普通
dev_face_eventFaceAttendanceEventperson_idBIGINT否匹配人员 ID普通
dev_face_eventFaceAttendanceEventlesson_idBIGINT否匹配课次 ID普通
dev_face_eventFaceAttendanceEventevent_timeDATETIME是识别时间普通
dev_face_eventFaceAttendanceEventconfidenceDECIMAL(8,4)是识别置信度普通
dev_face_eventFaceAttendanceEventmatch_statusVARCHAR(32)是已匹配/低置信/未匹配/重复普通
dev_face_eventFaceAttendanceEventraw_payloadJSON是设备原始报文敏感
ser_service_ticketServiceTicketidBIGINT是主键，雪花或号段生成，禁止复用普通
ser_service_ticketServiceTickettenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
ser_service_ticketServiceTicketorg_idBIGINT否所属组织，集团级或公共配置为空普通
ser_service_ticketServiceTicketcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
ser_service_ticketServiceTicketcreated_byBIGINT是创建人账号 ID普通
ser_service_ticketServiceTicketcreated_atDATETIME是创建时间普通
ser_service_ticketServiceTicketupdated_byBIGINT否最后更新人账号 ID普通
ser_service_ticketServiceTicketupdated_atDATETIME否最后更新时间普通
ser_service_ticketServiceTicketis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
ser_service_ticketServiceTicketdeleted_atDATETIME否删除时间，未删除为空普通
ser_service_ticketServiceTicketdeleted_byBIGINT否删除人账号 ID，未删除为空普通
ser_service_ticketServiceTicketversionINT是乐观锁版本号，写操作必须校验普通
ser_service_ticketServiceTicketticket_noVARCHAR(64)是工单编号，唯一普通
ser_service_ticketServiceTicketstudent_idBIGINT否学员 ID普通
ser_service_ticketServiceTicketguardian_idBIGINT否家长 ID普通
ser_service_ticketServiceTicketticket_typeVARCHAR(32)是咨询/投诉/风险/售后/转介绍普通
ser_service_ticketServiceTicketticket_contentTEXT是工单内容普通
ser_service_ticketServiceTicketpriorityVARCHAR(32)是普通/紧急/高风险普通
ser_service_ticketServiceTicketticket_statusVARCHAR(32)是待处理/处理中/待确认/已关闭普通

JSON 字段结构与校验

表名对象字段结构编码结构定义校验规则示例
edu_courseCourse/Productgrade_scopeGENERICobject | array必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本{"version":1,"items":[]}
edu_product_packageCoursePackagecampus_scopeORG_SCOPE{scopeType:string, orgIds:number[], campusIds:number[], includeChildren:boolean}组织和校区必须在当前租户授权范围内{"scopeType":"CAMPUS","campusIds":[101,102],"includeChildren":false}
edu_leave_requestLeaveRequestproof_file_idsID_LISTarray<number>数组长度 1-500；元素必须为已存在且未逻辑删除的业务 ID[10001,10002]
edu_makeup_arrangementMakeupArrangementcandidate_lessonsLESSON_CANDIDATES[{lessonId:number, startAt:string, teacherId:number, capacityLeft:number, conflict:boolean}]候选课次必须已排课、未满班且无时间冲突[{"lessonId":9001,"capacityLeft":3,"conflict":false}]
edu_makeup_arrangementMakeupArrangementmakeup_preferenceLESSON_CANDIDATES[{lessonId:number, startAt:string, teacherId:number, capacityLeft:number, conflict:boolean}]候选课次必须已排课、未满班且无时间冲突[{"lessonId":9001,"capacityLeft":3,"conflict":false}]
edu_homeworkHomeworkcontent_schemaHOMEWORK_CONTENT{questions:[{questionId:number,type:string,score:number}], attachments:number[], submitRule:object}题目必须引用已发布版本；附件必须来自文件中心{"questions":[{"questionId":1,"type":"single","score":5}],"submitRule":{"allowDraft":true}}
edu_homework_reviewHomeworkReviewwrong_question_jsonGENERICobject | array必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本{"version":1,"items":[]}
edu_growth_recordGrowthRecordrecord_contentLEARNING_PROFILE{ability:[{code:string, score:number}], weakPoints:string[], lastReportId?:number}能力分 0-100；来源必须可追溯到课程、作业、测评或直播{"ability":[{"code":"LISTENING","score":82}],"weakPoints":["过去式"]}

状态/枚举标准字典

表名对象字段枚举编码取值终态/流转规则字段说明
edu_courseCourse/Producttenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_courseCourse/Productis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_courseCourse/Productcourse_typeCOURSE_TYPE班课、一对一、直播、录播非终态，可按状态机或字典规则流转班课/一对一/直播/录播
edu_courseCourse/Productgrade_scopeGRADE_SCOPEPRE_K 幼小、PRIMARY_LOW 小学低年级、PRIMARY_HIGH 小学高年级、JUNIOR 初中、SENIOR 高中、CUSTOM 自定义非终态，可按状态机或字典规则流转适用年级
edu_courseCourse/ProductenabledENABLED_STATUS0 停用、1 启用非终态，可按状态机或字典规则流转是否启用
edu_product_packageCoursePackagetenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_product_packageCoursePackageis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_product_packageCoursePackagecampus_scopeCAMPUS_SCOPEALL_CAMPUS 全部校区、REGION_CAMPUS 区域校区、SELECTED_CAMPUS 指定校区、CURRENT_CAMPUS 当前校区、NONE 不限定校区非终态，可按状态机或字典规则流转适用校区
edu_classClasstenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_classClassis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_classClassclass_statusCLASS_STATUS筹备中、开班、结课、停课非终态，可按状态机或字典规则流转筹备中/开班/结课/停课
edu_lessonSchedule/Lessontenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_lessonSchedule/Lessonis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_lessonSchedule/Lessonlesson_statusLESSON_STATUS待上课、上课中、已下课、已取消、需补课包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程待上课/上课中/已下课/已取消/需补课
edu_attendanceAttendancetenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_attendanceAttendanceis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_attendanceAttendancecheckin_typeCHECKIN_TYPE人工、人脸、补签、家长确认非终态，可按状态机或字典规则流转人工/人脸/补签/家长确认
edu_attendanceAttendanceattendance_statusATTENDANCE_STATUS到课、请假、旷课、迟到、待确认非终态，可按状态机或字典规则流转到课/请假/旷课/迟到/待确认
edu_consumptionConsumptiontenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_consumptionConsumptionis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_consumptionConsumptionconsume_statusCONSUME_STATUS待确认、已课消、已冲销、异常非终态，可按状态机或字典规则流转待确认/已课消/已冲销/异常
edu_leave_requestLeaveRequesttenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_leave_requestLeaveRequestis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_leave_requestLeaveRequestleave_statusLEAVE_STATUS待审核、已通过、已驳回、已撤销非终态，可按状态机或字典规则流转待审核/已通过/已驳回/已撤销
edu_leave_requestLeaveRequestapproval_statusAPPROVAL_STATUSNOT_STARTED 未发起、PENDING 审批中、APPROVED 已通过、REJECTED 已驳回、REVOKED 已撤回非终态，可按状态机或字典规则流转审批状态，未发起为空
edu_makeup_arrangementMakeupArrangementtenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_makeup_arrangementMakeupArrangementis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_makeup_arrangementMakeupArrangementarrange_statusARRANGE_STATUS待安排、待确认、已确认、已完成、已取消包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程待安排/待确认/已确认/已完成/已取消
edu_homeworkHomeworktenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_homeworkHomeworkis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_homeworkHomeworkpublish_statusPUBLISH_STATUSDRAFT 草稿、PUBLISHING 发布中、PUBLISHED 已发布、FAILED 发布失败、OFFLINE 已下线、ARCHIVED 已归档包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程草稿/已发布/已关闭
edu_homework_reviewHomeworkReviewtenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_homework_reviewHomeworkReviewis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_homework_reviewHomeworkReviewreview_statusREVIEW_STATUSDRAFT 草稿、PENDING 审核中、APPROVED 已通过、REJECTED 已驳回、DISABLED 已停用包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程待批改/已批改/需订正
edu_growth_recordGrowthRecordtenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
edu_growth_recordGrowthRecordis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
edu_growth_recordGrowthRecordrecord_typeRECORD_TYPE课堂、作业、测评、签到、教师评价非终态，可按状态机或字典规则流转课堂/作业/测评/签到/教师评价
edu_growth_recordGrowthRecordbiz_typeBIZ_TYPELEAD 线索、CUSTOMER 客户、CONTRACT 合同、ORDER 订单、PAYMENT 收款、REFUND 退费、LESSON 课次、CONSUMPTION 课消、EXPENSE 报销、VOUCHER 凭证、INVOICE 发票、LIVE 直播、PATROL 巡课、DEVICE 设备、MATERIAL 物料、PAYROLL 工资非终态，可按状态机或字典规则流转来源业务类型

敏感字段与数据安全策略

来源表名对象字段数据级别脱敏/返回策略明文查看条件导出策略审计要求端侧展示规则
本模块对象edu_attendanceAttendancecheckin_type普通FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；人脸照片查看、下发、删除需授权和审计禁止常规导出；仅设备下发、授权撤回和合规取证场景允许人脸采集、下发、识别、撤回、删除、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取
引用对象sys_userUser/Employeemobile敏感MOBILE_MASK默认展示 138****0000；明文查看需字段权限或敏感字段查看审批导出手机号必须触发导出审批、下载水印和有效期控制明文查看、复制、导出和批量下载均写入 SensitiveAccessLogPC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息
引用对象sys_userUser/Employeepassword_hash高敏NEVER_RETURN禁止接口返回明文；仅密钥中心/鉴权服务按服务身份读取密钥引用禁止导出；配置导出只允许导出脱敏引用和启停状态配置新增、修改、启停、轮换和失败读取均记录安全审计前端只展示已配置/未配置、到期时间和连通性状态，不展示密钥值
引用对象int_integration_logIntegrationLogrequest_payload敏感PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象int_integration_logIntegrationLogresponse_payload普通PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象sec_sensitive_field_policySensitiveFieldPolicymask_rule普通BIZ_FIELD_MASK按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
引用对象crm_guardianGuardianmobile敏感MOBILE_MASK默认展示 138****0000；明文查看需字段权限或敏感字段查看审批导出手机号必须触发导出审批、下载水印和有效期控制明文查看、复制、导出和批量下载均写入 SensitiveAccessLogPC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息
引用对象crm_guardianGuardianwechat_openid敏感BIZ_FIELD_MASK按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
引用对象stu_studentStudentremark普通BIZ_FIELD_MASK按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
引用对象con_contractContracttax_amount普通TAX_INVOICE_MASK默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看财务导出需审批并加水印；国税官方回执随业务单归档OCR、核验、查重、人工校正、导出和付款阻断均留痕移动端可上传和查看本人报销结果，不展示其他人员票据明文
引用对象dev_face_eventFaceAttendanceEventraw_payload敏感PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看

核心数据表完整字段

表名对象字段类型必填规则数据级别
edu_courseCourse/ProductidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_courseCourse/Producttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_courseCourse/Productorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_courseCourse/Productcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_courseCourse/Productcreated_byBIGINT是创建人账号 ID普通
edu_courseCourse/Productcreated_atDATETIME是创建时间普通
edu_courseCourse/Productupdated_byBIGINT否最后更新人账号 ID普通
edu_courseCourse/Productupdated_atDATETIME否最后更新时间普通
edu_courseCourse/Productis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_courseCourse/Productdeleted_atDATETIME否删除时间，未删除为空普通
edu_courseCourse/Productdeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_courseCourse/ProductversionINT是乐观锁版本号，写操作必须校验普通
edu_courseCourse/Productcourse_codeVARCHAR(64)是课程编码，唯一普通
edu_courseCourse/Productcourse_nameVARCHAR(128)是课程名称普通
edu_courseCourse/ProductsubjectVARCHAR(32)是学科普通
edu_courseCourse/Productcourse_typeVARCHAR(32)是班课/一对一/直播/录播普通
edu_courseCourse/Productgrade_scopeJSON否适用年级普通
edu_courseCourse/ProductenabledTINYINT是是否启用普通
edu_product_packageCoursePackageidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_product_packageCoursePackagetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_product_packageCoursePackageorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_product_packageCoursePackagecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_product_packageCoursePackagecreated_byBIGINT是创建人账号 ID普通
edu_product_packageCoursePackagecreated_atDATETIME是创建时间普通
edu_product_packageCoursePackageupdated_byBIGINT否最后更新人账号 ID普通
edu_product_packageCoursePackageupdated_atDATETIME否最后更新时间普通
edu_product_packageCoursePackageis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_product_packageCoursePackagedeleted_atDATETIME否删除时间，未删除为空普通
edu_product_packageCoursePackagedeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_product_packageCoursePackageversionINT是乐观锁版本号，写操作必须校验普通
edu_product_packageCoursePackagepackage_codeVARCHAR(64)是课包编码，唯一普通
edu_product_packageCoursePackagecourse_idBIGINT是课程 ID普通
edu_product_packageCoursePackagelesson_hoursDECIMAL(8,2)是课时数普通
edu_product_packageCoursePackagesale_priceDECIMAL(18,2)是销售价格普通
edu_product_packageCoursePackagevalid_daysINT是有效期天数普通
edu_product_packageCoursePackagecampus_scopeJSON否适用校区普通
edu_classClassidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_classClasstenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_classClassorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_classClasscampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_classClasscreated_byBIGINT是创建人账号 ID普通
edu_classClasscreated_atDATETIME是创建时间普通
edu_classClassupdated_byBIGINT否最后更新人账号 ID普通
edu_classClassupdated_atDATETIME否最后更新时间普通
edu_classClassis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_classClassdeleted_atDATETIME否删除时间，未删除为空普通
edu_classClassdeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_classClassversionINT是乐观锁版本号，写操作必须校验普通
edu_classClassclass_noVARCHAR(64)是班级编号，唯一普通
edu_classClasscourse_idBIGINT是课程 ID普通
edu_classClassteacher_idBIGINT否主讲教师 ID普通
edu_classClassclassroom_idBIGINT否默认教室 ID普通
edu_classClasscapacityINT是班级容量普通
edu_classClassclass_statusVARCHAR(32)是筹备中/开班/结课/停课普通
edu_lessonSchedule/LessonidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_lessonSchedule/Lessontenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_lessonSchedule/Lessonorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_lessonSchedule/Lessoncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_lessonSchedule/Lessoncreated_byBIGINT是创建人账号 ID普通
edu_lessonSchedule/Lessoncreated_atDATETIME是创建时间普通
edu_lessonSchedule/Lessonupdated_byBIGINT否最后更新人账号 ID普通
edu_lessonSchedule/Lessonupdated_atDATETIME否最后更新时间普通
edu_lessonSchedule/Lessonis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_lessonSchedule/Lessondeleted_atDATETIME否删除时间，未删除为空普通
edu_lessonSchedule/Lessondeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_lessonSchedule/LessonversionINT是乐观锁版本号，写操作必须校验普通
edu_lessonSchedule/Lessonlesson_noVARCHAR(64)是课次编号，唯一普通
edu_lessonSchedule/Lessonclass_idBIGINT是班级 ID普通
edu_lessonSchedule/Lessonteacher_idBIGINT是授课教师 ID普通
edu_lessonSchedule/Lessonclassroom_idBIGINT否教室 ID普通
edu_lessonSchedule/Lessonstart_atDATETIME是上课开始时间普通
edu_lessonSchedule/Lessonend_atDATETIME是上课结束时间普通
edu_lessonSchedule/Lessonlesson_statusVARCHAR(32)是待上课/上课中/已下课/已取消/需补课普通
edu_attendanceAttendanceidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_attendanceAttendancetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_attendanceAttendanceorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_attendanceAttendancecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_attendanceAttendancecreated_byBIGINT是创建人账号 ID普通
edu_attendanceAttendancecreated_atDATETIME是创建时间普通
edu_attendanceAttendanceupdated_byBIGINT否最后更新人账号 ID普通
edu_attendanceAttendanceupdated_atDATETIME否最后更新时间普通
edu_attendanceAttendanceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_attendanceAttendancedeleted_atDATETIME否删除时间，未删除为空普通
edu_attendanceAttendancedeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_attendanceAttendanceversionINT是乐观锁版本号，写操作必须校验普通
edu_attendanceAttendancelesson_idBIGINT是课次 ID普通
edu_attendanceAttendancestudent_idBIGINT是学员 ID普通
edu_attendanceAttendancecheckin_typeVARCHAR(32)是人工/人脸/补签/家长确认普通
edu_attendanceAttendancecheckin_atDATETIME否签到时间普通
edu_attendanceAttendanceattendance_statusVARCHAR(32)是到课/请假/旷课/迟到/待确认普通
edu_attendanceAttendancesource_event_idBIGINT否来源设备或操作事件普通
edu_consumptionConsumptionidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_consumptionConsumptiontenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_consumptionConsumptionorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_consumptionConsumptioncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_consumptionConsumptioncreated_byBIGINT是创建人账号 ID普通
edu_consumptionConsumptioncreated_atDATETIME是创建时间普通
edu_consumptionConsumptionupdated_byBIGINT否最后更新人账号 ID普通
edu_consumptionConsumptionupdated_atDATETIME否最后更新时间普通
edu_consumptionConsumptionis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_consumptionConsumptiondeleted_atDATETIME否删除时间，未删除为空普通
edu_consumptionConsumptiondeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_consumptionConsumptionversionINT是乐观锁版本号，写操作必须校验普通
edu_consumptionConsumptionlesson_idBIGINT是课次 ID普通
edu_consumptionConsumptionstudent_idBIGINT是学员 ID普通
edu_consumptionConsumptioncontract_idBIGINT是合同 ID普通
edu_consumptionConsumptionconsumed_hoursDECIMAL(8,2)是消耗课时普通
edu_consumptionConsumptionconsume_amountDECIMAL(18,2)否课消金额普通
edu_consumptionConsumptionconsume_statusVARCHAR(32)是待确认/已课消/已冲销/异常普通
edu_leave_requestLeaveRequestidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_leave_requestLeaveRequesttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_leave_requestLeaveRequestorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_leave_requestLeaveRequestcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_leave_requestLeaveRequestcreated_byBIGINT是创建人账号 ID普通
edu_leave_requestLeaveRequestcreated_atDATETIME是创建时间普通
edu_leave_requestLeaveRequestupdated_byBIGINT否最后更新人账号 ID普通
edu_leave_requestLeaveRequestupdated_atDATETIME否最后更新时间普通
edu_leave_requestLeaveRequestis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_leave_requestLeaveRequestdeleted_atDATETIME否删除时间，未删除为空普通
edu_leave_requestLeaveRequestdeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_leave_requestLeaveRequestversionINT是乐观锁版本号，写操作必须校验普通
edu_leave_requestLeaveRequestleave_noVARCHAR(64)是请假编号，唯一普通
edu_leave_requestLeaveRequeststudent_idBIGINT是学员 ID普通
edu_leave_requestLeaveRequestlesson_idBIGINT是课次 ID普通
edu_leave_requestLeaveRequestleave_reasonVARCHAR(512)是请假原因普通
edu_leave_requestLeaveRequestproof_file_idsJSON否证明附件普通
edu_leave_requestLeaveRequestleave_statusVARCHAR(32)是待审核/已通过/已驳回/已撤销普通
edu_leave_requestLeaveRequestapproval_statusVARCHAR(32)否审批状态，未发起为空普通
edu_leave_requestLeaveRequestapproval_instance_idBIGINT否关联审批实例 ID普通
edu_makeup_arrangementMakeupArrangementidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_makeup_arrangementMakeupArrangementtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_makeup_arrangementMakeupArrangementorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_makeup_arrangementMakeupArrangementcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_makeup_arrangementMakeupArrangementcreated_byBIGINT是创建人账号 ID普通
edu_makeup_arrangementMakeupArrangementcreated_atDATETIME是创建时间普通
edu_makeup_arrangementMakeupArrangementupdated_byBIGINT否最后更新人账号 ID普通
edu_makeup_arrangementMakeupArrangementupdated_atDATETIME否最后更新时间普通
edu_makeup_arrangementMakeupArrangementis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_makeup_arrangementMakeupArrangementdeleted_atDATETIME否删除时间，未删除为空普通
edu_makeup_arrangementMakeupArrangementdeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_makeup_arrangementMakeupArrangementversionINT是乐观锁版本号，写操作必须校验普通
edu_makeup_arrangementMakeupArrangementarrangement_noVARCHAR(64)是补课安排编号，唯一普通
edu_makeup_arrangementMakeupArrangementleave_request_idBIGINT否关联请假单普通
edu_makeup_arrangementMakeupArrangementstudent_idBIGINT是学员 ID普通
edu_makeup_arrangementMakeupArrangementcandidate_lessonsJSON否候选补课课次普通
edu_makeup_arrangementMakeupArrangementmakeup_preferenceJSON否家长期望时间普通
edu_makeup_arrangementMakeupArrangementconfirm_deadlineDATETIME否确认截止时间普通
edu_makeup_arrangementMakeupArrangementarrange_statusVARCHAR(32)是待安排/待确认/已确认/已完成/已取消普通
edu_homeworkHomeworkidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_homeworkHomeworktenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_homeworkHomeworkorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_homeworkHomeworkcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_homeworkHomeworkcreated_byBIGINT是创建人账号 ID普通
edu_homeworkHomeworkcreated_atDATETIME是创建时间普通
edu_homeworkHomeworkupdated_byBIGINT否最后更新人账号 ID普通
edu_homeworkHomeworkupdated_atDATETIME否最后更新时间普通
edu_homeworkHomeworkis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_homeworkHomeworkdeleted_atDATETIME否删除时间，未删除为空普通
edu_homeworkHomeworkdeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_homeworkHomeworkversionINT是乐观锁版本号，写操作必须校验普通
edu_homeworkHomeworkhomework_noVARCHAR(64)是作业编号，唯一普通
edu_homeworkHomeworklesson_idBIGINT是课次 ID普通
edu_homeworkHomeworktitleVARCHAR(128)是作业标题普通
edu_homeworkHomeworkcontent_schemaJSON是题目、附件、提交要求普通
edu_homeworkHomeworkdeadline_atDATETIME否截止时间普通
edu_homeworkHomeworkpublish_statusVARCHAR(32)是草稿/已发布/已关闭普通
edu_homework_reviewHomeworkReviewidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_homework_reviewHomeworkReviewtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_homework_reviewHomeworkRevieworg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_homework_reviewHomeworkReviewcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_homework_reviewHomeworkReviewcreated_byBIGINT是创建人账号 ID普通
edu_homework_reviewHomeworkReviewcreated_atDATETIME是创建时间普通
edu_homework_reviewHomeworkReviewupdated_byBIGINT否最后更新人账号 ID普通
edu_homework_reviewHomeworkReviewupdated_atDATETIME否最后更新时间普通
edu_homework_reviewHomeworkReviewis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_homework_reviewHomeworkReviewdeleted_atDATETIME否删除时间，未删除为空普通
edu_homework_reviewHomeworkReviewdeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_homework_reviewHomeworkReviewversionINT是乐观锁版本号，写操作必须校验普通
edu_homework_reviewHomeworkReviewsubmit_idBIGINT是作业提交 ID普通
edu_homework_reviewHomeworkReviewteacher_idBIGINT是批改教师 ID普通
edu_homework_reviewHomeworkReviewscoreDECIMAL(6,2)否得分普通
edu_homework_reviewHomeworkReviewcommentTEXT否评语普通
edu_homework_reviewHomeworkReviewwrong_question_jsonJSON否错题记录普通
edu_homework_reviewHomeworkReviewreview_statusVARCHAR(32)是待批改/已批改/需订正普通
edu_growth_recordGrowthRecordidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_growth_recordGrowthRecordtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_growth_recordGrowthRecordorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_growth_recordGrowthRecordcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_growth_recordGrowthRecordcreated_byBIGINT是创建人账号 ID普通
edu_growth_recordGrowthRecordcreated_atDATETIME是创建时间普通
edu_growth_recordGrowthRecordupdated_byBIGINT否最后更新人账号 ID普通
edu_growth_recordGrowthRecordupdated_atDATETIME否最后更新时间普通
edu_growth_recordGrowthRecordis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_growth_recordGrowthRecorddeleted_atDATETIME否删除时间，未删除为空普通
edu_growth_recordGrowthRecorddeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_growth_recordGrowthRecordversionINT是乐观锁版本号，写操作必须校验普通
edu_growth_recordGrowthRecordstudent_idBIGINT是学员 ID普通
edu_growth_recordGrowthRecordrecord_typeVARCHAR(32)是课堂/作业/测评/签到/教师评价普通
edu_growth_recordGrowthRecordbiz_typeVARCHAR(64)是来源业务类型普通
edu_growth_recordGrowthRecordbiz_idBIGINT是来源业务 ID普通
edu_growth_recordGrowthRecordrecord_contentJSON是成长记录内容普通
edu_growth_recordGrowthRecordvisible_to_parentTINYINT是家长端是否可见普通

数据表与对象映射

表名对象用途完整字段索引建议
edu_courseCourse/Product课程产品id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、course_code(VARCHAR(64),必填)、course_name(VARCHAR(128),必填)、subject(VARCHAR(32),必填)、course_type(VARCHAR(32),必填)、grade_scope(JSON)、enabled(TINYINT,必填)uk_course_code、idx_subject_type
edu_product_packageCoursePackage课包与价格id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、package_code(VARCHAR(64),必填)、course_id(BIGINT,必填)、lesson_hours(DECIMAL(8,2),必填)、sale_price(DECIMAL(18,2),必填)、valid_days(INT,必填)、campus_scope(JSON)uk_package_code、idx_course
edu_classClass班级id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、class_no(VARCHAR(64),必填)、course_id(BIGINT,必填)、teacher_id(BIGINT)、classroom_id(BIGINT)、capacity(INT,必填)、class_status(VARCHAR(32),必填)uk_class_no、idx_course_campus
edu_lessonSchedule/Lesson课次和排课id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、lesson_no(VARCHAR(64),必填)、class_id(BIGINT,必填)、teacher_id(BIGINT,必填)、classroom_id(BIGINT)、start_at(DATETIME,必填)、end_at(DATETIME,必填)、lesson_status(VARCHAR(32),必填)uk_lesson_no、idx_class_time、idx_teacher_time
edu_attendanceAttendance上课签到记录id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、lesson_id(BIGINT,必填)、student_id(BIGINT,必填)、checkin_type(VARCHAR(32),必填)、checkin_at(DATETIME)、attendance_status(VARCHAR(32),必填)、source_event_id(BIGINT)uk_lesson_student、idx_student_status
edu_consumptionConsumption课消记录id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、lesson_id(BIGINT,必填)、student_id(BIGINT,必填)、contract_id(BIGINT,必填)、consumed_hours(DECIMAL(8,2),必填)、consume_amount(DECIMAL(18,2))、consume_status(VARCHAR(32),必填)uk_lesson_student_contract、idx_contract_status
edu_leave_requestLeaveRequest学员请假申请id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、leave_no(VARCHAR(64),必填)、student_id(BIGINT,必填)、lesson_id(BIGINT,必填)、leave_reason(VARCHAR(512),必填)、proof_file_ids(JSON)、leave_status(VARCHAR(32),必填)、approval_status(VARCHAR(32))、approval_instance_id(BIGINT)uk_leave_no、idx_student_status
edu_makeup_arrangementMakeupArrangement补课安排兜底入口id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、arrangement_no(VARCHAR(64),必填)、leave_request_id(BIGINT)、student_id(BIGINT,必填)、candidate_lessons(JSON)、makeup_preference(JSON)、confirm_deadline(DATETIME)、arrange_status(VARCHAR(32),必填)uk_arrangement_no、idx_student_status
edu_homeworkHomework作业任务id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、homework_no(VARCHAR(64),必填)、lesson_id(BIGINT,必填)、title(VARCHAR(128),必填)、content_schema(JSON,必填)、deadline_at(DATETIME)、publish_status(VARCHAR(32),必填)uk_homework_no、idx_lesson
edu_homework_reviewHomeworkReview作业批改与点评id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、submit_id(BIGINT,必填)、teacher_id(BIGINT,必填)、score(DECIMAL(6,2))、comment(TEXT)、wrong_question_json(JSON)、review_status(VARCHAR(32),必填)idx_submit、idx_teacher_status
edu_growth_recordGrowthRecord学习成长档案id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、student_id(BIGINT,必填)、record_type(VARCHAR(32),必填)、biz_type(VARCHAR(64),必填)、biz_id(BIGINT,必填)、record_content(JSON,必填)、visible_to_parent(TINYINT,必填)idx_student_type、idx_biz

12 · 状态机与业务规则

约束业务对象如何流转、何时可编辑、何时触发审批

原型需要把状态标签、可操作按钮和禁用原因展示清楚。
对象状态触发与说明
线索新建 -> 已分配 -> 跟进中 -> 已邀约 -> 已试听 -> 待签约 -> 已成交 -> 已流失顾问跟进、试听反馈、合同创建、流失原因
课次未开始 -> 待签到 -> 已签到 -> 已课消 -> 请假 -> 补课 -> 旷课 -> 异常待确认排课发布、签到、课消、请假、补课和人工确认
积分兑换待锁库 -> 已锁库 -> 待核销 -> 已核销 -> 已取消 -> 已退回学员兑换、库存锁定、前台核销、出库、取消和积分退回
工单新建 -> 已分派 -> 处理中 -> 待家长确认 -> 已关闭 -> 已升级 -> 已驳回投诉建议、服务请求、教学反馈和退费咨询
作业草稿无草稿 -> 编辑中 -> 自动保存中 -> 已保存 -> 待提交 -> 已提交 -> 已删除 -> 已过期 -> 冲突待恢复学员进入作业后可自动或手动保存草稿，提交成功后关闭草稿；删除、过期和多端冲突必须可提示、可审计、可恢复到安全状态
直播连麦请求未举手 -> 已举手排队 -> 教师邀请中 -> 连接中 -> 上麦中 -> 已下麦 -> 已拒绝 -> 已取消 -> 已超时 -> 连接失败学员举手进入队列，教师处理后进入邀请和连接；取消、拒绝、超时、失败、下麦均写入互动事件和连麦请求记录
请假补课草稿 -> 待审批 -> 已同意 -> 已驳回 -> 已取消 -> 补课待安排 -> 补课待确认 -> 补课已预约 -> 已补课 -> 已关闭家长请假、教务审批、课消冻结或回滚、补课安排、家长确认和补课完成
转班转课待测算 -> 待确认 -> 审批中 -> 补差待收 -> 退差待退 -> 已生效 -> 已驳回 -> 已取消顾问或教务发起，完成权益重算、家长确认、审批、收退差和课表变更
试听课已预约 -> 已提醒 -> 已到访 -> 已试听 -> 待反馈 -> 已反馈 -> 已转化 -> 未到访 -> 已关闭预约、提醒、到访签到、教师反馈、家长评价、未到访唤醒和转化
补课改期取消已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正家长发起改期或取消，教务处理候选课次和课消冲正，最终回到补课安排或关闭
课堂端会话待绑定 -> 已绑定 -> 待开课 -> 授课中 -> 暂停中 -> 已结束 -> 异常断开教师或教室设备创建课堂会话，TV 与教师端完成绑定后同步课件、互动和课堂状态；断开后可重连，结束后归档审计。
唯一性校验

教务教学中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

跨校区数据隔离

教务教学中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

敏感操作留痕

教务教学中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

外部接口幂等

教务教学中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

批量失败明细

教务教学中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

状态回退审批

教务教学中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

13 · 权限、审批与消息

动作权限、数据范围、审批触发和消息触达必须闭环

权限需要覆盖菜单、按钮、字段、接口和导出。

动作权限

  • 维护课程：需映射菜单、按钮、接口和字段权限
  • 排课调课：需映射菜单、按钮、接口和字段权限
  • 请假审批：需映射菜单、按钮、接口和字段权限
  • 补课安排：需映射菜单、按钮、接口和字段权限
  • 转班转课：需映射菜单、按钮、接口和字段权限
  • 签到确认：需映射菜单、按钮、接口和字段权限
  • 课消确认：需映射菜单、按钮、接口和字段权限
  • 发布作业：需映射菜单、按钮、接口和字段权限
  • 生成成长档案：需映射菜单、按钮、接口和字段权限

数据范围

  • 总部全量
  • 区域辖区
  • 校区本地
  • 部门/岗位
  • 本人负责
  • 授权班级/学员

审批配置

审批名称触发条件流程结果留痕
退费审批任意退费或转课产生金额冲减学管师确认 -> 校长审批 -> 财务复核通过后进入监管退款，驳回后关闭退费单保留测算明细、附件和退款回执
转校审批学员权益跨校区转移原校区校长 -> 目标校区校长 -> 财务确认权益和服务归属迁移记录转出转入校区和余额
数据导出审批导出客户、学员、人脸、工资、利润等敏感数据申请人 -> 部门主管 -> 数据管理员生成限时下载链接记录用途、字段、下载人和 IP
请假审批与补课安排家长请假通过但未确认补课时间，或补课候选课次需家长确认家长 -> 教务 -> 校长通过后生成补课安排或回到待安排池保留请假原因、课消处理、补课偏好和确认记录
转班转课审批涉及补差、退差、跨校区、班级容量例外或优惠反算课程顾问/教务 -> 校长 -> 财务通过后调整权益、课表和收退差任务保留测算版本、家长确认和生效记录
补课改期取消审批已确认补课需要改期、取消或已课消后冲正家长/教务 -> 班主任/学管师 -> 教务负责人通过后释放原课次资源、重新安排或进入冲正保留原因、课次、课消、消息和处理结果

消息模板

消息接收人触发渠道变量
新线索分配提醒课程顾问线索分配成功站内信、App、企微学员姓名、来源渠道、校区、保护期
试听预约通知家长/教师/顾问试听课预约成功或变更小程序、短信、App上课时间、校区、教室、教师
积分兑换核销通知学员/家长/校区前台兑换成功、即将过期或核销完成小程序、App、站内信礼品名称、兑换码、核销校区、有效期
到校签到通知家长人脸或人工签到成功小程序、App学员姓名、签到时间、校区、课程
签到异常提醒教务/前台识别未匹配或低置信度站内信、App设备、时间、候选学员、置信度
摄像头离线告警设备管理员/校区前台摄像头心跳超时或拉流失败站内信、App校区、教室、摄像头编号、品牌、异常时间
作业发布通知学员/家长教师发布作业小程序、App作业名称、截止时间、课程
作业批改通知学员/家长教师完成批改小程序、App得分、评语、需订正状态

14 · 接口与技术细节

接口需支持幂等、权限、审计、重试和回执

每个写接口必须有 requestId 或业务幂等键，外部回调必须验签和去重。
接口方法方向请求字段响应字段幂等/权限
/api/v1/edu/schedulesPOST/GETPC Web 到教务classId, teacherId, classroomId, lessonTimescheduleId, conflictResult教师/教室/班级冲突校验
/api/v1/edu/leavesPOST/GET家长端/PC Web 到教务studentId, lessonId, leaveReason, attachments, makeupPreference, requestIdleaveId, leaveStatus, makeupArrangeStatusstudentId + lessonId 单活跃请假
/api/v1/edu/makeup-arrangementsPOST/GETPC Web 到教务/家长端leaveId, candidateLessonIds, arrangedAt, confirmDeadline, ownerIdarrangementId, confirmStatus, notifyStatusleaveId 单活跃补课安排
/api/v1/edu/transfersPOST/GETPC Web 到教务合同studentId, sourceClassId, targetClassId, transferType, requestIdtransferId, rightsRecalculateResult, transferStatus班级容量和权益校验
/api/v1/edu/attendancePOST教师端到教务lessonId, studentId, attendanceStatus, sourceattendanceId, lessonStatuslessonId + studentId 幂等
/api/v1/edu/consumptionsPOST教务到财务监管lessonId, contractNo, consumedHours, teacherIdconsumeId, reportStatus课次 + 合同幂等
/api/v1/edu/homeworkPOST/GET教师端到学习中心classId, taskType, content, deadlinetaskId, publishStatus班级权限校验
/api/v1/live/rooms/{id}/joinPOST学员端到直播roomId, userId, clientTypeplayUrl, token, interactionConfig课程权益校验

前端约束

  • 统一登录态和租户校区上下文
  • 列表分页、筛选、排序、列显隐
  • 表单本地校验与服务端错误映射
  • 移动/平板/TV 按终端适配交互

后端约束

  • 领域服务封装业务规则
  • 写操作事务一致性
  • 关键操作审计快照
  • 异步任务失败重试和告警

集成约束

  • 第三方接口统一走开放集成中心
  • 回执文件归档
  • 接口日志可按业务单号追踪
  • 密钥和回调地址按环境隔离

15 · 数据库与存储设计

核心表建议、关键字段和索引方向

详细 DDL 已在平台技术设计文档中统一展开，本处保留模块核心表、关键字段和索引方向。
表名用途核心字段索引建议
edu_course课程产品id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、course_code、course_name、subject、course_type、grade_scope、enableduk_course_code、idx_subject_type
edu_product_package课包与价格id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、package_code、course_id、lesson_hours、sale_price、valid_days、campus_scopeuk_package_code、idx_course
edu_class班级id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、class_no、course_id、teacher_id、classroom_id、capacity、class_statusuk_class_no、idx_course_campus
edu_lesson课次和排课id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、lesson_no、class_id、teacher_id、classroom_id、start_at、end_at、lesson_statusuk_lesson_no、idx_class_time、idx_teacher_time
edu_attendance上课签到记录id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、lesson_id、student_id、checkin_type、checkin_at、attendance_status、source_event_iduk_lesson_student、idx_student_status
edu_consumption课消记录id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、lesson_id、student_id、contract_id、consumed_hours、consume_amount、consume_statusuk_lesson_student_contract、idx_contract_status
edu_leave_request学员请假申请id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、leave_no、student_id、lesson_id、leave_reason、proof_file_ids、leave_status、approval_status、approval_instance_iduk_leave_no、idx_student_status
edu_makeup_arrangement补课安排兜底入口id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、arrangement_no、leave_request_id、student_id、candidate_lessons、makeup_preference、confirm_deadline、arrange_statusuk_arrangement_no、idx_student_status
edu_homework作业任务id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、homework_no、lesson_id、title、content_schema、deadline_at、publish_statusuk_homework_no、idx_lesson
edu_homework_review作业批改与点评id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、submit_id、teacher_id、score、comment、wrong_question_json、review_statusidx_submit、idx_teacher_status
edu_growth_record学习成长档案id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、student_id、record_type、biz_type、biz_id、record_content、visible_to_parentidx_student_type、idx_biz

DDL 草案

edu_courseCourse/Product 
CREATE TABLE `edu_course` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `course_code` VARCHAR(64) NOT NULL COMMENT '课程编码，唯一；数据级别：普通',
  `course_name` VARCHAR(128) NOT NULL COMMENT '课程名称；数据级别：普通',
  `subject` VARCHAR(32) NOT NULL COMMENT '学科；数据级别：普通',
  `course_type` VARCHAR(32) NOT NULL COMMENT '班课/一对一/直播/录播；数据级别：普通',
  `grade_scope` JSON NULL COMMENT '适用年级；数据级别：普通',
  `enabled` TINYINT NOT NULL COMMENT '是否启用；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_course_code` (`course_code`),
  KEY `idx_subject_type` (`subject`, `course_type`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Course/Product：课程产品';
edu_product_packageCoursePackage 
CREATE TABLE `edu_product_package` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `package_code` VARCHAR(64) NOT NULL COMMENT '课包编码，唯一；数据级别：普通',
  `course_id` BIGINT NOT NULL COMMENT '课程 ID；数据级别：普通',
  `lesson_hours` DECIMAL(8,2) NOT NULL COMMENT '课时数；数据级别：普通',
  `sale_price` DECIMAL(18,2) NOT NULL COMMENT '销售价格；数据级别：普通',
  `valid_days` INT NOT NULL COMMENT '有效期天数；数据级别：普通',
  `campus_scope` JSON NULL COMMENT '适用校区；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_package_code` (`package_code`),
  KEY `idx_course` (`course_id`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='CoursePackage：课包与价格';
edu_classClass 
CREATE TABLE `edu_class` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `class_no` VARCHAR(64) NOT NULL COMMENT '班级编号，唯一；数据级别：普通',
  `course_id` BIGINT NOT NULL COMMENT '课程 ID；数据级别：普通',
  `teacher_id` BIGINT NULL COMMENT '主讲教师 ID；数据级别：普通',
  `classroom_id` BIGINT NULL COMMENT '默认教室 ID；数据级别：普通',
  `capacity` INT NOT NULL COMMENT '班级容量；数据级别：普通',
  `class_status` VARCHAR(32) NOT NULL COMMENT '筹备中/开班/结课/停课；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_class_no` (`class_no`),
  KEY `idx_course_campus` (`course_id`, `campus_id`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Class：班级';
edu_lessonSchedule/Lesson 
CREATE TABLE `edu_lesson` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `lesson_no` VARCHAR(64) NOT NULL COMMENT '课次编号，唯一；数据级别：普通',
  `class_id` BIGINT NOT NULL COMMENT '班级 ID；数据级别：普通',
  `teacher_id` BIGINT NOT NULL COMMENT '授课教师 ID；数据级别：普通',
  `classroom_id` BIGINT NULL COMMENT '教室 ID；数据级别：普通',
  `start_at` DATETIME NOT NULL COMMENT '上课开始时间；数据级别：普通',
  `end_at` DATETIME NOT NULL COMMENT '上课结束时间；数据级别：普通',
  `lesson_status` VARCHAR(32) NOT NULL COMMENT '待上课/上课中/已下课/已取消/需补课；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_lesson_no` (`lesson_no`),
  KEY `idx_class_time` (`class_id`),
  KEY `idx_teacher_time` (`teacher_id`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Schedule/Lesson：课次和排课';
edu_attendanceAttendance 
CREATE TABLE `edu_attendance` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `lesson_id` BIGINT NOT NULL COMMENT '课次 ID；数据级别：普通',
  `student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
  `checkin_type` VARCHAR(32) NOT NULL COMMENT '人工/人脸/补签/家长确认；数据级别：普通',
  `checkin_at` DATETIME NULL COMMENT '签到时间；数据级别：普通',
  `attendance_status` VARCHAR(32) NOT NULL COMMENT '到课/请假/旷课/迟到/待确认；数据级别：普通',
  `source_event_id` BIGINT NULL COMMENT '来源设备或操作事件；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_lesson_student` (`lesson_id`, `student_id`),
  KEY `idx_student_status` (`student_id`, `attendance_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Attendance：上课签到记录';
edu_consumptionConsumption 
CREATE TABLE `edu_consumption` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `lesson_id` BIGINT NOT NULL COMMENT '课次 ID；数据级别：普通',
  `student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
  `contract_id` BIGINT NOT NULL COMMENT '合同 ID；数据级别：普通',
  `consumed_hours` DECIMAL(8,2) NOT NULL COMMENT '消耗课时；数据级别：普通',
  `consume_amount` DECIMAL(18,2) NULL COMMENT '课消金额；数据级别：普通',
  `consume_status` VARCHAR(32) NOT NULL COMMENT '待确认/已课消/已冲销/异常；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_lesson_student_contract` (`lesson_id`, `student_id`, `contract_id`),
  KEY `idx_contract_status` (`contract_id`, `consume_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Consumption：课消记录';
edu_leave_requestLeaveRequest 
CREATE TABLE `edu_leave_request` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `leave_no` VARCHAR(64) NOT NULL COMMENT '请假编号，唯一；数据级别：普通',
  `student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
  `lesson_id` BIGINT NOT NULL COMMENT '课次 ID；数据级别：普通',
  `leave_reason` VARCHAR(512) NOT NULL COMMENT '请假原因；数据级别：普通',
  `proof_file_ids` JSON NULL COMMENT '证明附件；数据级别：普通',
  `leave_status` VARCHAR(32) NOT NULL COMMENT '待审核/已通过/已驳回/已撤销；数据级别：普通',
  `approval_status` VARCHAR(32) NULL COMMENT '审批状态，未发起为空；数据级别：普通',
  `approval_instance_id` BIGINT NULL COMMENT '关联审批实例 ID；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_leave_no` (`leave_no`),
  KEY `idx_student_status` (`student_id`, `leave_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='LeaveRequest：学员请假申请';
edu_makeup_arrangementMakeupArrangement 
CREATE TABLE `edu_makeup_arrangement` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `arrangement_no` VARCHAR(64) NOT NULL COMMENT '补课安排编号，唯一；数据级别：普通',
  `leave_request_id` BIGINT NULL COMMENT '关联请假单；数据级别：普通',
  `student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
  `candidate_lessons` JSON NULL COMMENT '候选补课课次；数据级别：普通',
  `makeup_preference` JSON NULL COMMENT '家长期望时间；数据级别：普通',
  `confirm_deadline` DATETIME NULL COMMENT '确认截止时间；数据级别：普通',
  `arrange_status` VARCHAR(32) NOT NULL COMMENT '待安排/待确认/已确认/已完成/已取消；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_arrangement_no` (`arrangement_no`),
  KEY `idx_student_status` (`student_id`, `arrange_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='MakeupArrangement：补课安排兜底入口';
edu_homeworkHomework 
CREATE TABLE `edu_homework` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `homework_no` VARCHAR(64) NOT NULL COMMENT '作业编号，唯一；数据级别：普通',
  `lesson_id` BIGINT NOT NULL COMMENT '课次 ID；数据级别：普通',
  `title` VARCHAR(128) NOT NULL COMMENT '作业标题；数据级别：普通',
  `content_schema` JSON NOT NULL COMMENT '题目、附件、提交要求；数据级别：普通',
  `deadline_at` DATETIME NULL COMMENT '截止时间；数据级别：普通',
  `publish_status` VARCHAR(32) NOT NULL COMMENT '草稿/已发布/已关闭；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_homework_no` (`homework_no`),
  KEY `idx_lesson` (`lesson_id`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Homework：作业任务';
edu_homework_reviewHomeworkReview 
CREATE TABLE `edu_homework_review` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `submit_id` BIGINT NOT NULL COMMENT '作业提交 ID；数据级别：普通',
  `teacher_id` BIGINT NOT NULL COMMENT '批改教师 ID；数据级别：普通',
  `score` DECIMAL(6,2) NULL COMMENT '得分；数据级别：普通',
  `comment` TEXT NULL COMMENT '评语；数据级别：普通',
  `wrong_question_json` JSON NULL COMMENT '错题记录；数据级别：普通',
  `review_status` VARCHAR(32) NOT NULL COMMENT '待批改/已批改/需订正；数据级别：普通',
  PRIMARY KEY (`id`),
  KEY `idx_submit` (`submit_id`),
  KEY `idx_teacher_status` (`teacher_id`, `review_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='HomeworkReview：作业批改与点评';
edu_growth_recordGrowthRecord 
CREATE TABLE `edu_growth_record` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
  `record_type` VARCHAR(32) NOT NULL COMMENT '课堂/作业/测评/签到/教师评价；数据级别：普通',
  `biz_type` VARCHAR(64) NOT NULL COMMENT '来源业务类型；数据级别：普通',
  `biz_id` BIGINT NOT NULL COMMENT '来源业务 ID；数据级别：普通',
  `record_content` JSON NOT NULL COMMENT '成长记录内容；数据级别：普通',
  `visible_to_parent` TINYINT NOT NULL COMMENT '家长端是否可见；数据级别：普通',
  PRIMARY KEY (`id`),
  KEY `idx_student_type` (`student_id`, `record_type`),
  KEY `idx_biz` (`biz_type`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='GrowthRecord：学习成长档案';

16 · 异常、指标、测试与初始化

保证模块上线后可运营、可追踪、可验收

测试要覆盖主流程、异常流、权限流、接口失败和数据一致性。

异常状态

排课冲突签到异常课消待确认补课时间未确认补课课次容量不足教师课表冲突转课补差未支付试听未到访试听反馈缺失补课改期超时补课已课消取消补课资源释放失败

指标埋点

排课冲突率签到率课消及时率作业提交率阶段测评完成率

测试用例

编号场景前置步骤预期优先级
TC-003试听预约和反馈线索已分配并选择体验课预约试听、教师填写反馈客户状态更新，生成报价任务高
TC-008人脸签到自动课消学员已授权人脸且课次待签到模拟设备回传识别事件签到成功、课消成功、家长收到通知高
TC-010家长撤回人脸授权学员已授权并下发设备家长撤回授权系统停止识别并生成设备删除任务高
TC-011学员端访问授权资源合同权益生效学员登录微信小程序或 App 打开课程资源资源可访问并记录学习进度，家长端仅查看学习报告摘要高
TC-012合同到期资源自动失效合同有效期已过学员访问课程资源提示权限过期，不再播放资源高
TC-013教师发布作业并批改课次已完成教师发布作业，学员提交，教师批改学员端展示批改结果和成长档案中
TC-014学管风险预警生成学员剩余课时低于阈值刷新风险学员池生成续费培育任务并通知学管高
TC-018活码动态内容切换同一二维码配置不同班级资源不同学员扫码返回对应授权资源并记录扫码数据高
TC-020移动端兼容检查准备家长小程序/H5、学员小程序、iPhone、iPad、安卓 App 环境分别登录家长端和学员端执行核心学习、缴费、授权、审批流程两个端的首页、权限、任务和通知互不混淆，关键操作可完成中
TC-024无权限页面状态学员账号访问管理后台 URL直接访问页面地址展示无权限状态且不泄露数据高
TC-EDU-ENH-001补课兜底交付闭环验收请假详情、补课安排池、家长确认页相关基础数据、权限、审批流、消息模板和接口配置已初始化按新增补课安排池、候选课次、确认截止、超时提醒、教务代安排和家长确认流程。执行前端提交、后端处理、状态流转、异常重试和消息触达请假后未确认时间的学员不会丢失，均进入补课待安排状态。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-EDU-ENH-002课消回滚交付闭环验收课次详情、考勤异常、课消确认相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐课消冻结、自动课消、人工确认、冲正审批和财务监管报送联动。执行前端提交、后端处理、状态流转、异常重试和消息触达任何课消变更均可追溯原因、审批、财务影响和监管状态。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-EDU-ENH-003教学反馈交付闭环验收课后点评、作业批改、测评报告、成长档案相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐课堂点评、作业批改、阶段测评、成长档案更新和家长端通知。执行前端提交、后端处理、状态流转、异常重试和消息触达学习结果能回写学员端、家长端、教师端和服务中心。；同时产生审计日志、指标埋点和必要的补偿任务高

上线初始化

初始化项动作数据验收
账号与权限初始化总部、区域、校区、顾问、教务、教师、财务、家长、学员角色账号、角色、菜单、按钮、字段、数据范围测试账号可按角色访问指定页面
审批规则配置优惠、退费、转课、导出、薪资、课消撤销审批流审批对象、条件、节点、超时提醒测试单据可进入正确审批链
远程巡课导入存量教室摄像头并配置品牌接入、地图点位和录像留存策略摄像头编号、品牌型号、网关配置、校区教室、楼层点位、存储策略摄像头可在地图中显示状态，直播和回放链路可抽检通过
微信与 App配置小程序、公众号、App 推送和登录参数AppID、Secret、模板消息、包名、证书家长、学员、教师可正常登录和收消息
教研资源导入首批课程资源、题库、作业、测评和活码规则资源分类、课次、权限、有效期、版本学员端可按权益访问资源
积分商城配置积分规则、礼品 SKU、兑换积分、核销校区和库存联动积分来源、积分有效期、礼品库存、兑换规则、核销权限学员兑换后可锁库，前台核销后可出库
数据迁移迁移客户、学员、合同、剩余课时、课表、教师、员工基础数据源系统字段映射、校验结果、差异清单关键业务对象数量和余额一致
直播角色与权限初始化直播管理员、教务直播运营、教师主播、助教、学员、员工参会、市场运营等权限菜单、按钮、数据范围、导出审批、回放权限各角色只能访问授权直播房间和回放
补课兜底交付配置初始化新增补课安排池、候选课次、确认截止、超时提醒、教务代安排和家长确认流程。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限请假详情、补课安排池、家长确认页请假后未确认时间的学员不会丢失，均进入补课待安排状态。
课消回滚交付配置初始化补齐课消冻结、自动课消、人工确认、冲正审批和财务监管报送联动。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限课次详情、考勤异常、课消确认任何课消变更均可追溯原因、审批、财务影响和监管状态。
教学反馈交付配置初始化补齐课堂点评、作业批改、阶段测评、成长档案更新和家长端通知。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限课后点评、作业批改、测评报告、成长档案学习结果能回写学员端、家长端、教师端和服务中心。