10-学员端学习中心详细PRD

01 · 模块定位

学员端学习中心

学员端需覆盖微信小程序、iOS/iPadOS App、安卓手机/安卓平板 App、H5/Web 学习中心、macOS/Windows Tauri 桌面学习中心；合同激活后自动开通学习权益，学员端只处理学习、作业、测评、积分和兑换任务，合同缴费、人脸授权采集和发票由家长端或后台主责。

业务目标

面向学员独立提供登录注册、课程学习、直播互动、作业测评、成长档案、积分商城、消息个人中心和 Tauri 桌面学习中心。

使用终端

微信小程序、iPhone App、iPad App、安卓手机 App、安卓平板 App、H5/Web 学习中心、macOS/Windows Tauri 桌面学习中心。

验收主线

02 · 范围边界

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

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

模块内范围

01 启动页
02 登录页
03 非学员注册登录页
04 找回密码页
05 账号注销申请页
06 学习首页
07 我的课程页
08 课程详情页
09 资源/回放播放页
10 直播课表/预告页
11 直播课堂页
12 作业列表页
13 作业提交页
14 作业结果与订正页
15 测评考试页
16 测评报告页
17 学习档案页
18 错题本页
19 积分中心页
20 礼品详情页
21 兑换记录与订单详情页
22 消息中心页
23 个人中心页
24 隐私与授权页
25 桌面端学习中心首页
26 桌面端播放/直播适配页
S01 账号未激活/绑定审核中状态
S02 权益不足/资源过期/合同到期状态
S03 直播互动答题/举手连麦弹窗/侧栏
S04 学习完成/获得积分弹窗
S05 兑换确认/兑换结果/核销码展示弹窗
S06 桌面端同步失败/接口失败/无权限状态
S07 作品预览/播放弹窗
S08 当前上课学员选择弹窗

上游依赖

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

下游输出

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

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

学员端学习中心必须承接的已确认规则

本章节来自待决策与澄清清单的收口结果，已经转为本模块 PRD 的正式需求、配置项或默认实施规则。

分类	事项	本模块落地要求	责任方
默认实施规则	iOS/iPadOS 原生视觉策略	UI 优先设计原生质感，工程上能用原生控件就用，不能用则跨端降级；不设 Liquid Glass 专项验收。	产品/UI/前端
默认实施规则	接口设计说明书组织方式	采用单独 HTML 文件集中管理接口协议；模块 PRD 保留模块级接口摘要，避免每个模块重复写通用协议。	产品/研发
默认实施规则	接口错误码与重试中间件	所有外部接口和内部异步任务统一错误码、幂等键、重试次数、告警阈值和回执归档策略。	后端/测试/运维

04 · 业务流程

学员端学习中心主流程

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

0101 启动页

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

0202 登录页

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

0303 非学员注册登录页

03 非学员注册登录页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。

0404 找回密码页

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

0505 账号注销申请页

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

0606 学习首页

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

0707 我的课程页

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

0808 课程详情页

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

05 · 功能清单

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

每一行功能都需要在原型中体现入口、状态、按钮、字段和反馈。

一级功能	二级功能	功能说明	规则/验收
01 启动页	端侧操作	01 启动页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
01 启动页	业务处理	01 启动页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
01 启动页	异常闭环	学员账号未激活处理	失败原因可见、可重试、可转人工、可追溯
02 登录页	端侧操作	02 登录页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
02 登录页	业务处理	02 登录页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
02 登录页	异常闭环	资源过期处理	失败原因可见、可重试、可转人工、可追溯
03 非学员注册登录页	端侧操作	03 非学员注册登录页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
03 非学员注册登录页	业务处理	03 非学员注册登录页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
03 非学员注册登录页	异常闭环	权益不足处理	失败原因可见、可重试、可转人工、可追溯
04 找回密码页	端侧操作	04 找回密码页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
04 找回密码页	业务处理	04 找回密码页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
04 找回密码页	异常闭环	礼品库存不足处理	失败原因可见、可重试、可转人工、可追溯
05 账号注销申请页	端侧操作	05 账号注销申请页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
05 账号注销申请页	业务处理	05 账号注销申请页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
05 账号注销申请页	异常闭环	作业草稿过期处理	失败原因可见、可重试、可转人工、可追溯
06 学习首页	端侧操作	06 学习首页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
06 学习首页	业务处理	06 学习首页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
06 学习首页	异常闭环	多端草稿冲突处理	失败原因可见、可重试、可转人工、可追溯
07 我的课程页	端侧操作	07 我的课程页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
07 我的课程页	业务处理	07 我的课程页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
07 我的课程页	异常闭环	直播连麦邀请超时处理	失败原因可见、可重试、可转人工、可追溯
08 课程详情页	端侧操作	08 课程详情页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
08 课程详情页	业务处理	08 课程详情页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
08 课程详情页	异常闭环	兑换码过期处理	失败原因可见、可重试、可转人工、可追溯
09 资源/回放播放页	端侧操作	09 资源/回放播放页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
09 资源/回放播放页	业务处理	09 资源/回放播放页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
09 资源/回放播放页	异常闭环	库存释放失败处理	失败原因可见、可重试、可转人工、可追溯
10 直播课表/预告页	端侧操作	10 直播课表/预告页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
10 直播课表/预告页	业务处理	10 直播课表/预告页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
10 直播课表/预告页	异常闭环	回放已下架处理	失败原因可见、可重试、可转人工、可追溯
11 直播课堂页	端侧操作	11 直播课堂页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
11 直播课堂页	业务处理	11 直播课堂页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
11 直播课堂页	异常闭环	回放权限不足处理	失败原因可见、可重试、可转人工、可追溯
12 作业列表页	端侧操作	12 作业列表页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
12 作业列表页	业务处理	12 作业列表页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
12 作业列表页	异常闭环	学员账号未激活处理	失败原因可见、可重试、可转人工、可追溯
13 作业提交页	端侧操作	13 作业提交页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
13 作业提交页	业务处理	13 作业提交页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
13 作业提交页	异常闭环	资源过期处理	失败原因可见、可重试、可转人工、可追溯
14 作业结果与订正页	端侧操作	14 作业结果与订正页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
14 作业结果与订正页	业务处理	14 作业结果与订正页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
14 作业结果与订正页	异常闭环	权益不足处理	失败原因可见、可重试、可转人工、可追溯
15 测评考试页	端侧操作	15 测评考试页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
15 测评考试页	业务处理	15 测评考试页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
15 测评考试页	异常闭环	礼品库存不足处理	失败原因可见、可重试、可转人工、可追溯
16 测评报告页	端侧操作	16 测评报告页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
16 测评报告页	业务处理	16 测评报告页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
16 测评报告页	异常闭环	作业草稿过期处理	失败原因可见、可重试、可转人工、可追溯
17 学习档案页	端侧操作	17 学习档案页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
17 学习档案页	业务处理	17 学习档案页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
17 学习档案页	异常闭环	多端草稿冲突处理	失败原因可见、可重试、可转人工、可追溯
18 错题本页	端侧操作	18 错题本页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
18 错题本页	业务处理	18 错题本页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
18 错题本页	异常闭环	直播连麦邀请超时处理	失败原因可见、可重试、可转人工、可追溯
19 积分中心页	端侧操作	19 积分中心页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
19 积分中心页	业务处理	19 积分中心页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
19 积分中心页	异常闭环	兑换码过期处理	失败原因可见、可重试、可转人工、可追溯
20 礼品详情页	端侧操作	20 礼品详情页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
20 礼品详情页	业务处理	20 礼品详情页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
20 礼品详情页	异常闭环	库存释放失败处理	失败原因可见、可重试、可转人工、可追溯
21 兑换记录与订单详情页	端侧操作	21 兑换记录与订单详情页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
21 兑换记录与订单详情页	业务处理	21 兑换记录与订单详情页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
21 兑换记录与订单详情页	异常闭环	回放已下架处理	失败原因可见、可重试、可转人工、可追溯
22 消息中心页	端侧操作	22 消息中心页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
22 消息中心页	业务处理	22 消息中心页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
22 消息中心页	异常闭环	回放权限不足处理	失败原因可见、可重试、可转人工、可追溯
23 个人中心页	端侧操作	23 个人中心页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
23 个人中心页	业务处理	23 个人中心页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
23 个人中心页	异常闭环	学员账号未激活处理	失败原因可见、可重试、可转人工、可追溯
24 隐私与授权页	端侧操作	24 隐私与授权页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
24 隐私与授权页	业务处理	24 隐私与授权页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
24 隐私与授权页	异常闭环	资源过期处理	失败原因可见、可重试、可转人工、可追溯
25 桌面端学习中心首页	端侧操作	25 桌面端学习中心首页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
25 桌面端学习中心首页	业务处理	25 桌面端学习中心首页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
25 桌面端学习中心首页	异常闭环	权益不足处理	失败原因可见、可重试、可转人工、可追溯
26 桌面端播放/直播适配页	端侧操作	26 桌面端播放/直播适配页支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
26 桌面端播放/直播适配页	业务处理	26 桌面端播放/直播适配页需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
26 桌面端播放/直播适配页	异常闭环	礼品库存不足处理	失败原因可见、可重试、可转人工、可追溯
S01 账号未激活/绑定审核中状态	端侧操作	S01 账号未激活/绑定审核中状态支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
S01 账号未激活/绑定审核中状态	业务处理	S01 账号未激活/绑定审核中状态需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
S01 账号未激活/绑定审核中状态	异常闭环	作业草稿过期处理	失败原因可见、可重试、可转人工、可追溯
S02 权益不足/资源过期/合同到期状态	端侧操作	S02 权益不足/资源过期/合同到期状态支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
S02 权益不足/资源过期/合同到期状态	业务处理	S02 权益不足/资源过期/合同到期状态需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
S02 权益不足/资源过期/合同到期状态	异常闭环	多端草稿冲突处理	失败原因可见、可重试、可转人工、可追溯
S03 直播互动答题/举手连麦弹窗/侧栏	端侧操作	S03 直播互动答题/举手连麦弹窗/侧栏支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
S03 直播互动答题/举手连麦弹窗/侧栏	业务处理	S03 直播互动答题/举手连麦弹窗/侧栏需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
S03 直播互动答题/举手连麦弹窗/侧栏	异常闭环	直播连麦邀请超时处理	失败原因可见、可重试、可转人工、可追溯
S04 学习完成/获得积分弹窗	端侧操作	S04 学习完成/获得积分弹窗支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
S04 学习完成/获得积分弹窗	业务处理	S04 学习完成/获得积分弹窗需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
S04 学习完成/获得积分弹窗	异常闭环	兑换码过期处理	失败原因可见、可重试、可转人工、可追溯
S05 兑换确认/兑换结果/核销码展示弹窗	端侧操作	S05 兑换确认/兑换结果/核销码展示弹窗支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
S05 兑换确认/兑换结果/核销码展示弹窗	业务处理	S05 兑换确认/兑换结果/核销码展示弹窗需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
S05 兑换确认/兑换结果/核销码展示弹窗	异常闭环	库存释放失败处理	失败原因可见、可重试、可转人工、可追溯
S06 桌面端同步失败/接口失败/无权限状态	端侧操作	S06 桌面端同步失败/接口失败/无权限状态支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
S06 桌面端同步失败/接口失败/无权限状态	业务处理	S06 桌面端同步失败/接口失败/无权限状态需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
S06 桌面端同步失败/接口失败/无权限状态	异常闭环	回放已下架处理	失败原因可见、可重试、可转人工、可追溯
S07 作品预览/播放弹窗	端侧操作	S07 作品预览/播放弹窗支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
S07 作品预览/播放弹窗	业务处理	S07 作品预览/播放弹窗需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
S07 作品预览/播放弹窗	异常闭环	回放权限不足处理	失败原因可见、可重试、可转人工、可追溯
S08 当前上课学员选择弹窗	端侧操作	S08 当前上课学员选择弹窗支持进入、查看、提交、取消、恢复、结果反馈和消息提醒。	权益、状态、端类型和本人账号权限必须校验
S08 当前上课学员选择弹窗	业务处理	S08 当前上课学员选择弹窗需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。	必须联动状态、权限、消息、审批和指标
S08 当前上课学员选择弹窗	异常闭环	学员账号未激活处理	失败原因可见、可重试、可转人工、可追溯

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

功能域	承接对象	核心表	代表接口	状态机/状态字段	研发落地校验
01 启动页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/01	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
02 登录页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/02	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
03 非学员注册登录页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/03	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
04 找回密码页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/04	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
05 账号注销申请页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/05	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
06 学习首页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/06	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
07 我的课程页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/07	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
08 课程详情页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/08	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
09 资源/回放播放页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	GET /api/v1/student/resources	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
10 直播课表/预告页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/10	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
11 直播课堂页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/11	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
12 作业列表页	StudentAccount、StudentSessionSelection、StudentDeviceSession、StudentPortfolioItem	stu_account、stu_session_selection、stu_device_session、stu_portfolio_item	接口资源组 /api/v1/app/features/12	account_type、login_status、cancel_request_status、selection_status、client_type、session_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
13 作业提交页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/13	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
14 作业结果与订正页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/14	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
15 测评考试页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/15	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
16 测评报告页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/16	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
17 学习档案页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/17	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
18 错题本页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/18	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
19 积分中心页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/19	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
20 礼品详情页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/20	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
21 兑换记录与订单详情页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/21	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
22 消息中心页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/22	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
23 个人中心页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/23	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
24 隐私与授权页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/24	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
25 桌面端学习中心首页	StudentAccount、HomeworkDraft	stu_account、edu_homework_draft	接口资源组 /api/v1/app/features/25	account_type、login_status、cancel_request_status、draft_status、client_type、conflict_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
26 桌面端播放/直播适配页	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/26	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
S01 账号未激活/绑定审核中状态	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/27	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
S02 权益不足/资源过期/合同到期状态	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/28	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
S03 直播互动答题/举手连麦弹窗/侧栏	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/29	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
S04 学习完成/获得积分弹窗	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/30	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
S05 兑换确认/兑换结果/核销码展示弹窗	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/31	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
S06 桌面端同步失败/接口失败/无权限状态	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/32	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
S07 作品预览/播放弹窗	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/33	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
S08 当前上课学员选择弹窗	StudentAccount、StudentAccountRegistration、StudentSessionSelection、StudentDeviceSession	stu_account、stu_account_registration、stu_session_selection、stu_device_session	接口资源组 /api/v1/app/features/34	account_type、login_status、cancel_request_status、password_set_status、register_status、selection_status	新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计

06 · 原子级功能需求

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

需求编号可直接进入项目管理工具。

编号	需求描述	入口页面	关键动作	输入校验	输出结果	异常处理	验收标准
FR-APP-001	学员端原型范围按 26 个独立页面/适配画板 + 8 个弹窗/状态画板组织，主页面和状态画板均需在 PRD 中可追溯到字段、动作、异常和验收口径	启动与登录	进入学员端	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	网络异常、版本过低、登录失效、学员账号未激活或绑定审核中时提示处理路径	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-002	学校提供账号的正式学员使用学员用户名 + 密码登录，登录后自动同步学员基础信息、课程权益、班级和学习任务	学员用户名密码登录	学校发放账号登录	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	用户名或密码错误、学员信息同步失败、账号锁定或协议未勾选时阻断并提示	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-003	非学员支持手机号自主注册，注册后支持手机号 + 密码或手机号 + 验证码登录；手机号已注册、验证码错误、协议未勾选和注册审核中必须有明确状态	非学员手机号注册登录	手机号注册或登录	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	手机号已注册、验证码错误、密码规则不满足、注册审核中或无绑定学员时给出可重试路径	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-004	同一手机号或同一账号关联多个学员时，进入学习中心前必须选择当前上课学员；学习记录、作业、积分、直播签到和消息跳转必须按 studentId 隔离	当前上课学员选择	进入学习中心前选择学员	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	多学员未选择、当前学员权益过期、学员未激活或同步失败时不得混写学习记录	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-005	账号注销需提供申请、风险确认、验证码校验、撤销申请、申请状态和审计留痕，不得直接物理删除学习记录	学员学习首页	打开学习中心	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	端类型不支持、网络异常或账号状态异常时可重试	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-006	学习首页展示当前学员、今日课程、学习任务、直播提醒、积分、成长等级和最近学习，支持切换学员、继续学习和进入积分商城	课程资源详情	访问课程资源	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	课程权益不足、资源过期或播放地址失效时展示原因	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-007	课程资源、资源播放、直播回放和补看任务均需按课程权益、有效期、发布范围、资源状态和回放状态鉴权	学习任务详情	完成学习任务	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	任务已过期或进度同步失败时进入补偿队列	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-008	直播课堂支持签到、互动答题、举手连麦、排队状态、教师邀请、连接中、上麦中、被教师静音、全班发言、结束连麦、断流重试和观看记录同步	作业编辑自动保存	保存草稿	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	自动保存失败、附件上传失败或多端版本冲突时保留本地草稿	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-009	作业列表必须显式支持草稿筛选，作业提交页支持自动保存、手动保存、附件上传、继续编辑、删除草稿、草稿过期、多端冲突恢复和正式提交	作业草稿箱	继续编辑或删除草稿	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	草稿过期、作业已关闭、服务端版本冲突或删除恢复失败时展示原因和恢复策略	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-010	测评考试支持在线作答、倒计时、必答校验、自动交卷、交卷确认、报告生成、错题解析和学习建议	测评考试作答	提交测评	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	考试超时、必答题缺失或重复提交时阻断并提示	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-011	错题本支持按错题来源、知识点、掌握状态、错误次数筛选，一键挑出 5 题复练、生成错题重组测试、标记掌握和移出错题本	错题本复练	一键复练或生成错题重组测试	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	无错题、重组测试生成失败、练习提交失败或标记掌握冲突时给出重试和回退	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-012	学习档案通过进度、报告、作品、证书 Tab 展示课程进度、课时完成、作业完成、测评趋势、直播观看、能力雷达和教师评价	学习档案	查看成长档案	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	数据同步延迟或档案无权限时展示空状态与客服入口	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-013	作品集支持图片大图、录音播放、视频播放、教师点评、转码中、加载失败、资源过期、无权限和分享给家长等轻量画板	作品预览播放	查看学习作品	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	作品转码中、作品加载失败、资源已过期或无权限时展示轻量弹窗异常态	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-014	积分商城支持积分中心、礼品详情、兑换记录与订单详情；立即兑换需先锁库，按钮 loading 防重复点击，锁库成功后确认兑换	积分商城	兑换礼品	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	积分不足、库存不足或核销码失效时回滚积分	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-015	核销码支持二维码/条形码展示、点击放大、自动调高屏幕亮度、刷新核销码、过期提示、取消兑换、积分退回和实物售后状态	积分锁库确认	点击立即兑换	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	锁库失败、重复点击、库存被占用或礼品下架时不得扣减积分	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-016	消息中心覆盖课程、作业、直播、积分和系统通知，业务对象失效时需展示原因和返回路径	积分兑换核销	线下核销	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	核销码重复使用、礼品库存异常或校区无权限时阻断	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-017	隐私与授权页只承接学员端微信、手机号、设备、摄像头/麦克风、消息推送和协议状态；人脸授权采集/撤回由家长端主责，学员端只展示状态或跳转说明	学员直播课堂	进入直播	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	直播未开播、无权益、断流或回放生成中时提示状态	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-018	Tauri 桌面端复用 H5/Web 学习中心能力，但需独立展示桌面导航、宽屏播放器、互动侧栏、设备状态、同步状态和版本提示	作业草稿箱	恢复草稿	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	草稿过期、作业已关闭或服务端版本冲突时提供恢复策略	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-019	桌面播放/直播支持双击全屏、方向键调节音量、Esc 退出全屏；学习进度同步失败先每 30 秒静默重试，连续失败 3 次以上再强提示	学员直播举手上麦	举手上麦	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	连麦人数已满、邀请超时、麦克风未授权或供应商连接失败时提示修复	主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-APP-020	学员桌面端不展示开播、屏幕共享、系统音频采集、本地录制等教师直播创作入口，越权接口需拒绝并审计	Tauri 桌面学习中心	桌面播放和同步	校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权	生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务	学习进度同步失败先 30 秒静默重试，连续失败 3 次以上再强提示；桌面端不得出现教师直播创作入口	主流程、异常流、权限流、接口失败和数据一致性均可通过测试

07 · 关联闭环补充需求

学员端学习中心在跨模块闭环中的责任边界

本章节承接最终闭环核对清单，明确本模块需要补齐的页面、接口对象、异常兜底和验收口径。

闭环项	本模块责任	关键场景	页面/功能补充	关联对象/接口	验收口径
回放人工补传	接收回放重新发布、补看提醒和访问异常提示	学员错过直播、回放缺失后补传重新开放	回放列表、补看提醒、回放异常页、学习进度回写	ReplayPublishPolicy/ReplayAccess、StudentAccount/LearningProfile	补传回放可按原课程权益访问，补看记录进入学习进度
礼品实物售后	提供积分兑换取消、核销码查看、线下领取异常和售后进度	礼品缺货、核销码过期、线下领取失败或积分退回	积分商城、兑换订单、核销码、售后申请、处理结果	PointsAccount/PointsOrder、PointsRedemptionAfterSales	积分、库存和兑换状态在学员端可见且与后台一致

08 · 页面与原型设计说明

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

原型图设计需要覆盖列表、详情、表单、弹窗、空状态、异常状态和权限状态。

终端	页面	用户	页面目标	布局结构	关键按钮	关键字段	异常状态	原型备注
学员端小程序/App/H5	01 启动页	学员	自动检查登录态、网络状态、版本号、已绑定学员数量和上次选择学员，按状态跳转登录页、当前上课学员选择或学习首页	学员端账号页采用移动端轻量表单和状态引导：启动页先检查登录态、版本、网络和学员绑定；登录页提供学校发放账号登录与非学员手机号注册/登录两条路径；多学员选择使用底部抽屉。	检查登录态、学员用户名密码登录、手机号注册、手机号密码登录、手机号验证码登录、找回密码、选择当前上课学员、提交注销	学员用户名、学员密码、手机号、短信验证码、登录密码、协议勾选、绑定学员列表、当前学员、账号状态、注销确认	学员账号未激活、密码错误、验证码错误、协议未勾选、手机号已注册、多学员未选择、无绑定学员、账号注销申请中	学员用户名密码登录用于学校发放账号；非学员手机号注册后支持手机号密码/验证码登录；所有学习记录、作业、积分和直播签到必须按当前 studentId 隔离。建议 Figma Frame：APP-01_启动页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	02 登录页	学员/非学员	支持学员用户名密码登录、手机号密码登录、手机号验证码登录、协议勾选、学员信息同步和多学员选择入口	学员端账号页采用移动端轻量表单和状态引导：启动页先检查登录态、版本、网络和学员绑定；登录页提供学校发放账号登录与非学员手机号注册/登录两条路径；多学员选择使用底部抽屉。	检查登录态、学员用户名密码登录、手机号注册、手机号密码登录、手机号验证码登录、找回密码、选择当前上课学员、提交注销	学员用户名、学员密码、手机号、短信验证码、登录密码、协议勾选、绑定学员列表、当前学员、账号状态、注销确认	学员账号未激活、密码错误、验证码错误、协议未勾选、手机号已注册、多学员未选择、无绑定学员、账号注销申请中	学员用户名密码登录用于学校发放账号；非学员手机号注册后支持手机号密码/验证码登录；所有学习记录、作业、积分和直播签到必须按当前 studentId 隔离。建议 Figma Frame：APP-02_登录页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	03 非学员注册登录页	非学员/潜在学员	手机号自主注册、设置登录密码、选择机构校区、创建学员信息，注册后可使用手机号密码或验证码登录	学员端账号页采用移动端轻量表单和状态引导：启动页先检查登录态、版本、网络和学员绑定；登录页提供学校发放账号登录与非学员手机号注册/登录两条路径；多学员选择使用底部抽屉。	检查登录态、学员用户名密码登录、手机号注册、手机号密码登录、手机号验证码登录、找回密码、选择当前上课学员、提交注销	学员用户名、学员密码、手机号、短信验证码、登录密码、协议勾选、绑定学员列表、当前学员、账号状态、注销确认	学员账号未激活、密码错误、验证码错误、协议未勾选、手机号已注册、多学员未选择、无绑定学员、账号注销申请中	学员用户名密码登录用于学校发放账号；非学员手机号注册后支持手机号密码/验证码登录；所有学习记录、作业、积分和直播签到必须按当前 studentId 隔离。建议 Figma Frame：APP-03_非学员注册登录页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	04 找回密码页	学员/非学员	通过手机号验证码重置登录密码，校验验证码、密码规则、重置结果和返回登录路径	学员端账号页采用移动端轻量表单和状态引导：启动页先检查登录态、版本、网络和学员绑定；登录页提供学校发放账号登录与非学员手机号注册/登录两条路径；多学员选择使用底部抽屉。	检查登录态、学员用户名密码登录、手机号注册、手机号密码登录、手机号验证码登录、找回密码、选择当前上课学员、提交注销	学员用户名、学员密码、手机号、短信验证码、登录密码、协议勾选、绑定学员列表、当前学员、账号状态、注销确认	学员账号未激活、密码错误、验证码错误、协议未勾选、手机号已注册、多学员未选择、无绑定学员、账号注销申请中	学员用户名密码登录用于学校发放账号；非学员手机号注册后支持手机号密码/验证码登录；所有学习记录、作业、积分和直播签到必须按当前 studentId 隔离。建议 Figma Frame：APP-04_找回密码页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	05 账号注销申请页	学员	展示注销影响、账号信息、验证码、风险确认、提交注销、撤销申请和注销状态	学员端账号页采用移动端轻量表单和状态引导：启动页先检查登录态、版本、网络和学员绑定；登录页提供学校发放账号登录与非学员手机号注册/登录两条路径；多学员选择使用底部抽屉。	检查登录态、学员用户名密码登录、手机号注册、手机号密码登录、手机号验证码登录、找回密码、选择当前上课学员、提交注销	学员用户名、学员密码、手机号、短信验证码、登录密码、协议勾选、绑定学员列表、当前学员、账号状态、注销确认	学员账号未激活、密码错误、验证码错误、协议未勾选、手机号已注册、多学员未选择、无绑定学员、账号注销申请中	学员用户名密码登录用于学校发放账号；非学员手机号注册后支持手机号密码/验证码登录；所有学习记录、作业、积分和直播签到必须按当前 studentId 隔离。建议 Figma Frame：APP-05_账号注销申请页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	06 学习首页	学员	展示当前学员、今日课程、学习任务、直播提醒、积分、成长等级、最近学习，支持切换学员、继续学习和进入积分商城	学习页以任务流为核心：移动端采用学习首页、课程卡片、资源目录和底部主操作；平板和桌面端采用左侧目录、中部播放器、右侧任务/报告区域。	继续学习、进入课程、播放资源、补看回放、记录进度、刷新权益、查看报告、切换学员	当前学员、课程名称、权益状态、有效期、学习进度、资源类型、播放地址、回放有效期、补看截止时间、同步状态	课程权益不足、合同到期、资源过期、播放鉴权失效、回放生成中、学习进度同步失败、资源加载失败	合同缴费、发票和人脸授权采集不作为学员端主流程；学员端仅展示必要状态、原因和跳转/联系入口。建议 Figma Frame：APP-06_学习首页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	07 我的课程页	学员	展示课程封面、课程名称、有效期、进度、剩余课时、权益状态，支持筛选课程、进入学习和查看权益	学习页以任务流为核心：移动端采用学习首页、课程卡片、资源目录和底部主操作；平板和桌面端采用左侧目录、中部播放器、右侧任务/报告区域。	继续学习、进入课程、播放资源、补看回放、记录进度、刷新权益、查看报告、切换学员	当前学员、课程名称、权益状态、有效期、学习进度、资源类型、播放地址、回放有效期、补看截止时间、同步状态	课程权益不足、合同到期、资源过期、播放鉴权失效、回放生成中、学习进度同步失败、资源加载失败	合同缴费、发票和人脸授权采集不作为学员端主流程；学员端仅展示必要状态、原因和跳转/联系入口。建议 Figma Frame：APP-07_我的课程页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	08 课程详情页	学员	展示课程介绍、课时目录、学习资源、作业任务、测评入口和学习报告入口，支持播放资源、提交作业、参加测评	学习页以任务流为核心：移动端采用学习首页、课程卡片、资源目录和底部主操作；平板和桌面端采用左侧目录、中部播放器、右侧任务/报告区域。	继续学习、进入课程、播放资源、补看回放、记录进度、刷新权益、查看报告、切换学员	当前学员、课程名称、权益状态、有效期、学习进度、资源类型、播放地址、回放有效期、补看截止时间、同步状态	课程权益不足、合同到期、资源过期、播放鉴权失效、回放生成中、学习进度同步失败、资源加载失败	合同缴费、发票和人脸授权采集不作为学员端主流程；学员端仅展示必要状态、原因和跳转/联系入口。建议 Figma Frame：APP-08_课程详情页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	09 资源/回放播放页	学员	支持视频、音频、文档、回放视频、目录、倍速、学习进度、有效期、关联作业和播放失败兜底	学习页以任务流为核心：移动端采用学习首页、课程卡片、资源目录和底部主操作；平板和桌面端采用左侧目录、中部播放器、右侧任务/报告区域。	继续学习、进入课程、播放资源、补看回放、记录进度、刷新权益、查看报告、切换学员	当前学员、课程名称、权益状态、有效期、学习进度、资源类型、播放地址、回放有效期、补看截止时间、同步状态	课程权益不足、合同到期、资源过期、播放鉴权失效、回放生成中、学习进度同步失败、资源加载失败	合同缴费、发票和人脸授权采集不作为学员端主流程；学员端仅展示必要状态、原因和跳转/联系入口。建议 Figma Frame：APP-09_资源_回放播放页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	10 直播课表/预告页	学员	展示直播标题、开课时间、教师、班级、预约状态和提醒状态，支持预约、取消预约、加入提醒和进入直播详情	直播页以播放器为主，移动端叠加互动抽屉，桌面端使用主舞台 + 右侧聊天/答题/连麦侧栏；连麦状态条需要常驻展示当前排队、邀请、上麦和静音状态。	预约直播、进入直播、直播签到、提交答题、申请连麦、取消排队、接受连麦、拒绝连麦	直播标题、开课时间、教师、观看权益、签到状态、互动题、举手状态、排队位次、邀请倒计时、麦克风状态	直播未开始、无观看权益、断流、连麦人数已满、邀请超时、麦克风未授权、教师已静音、供应商连接失败	学员端仅提交举手和连麦响应，教师端负责队列处理、邀请、静音、下麦和座席释放。建议 Figma Frame：APP-10_直播课表_预告页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	11 直播课堂页	学员	直播画面、聊天、答题、签到、举手连麦、排队位次、连麦邀请、麦克风状态、老师静音状态和观看时长完整闭环	直播页以播放器为主，移动端叠加互动抽屉，桌面端使用主舞台 + 右侧聊天/答题/连麦侧栏；连麦状态条需要常驻展示当前排队、邀请、上麦和静音状态。	预约直播、进入直播、直播签到、提交答题、申请连麦、取消排队、接受连麦、拒绝连麦	直播标题、开课时间、教师、观看权益、签到状态、互动题、举手状态、排队位次、邀请倒计时、麦克风状态	直播未开始、无观看权益、断流、连麦人数已满、邀请超时、麦克风未授权、教师已静音、供应商连接失败	学员端仅提交举手和连麦响应，教师端负责队列处理、邀请、静音、下麦和座席释放。建议 Figma Frame：APP-11_直播课堂页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	12 作业列表页	学员	按全部、待提交、草稿未提交、已提交、已批改、需订正、已完成、已过期等状态筛选作业，支持继续编辑草稿	作业页采用列表筛选 + 详情作答 + 结果订正三段结构；草稿作为显性筛选和独立状态，作答页顶部展示自动保存时间、截止倒计时和冲突提示。	筛选草稿、继续编辑草稿、保存草稿、上传附件、提交作业、删除草稿、恢复冲突、订正错题	作业标题、截止时间、提交状态、草稿状态、最近保存时间、autoSaveVersion、附件、教师评语、订正次数、补交状态	自动保存失败、附件上传失败、多端版本冲突、作业已截止、草稿已过期、重复提交、批改驳回	草稿 10 秒内自动保存；提交成功后草稿关闭；逻辑删除草稿需要写审计并保留恢复策略。建议 Figma Frame：APP-12_作业列表页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	13 作业提交页	学员	支持文本、图片、音频、视频附件作答，自动保存、手动保存草稿、上传附件、正式提交和撤回修改	作业页采用列表筛选 + 详情作答 + 结果订正三段结构；草稿作为显性筛选和独立状态，作答页顶部展示自动保存时间、截止倒计时和冲突提示。	筛选草稿、继续编辑草稿、保存草稿、上传附件、提交作业、删除草稿、恢复冲突、订正错题	作业标题、截止时间、提交状态、草稿状态、最近保存时间、autoSaveVersion、附件、教师评语、订正次数、补交状态	自动保存失败、附件上传失败、多端版本冲突、作业已截止、草稿已过期、重复提交、批改驳回	草稿 10 秒内自动保存；提交成功后草稿关闭；逻辑删除草稿需要写审计并保留恢复策略。建议 Figma Frame：APP-13_作业提交页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	14 作业结果与订正页	学员	查看得分、教师评语、错题、优秀示例、订正次数和重做入口，支持订正错题和分享给家长	作业页采用列表筛选 + 详情作答 + 结果订正三段结构；草稿作为显性筛选和独立状态，作答页顶部展示自动保存时间、截止倒计时和冲突提示。	筛选草稿、继续编辑草稿、保存草稿、上传附件、提交作业、删除草稿、恢复冲突、订正错题	作业标题、截止时间、提交状态、草稿状态、最近保存时间、autoSaveVersion、附件、教师评语、订正次数、补交状态	自动保存失败、附件上传失败、多端版本冲突、作业已截止、草稿已过期、重复提交、批改驳回	草稿 10 秒内自动保存；提交成功后草稿关闭；逻辑删除草稿需要写审计并保留恢复策略。建议 Figma Frame：APP-14_作业结果与订正页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	15 测评考试页	学员	支持题目、选项、倒计时、答题进度、标记状态、交卷确认、考试超时和网络异常处理	测评页采用题目卡片、答题进度、倒计时和交卷确认；错题本采用筛选列表、复练队列和结果反馈，突出一键 5 题复练和错题重组测试。	开始测评、保存答案、交卷、查看解析、加入错题本、一键挑 5 题复练、生成错题重组测试、标记掌握	题目、答案、倒计时、能力维度、错题来源、知识点、错误次数、掌握状态、复练题量、复练结果	考试超时、必答题缺失、重复交卷、报告生成失败、无错题、重组测试生成失败、练习失败	错题本目标是复练和消灭错题，而不是只做错题查看。建议 Figma Frame：APP-15_测评考试页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	16 测评报告页	学员	展示总分、能力维度、错题解析、学习建议和学习计划入口，支持加入错题本和查看档案	测评页采用题目卡片、答题进度、倒计时和交卷确认；错题本采用筛选列表、复练队列和结果反馈，突出一键 5 题复练和错题重组测试。	开始测评、保存答案、交卷、查看解析、加入错题本、一键挑 5 题复练、生成错题重组测试、标记掌握	题目、答案、倒计时、能力维度、错题来源、知识点、错误次数、掌握状态、复练题量、复练结果	考试超时、必答题缺失、重复交卷、报告生成失败、无错题、重组测试生成失败、练习失败	错题本目标是复练和消灭错题，而不是只做错题查看。建议 Figma Frame：APP-16_测评报告页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	17 学习档案页	学员	通过进度、报告、作品、证书 Tab 展示课程进度、课时完成、作业完成、测评趋势、直播观看、能力雷达、教师评价和作品集	学习档案页使用进度、报告、作品、证书 Tab；作品预览以轻量弹窗展示图片大图、录音播放器、视频播放器、教师点评和分享动作。	筛选课程、查看趋势、预览作品、播放录音、播放视频、下载证书、分享作品、查看教师点评	课程进度、作业完成、测评趋势、直播观看、能力雷达、教师评价、作品类型、作品文件、荣誉证书、课程名称	暂无档案、暂无作品、报告生成中、作品转码中、作品加载失败、资源已过期、无权限	作品预览不新增主导航页面，作为学习档案内弹窗/轻量画板呈现。建议 Figma Frame：APP-17_学习档案页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	18 错题本页	学员	按错题来源、知识点、掌握状态、错误次数筛选错题，支持一键挑 5 题复练、错题重组测试、标记掌握和移出错题本	测评页采用题目卡片、答题进度、倒计时和交卷确认；错题本采用筛选列表、复练队列和结果反馈，突出一键 5 题复练和错题重组测试。	开始测评、保存答案、交卷、查看解析、加入错题本、一键挑 5 题复练、生成错题重组测试、标记掌握	题目、答案、倒计时、能力维度、错题来源、知识点、错误次数、掌握状态、复练题量、复练结果	考试超时、必答题缺失、重复交卷、报告生成失败、无错题、重组测试生成失败、练习失败	错题本目标是复练和消灭错题，而不是只做错题查看。建议 Figma Frame：APP-18_错题本页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	19 积分中心页	学员	展示当前积分、积分任务、可兑换礼品、积分流水和积分来源，支持查看规则、进入兑换、做任务和查看明细	积分商城采用积分中心、礼品详情、兑换记录三层结构；兑换确认使用弹窗完成锁库、积分扣减确认和结果反馈，核销码展示需支持放大和临时提升屏幕亮度。	查看积分流水、立即兑换、锁定库存、确认兑换、取消兑换、查看核销码、放大核销码、刷新核销码	积分余额、积分任务、礼品 SKU、可用库存、所需积分、领取校区、兑换订单、核销码、有效期、售后状态	积分不足、库存不足、锁库失败、重复点击拦截、礼品下架、核销码过期、重复核销、库存释放失败	兑换先锁库，锁库成功后再确认兑换；核销成功后联动物料礼品出库。建议 Figma Frame：APP-19_积分中心页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	20 礼品详情页	学员	展示礼品图片、库存、所需积分、领取校区、兑换说明和有效期，立即兑换先锁库并用 loading 防重复点击	积分商城采用积分中心、礼品详情、兑换记录三层结构；兑换确认使用弹窗完成锁库、积分扣减确认和结果反馈，核销码展示需支持放大和临时提升屏幕亮度。	查看积分流水、立即兑换、锁定库存、确认兑换、取消兑换、查看核销码、放大核销码、刷新核销码	积分余额、积分任务、礼品 SKU、可用库存、所需积分、领取校区、兑换订单、核销码、有效期、售后状态	积分不足、库存不足、锁库失败、重复点击拦截、礼品下架、核销码过期、重复核销、库存释放失败	兑换先锁库，锁库成功后再确认兑换；核销成功后联动物料礼品出库。建议 Figma Frame：APP-20_礼品详情页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	21 兑换记录与订单详情页	学员	展示订单号、礼品、二维码/条形码核销码、领取状态、有效期、取消原因、退回积分和处理时间	积分商城采用积分中心、礼品详情、兑换记录三层结构；兑换确认使用弹窗完成锁库、积分扣减确认和结果反馈，核销码展示需支持放大和临时提升屏幕亮度。	查看积分流水、立即兑换、锁定库存、确认兑换、取消兑换、查看核销码、放大核销码、刷新核销码	积分余额、积分任务、礼品 SKU、可用库存、所需积分、领取校区、兑换订单、核销码、有效期、售后状态	积分不足、库存不足、锁库失败、重复点击拦截、礼品下架、核销码过期、重复核销、库存释放失败	兑换先锁库，锁库成功后再确认兑换；核销成功后联动物料礼品出库。建议 Figma Frame：APP-21_兑换记录与订单详情页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	22 消息中心页	学员	聚合课程提醒、作业提醒、直播提醒、积分提醒和系统通知，支持筛选、已读、删除和跳转业务页面	消息与个人中心采用移动端列表和设置分组；平板/桌面可左右分栏。隐私页只承接学员端设备、推送、微信、手机号、摄像头/麦克风等授权状态，人脸授权仅展示家长端处理状态和跳转说明。	筛选消息、标记已读、删除消息、切换学员、管理设备、编辑资料、退出登录、查看协议	消息类型、业务跳转、头像、昵称、当前学员、绑定学员、设备列表、微信授权、推送授权、隐私协议	无消息、跳转对象失效、设备超限、资料保存失败、学员同步失败、授权失败、敏感操作留痕	人脸授权采集和撤回仍由家长端主责，学员端不承接家长授权操作。建议 Figma Frame：APP-22_消息中心页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	23 个人中心页	学员	展示头像、昵称、账号、安全设置、当前学员、绑定学员列表、设备管理和学习账号状态，支持切换学员和管理设备	消息与个人中心采用移动端列表和设置分组；平板/桌面可左右分栏。隐私页只承接学员端设备、推送、微信、手机号、摄像头/麦克风等授权状态，人脸授权仅展示家长端处理状态和跳转说明。	筛选消息、标记已读、删除消息、切换学员、管理设备、编辑资料、退出登录、查看协议	消息类型、业务跳转、头像、昵称、当前学员、绑定学员、设备列表、微信授权、推送授权、隐私协议	无消息、跳转对象失效、设备超限、资料保存失败、学员同步失败、授权失败、敏感操作留痕	人脸授权采集和撤回仍由家长端主责，学员端不承接家长授权操作。建议 Figma Frame：APP-23_个人中心页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	24 隐私与授权页	学员	展示微信授权、手机号、摄像头/麦克风、消息推送、用户协议、隐私政策；人脸授权仅展示家长端处理状态或跳转说明	消息与个人中心采用移动端列表和设置分组；平板/桌面可左右分栏。隐私页只承接学员端设备、推送、微信、手机号、摄像头/麦克风等授权状态，人脸授权仅展示家长端处理状态和跳转说明。	筛选消息、标记已读、删除消息、切换学员、管理设备、编辑资料、退出登录、查看协议	消息类型、业务跳转、头像、昵称、当前学员、绑定学员、设备列表、微信授权、推送授权、隐私协议	无消息、跳转对象失效、设备超限、资料保存失败、学员同步失败、授权失败、敏感操作留痕	人脸授权采集和撤回仍由家长端主责，学员端不承接家长授权操作。建议 Figma Frame：APP-24_隐私与授权页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
macOS/Windows Tauri	25 桌面端学习中心首页	学员	Tauri 桌面端展示桌面导航、今日课程、学习任务、直播提醒、最近学习、设备状态、同步状态和重试计数	Tauri 桌面端复用 H5/Web 学习中心能力，宽屏下采用左侧导航、中部播放器/学习内容、右侧任务和互动面板；顶部展示设备、同步和版本状态。	打开课程、观看直播、补看回放、同步进度、静默重试、双击全屏、方向键调节音量、Esc 退出全屏	桌面导航、设备状态、同步状态、重试计数、播放器、课程目录、互动答题、全屏状态、音量状态、版本号	设备超限、登录失效、同步失败、连续失败 3 次强提示、资源无权限、播放失败、直播中断、桌面端版本过低	学员桌面端不展示开播、屏幕共享、系统音频采集、本地录制等教师直播创作入口。建议 Figma Frame：APP-25_桌面端学习中心首页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
macOS/Windows Tauri	26 桌面端播放/直播适配页	学员	宽屏播放器、课程目录、直播聊天、互动答题、课件侧栏、学习进度、快捷键提示和全屏状态适配	Tauri 桌面端复用 H5/Web 学习中心能力，宽屏下采用左侧导航、中部播放器/学习内容、右侧任务和互动面板；顶部展示设备、同步和版本状态。	打开课程、观看直播、补看回放、同步进度、静默重试、双击全屏、方向键调节音量、Esc 退出全屏	桌面导航、设备状态、同步状态、重试计数、播放器、课程目录、互动答题、全屏状态、音量状态、版本号	设备超限、登录失效、同步失败、连续失败 3 次强提示、资源无权限、播放失败、直播中断、桌面端版本过低	学员桌面端不展示开播、屏幕共享、系统音频采集、本地录制等教师直播创作入口。建议 Figma Frame：APP-26_桌面端播放_直播适配页；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	S01 账号未激活/绑定审核中状态	学员/非学员	覆盖未激活、审核中、绑定失败、重复绑定、可重试和转人工	移动端采用顶部标题/状态区、内容卡片流和底部主按钮；平板端需要分栏布局和横屏适配。	查看、提交、保存、取消、确认、联系客服、启动检查、学员用户名密码登录	课程名称、学习进度、作业状态、草稿时间、积分余额、兑换订单、直播状态、回放有效期	网络异常、权限不足、提交失败、状态已变化	需分别标注小程序、App、H5、平板和桌面壳的适配差异。建议 Figma Frame：APP-s01_账号未激活_绑定审核中状态；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	S02 权益不足/资源过期/合同到期状态	学员	覆盖无权限、资源过期、合同到期、课时耗尽、权益撤销和联系家长/校区入口	合同页采用左侧学员与课程信息，中部报价/协议/退款主流程，右侧展示优惠分摊、审批流、签署和监管回执。	优惠试算、生成报价、发起审批、生成合同、发起签署、收款、监管备案、作废重签	学员、课程组合、原合同、优惠规则、应收/应退、补差退差、签署状态、监管状态、课程名称、学习进度	优惠冲突、班级容量不足、补差未支付、签署失败、监管备案失败、权益重算失败	需覆盖多科联报、组合缴费、优惠互斥、补充协议、转班转课权益测算、退款冲销和监管回执。建议 Figma Frame：APP-s02_权益不足_资源过期_合同到期状态；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5/桌面端	S03 直播互动答题/举手连麦弹窗/侧栏	学员	覆盖直播签到、互动答题、举手连麦申请、排队、教师邀请、连接中、连麦中控制、被静音和超时未答	直播页以播放器为主，移动端叠加互动抽屉，桌面端使用主舞台 + 右侧聊天/答题/连麦侧栏；连麦状态条需要常驻展示当前排队、邀请、上麦和静音状态。	预约直播、进入直播、直播签到、提交答题、申请连麦、取消排队、接受连麦、拒绝连麦	直播标题、开课时间、教师、观看权益、签到状态、互动题、举手状态、排队位次、邀请倒计时、麦克风状态	直播未开始、无观看权益、断流、连麦人数已满、邀请超时、麦克风未授权、教师已静音、供应商连接失败	学员端仅提交举手和连麦响应，教师端负责队列处理、邀请、静音、下麦和座席释放。建议 Figma Frame：APP-s03_直播互动答题_举手连麦弹窗_侧栏；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	S04 学习完成/获得积分弹窗	学员	覆盖任务完成、课程进度更新、获得积分、下一步推荐、继续学习、查看积分和去兑换	移动端采用顶部标题/状态区、内容卡片流和底部主按钮；平板端需要分栏布局和横屏适配。	查看、提交、保存、取消、确认、联系客服、启动检查、学员用户名密码登录	课程名称、学习进度、作业状态、草稿时间、积分余额、兑换订单、直播状态、回放有效期	网络异常、权限不足、提交失败、状态已变化	需分别标注小程序、App、H5、平板和桌面壳的适配差异。建议 Figma Frame：APP-s04_学习完成_获得积分弹窗；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	S05 兑换确认/兑换结果/核销码展示弹窗	学员	覆盖锁库中、锁库成功待确认、兑换成功、积分不足、库存不足、锁库失败、核销码放大和亮度增强	积分商城采用积分中心、礼品详情、兑换记录三层结构；兑换确认使用弹窗完成锁库、积分扣减确认和结果反馈，核销码展示需支持放大和临时提升屏幕亮度。	查看积分流水、立即兑换、锁定库存、确认兑换、取消兑换、查看核销码、放大核销码、刷新核销码	积分余额、积分任务、礼品 SKU、可用库存、所需积分、领取校区、兑换订单、核销码、有效期、售后状态	积分不足、库存不足、锁库失败、重复点击拦截、礼品下架、核销码过期、重复核销、库存释放失败	兑换先锁库，锁库成功后再确认兑换；核销成功后联动物料礼品出库。建议 Figma Frame：APP-s05_兑换确认_兑换结果_核销码展示弹窗；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
macOS/Windows Tauri	S06 桌面端同步失败/接口失败/无权限状态	学员	覆盖学习进度同步失败、30 秒静默重试、连续失败 1-2 次弱提示、连续失败 3 次以上强提示、接口异常和资源无权限	Tauri 桌面端复用 H5/Web 学习中心能力，宽屏下采用左侧导航、中部播放器/学习内容、右侧任务和互动面板；顶部展示设备、同步和版本状态。	打开课程、观看直播、补看回放、同步进度、静默重试、双击全屏、方向键调节音量、Esc 退出全屏	桌面导航、设备状态、同步状态、重试计数、播放器、课程目录、互动答题、全屏状态、音量状态、版本号	设备超限、登录失效、同步失败、连续失败 3 次强提示、资源无权限、播放失败、直播中断、桌面端版本过低	学员桌面端不展示开播、屏幕共享、系统音频采集、本地录制等教师直播创作入口。建议 Figma Frame：APP-s06_桌面端同步失败_接口失败_无权限状态；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	S07 作品预览/播放弹窗	学员	覆盖手抄报大图预览、口语录音播放、打卡视频播放、教师点评、作品转码中、加载失败和资源过期	学习档案页使用进度、报告、作品、证书 Tab；作品预览以轻量弹窗展示图片大图、录音播放器、视频播放器、教师点评和分享动作。	筛选课程、查看趋势、预览作品、播放录音、播放视频、下载证书、分享作品、查看教师点评	课程进度、作业完成、测评趋势、直播观看、能力雷达、教师评价、作品类型、作品文件、荣誉证书、课程名称	暂无档案、暂无作品、报告生成中、作品转码中、作品加载失败、资源已过期、无权限	作品预览不新增主导航页面，作为学习档案内弹窗/轻量画板呈现。建议 Figma Frame：APP-s07_作品预览_播放弹窗；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5	S08 当前上课学员选择弹窗	学员	覆盖同一手机号绑定多个学员、记住上次选择、当前学员权益过期、学员未激活、无绑定学员和重新同步	学员端账号页采用移动端轻量表单和状态引导：启动页先检查登录态、版本、网络和学员绑定；登录页提供学校发放账号登录与非学员手机号注册/登录两条路径；多学员选择使用底部抽屉。	检查登录态、学员用户名密码登录、手机号注册、手机号密码登录、手机号验证码登录、找回密码、选择当前上课学员、提交注销	学员用户名、学员密码、手机号、短信验证码、登录密码、协议勾选、绑定学员列表、当前学员、账号状态、注销确认	学员账号未激活、密码错误、验证码错误、协议未勾选、手机号已注册、多学员未选择、无绑定学员、账号注销申请中	学员用户名密码登录用于学校发放账号；非学员手机号注册后支持手机号密码/验证码登录；所有学习记录、作业、积分和直播签到必须按当前 studentId 隔离。建议 Figma Frame：APP-s08_当前上课学员选择弹窗；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5/桌面端	作业详情	学员	围绕草稿闭环完善作业详情的入口、字段、状态、异常提示、处理进度和验收反馈	作业页采用列表筛选 + 详情作答 + 结果订正三段结构；草稿作为显性筛选和独立状态，作答页顶部展示自动保存时间、截止倒计时和冲突提示。	筛选草稿、继续编辑草稿、保存草稿、上传附件、提交作业、删除草稿、恢复冲突、订正错题	作业标题、截止时间、提交状态、草稿状态、最近保存时间、autoSaveVersion、附件、教师评语、订正次数、补交状态	自动保存失败、附件上传失败、多端版本冲突、作业已截止、草稿已过期、重复提交、批改驳回	草稿 10 秒内自动保存；提交成功后草稿关闭；逻辑删除草稿需要写审计并保留恢复策略。建议 Figma Frame：APP-作业详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5/桌面端	草稿箱	学员	围绕草稿闭环完善草稿箱的入口、字段、状态、异常提示、处理进度和验收反馈	作业页采用列表筛选 + 详情作答 + 结果订正三段结构；草稿作为显性筛选和独立状态，作答页顶部展示自动保存时间、截止倒计时和冲突提示。	筛选草稿、继续编辑草稿、保存草稿、上传附件、提交作业、删除草稿、恢复冲突、订正错题	作业标题、截止时间、提交状态、草稿状态、最近保存时间、autoSaveVersion、附件、教师评语、订正次数、补交状态	自动保存失败、附件上传失败、多端版本冲突、作业已截止、草稿已过期、重复提交、批改驳回	草稿 10 秒内自动保存；提交成功后草稿关闭；逻辑删除草稿需要写审计并保留恢复策略。建议 Figma Frame：APP-草稿箱；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5/桌面端	草稿恢复弹窗	学员	围绕草稿闭环完善草稿恢复弹窗的入口、字段、状态、异常提示、处理进度和验收反馈	作业页采用列表筛选 + 详情作答 + 结果订正三段结构；草稿作为显性筛选和独立状态，作答页顶部展示自动保存时间、截止倒计时和冲突提示。	筛选草稿、继续编辑草稿、保存草稿、上传附件、提交作业、删除草稿、恢复冲突、订正错题	作业标题、截止时间、提交状态、草稿状态、最近保存时间、autoSaveVersion、附件、教师评语、订正次数、补交状态	自动保存失败、附件上传失败、多端版本冲突、作业已截止、草稿已过期、重复提交、批改驳回	草稿 10 秒内自动保存；提交成功后草稿关闭；逻辑删除草稿需要写审计并保留恢复策略。建议 Figma Frame：APP-草稿恢复弹窗；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5/桌面端	直播间	学员	围绕直播闭环完善直播间的入口、字段、状态、异常提示、处理进度和验收反馈	移动端采用顶部标题/状态区、内容卡片流和底部主按钮；平板端需要分栏布局和横屏适配。	查看、提交、保存、取消、确认、联系客服、启动检查、学员用户名密码登录	课程名称、学习进度、作业状态、草稿时间、积分余额、兑换订单、直播状态、回放有效期	网络异常、权限不足、提交失败、状态已变化	需分别标注小程序、App、H5、平板和桌面壳的适配差异。建议 Figma Frame：APP-直播间；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5/桌面端	回放列表	学员	围绕直播闭环完善回放列表的入口、字段、状态、异常提示、处理进度和验收反馈	移动端采用顶部标题/状态区、内容卡片流和底部主按钮；平板端需要分栏布局和横屏适配。	查看、提交、保存、取消、确认、联系客服、启动检查、学员用户名密码登录	课程名称、学习进度、作业状态、草稿时间、积分余额、兑换订单、直播状态、回放有效期	网络异常、权限不足、提交失败、状态已变化	需分别标注小程序、App、H5、平板和桌面壳的适配差异。建议 Figma Frame：APP-回放列表；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5/桌面端	积分商城	学员	围绕积分商城完善积分商城的入口、字段、状态、异常提示、处理进度和验收反馈	积分商城采用积分中心、礼品详情、兑换记录三层结构；兑换确认使用弹窗完成锁库、积分扣减确认和结果反馈，核销码展示需支持放大和临时提升屏幕亮度。	查看积分流水、立即兑换、锁定库存、确认兑换、取消兑换、查看核销码、放大核销码、刷新核销码	积分余额、积分任务、礼品 SKU、可用库存、所需积分、领取校区、兑换订单、核销码、有效期、售后状态	积分不足、库存不足、锁库失败、重复点击拦截、礼品下架、核销码过期、重复核销、库存释放失败	兑换先锁库，锁库成功后再确认兑换；核销成功后联动物料礼品出库。建议 Figma Frame：APP-积分商城；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5/桌面端	兑换详情	学员	围绕积分商城完善兑换详情的入口、字段、状态、异常提示、处理进度和验收反馈	积分商城采用积分中心、礼品详情、兑换记录三层结构；兑换确认使用弹窗完成锁库、积分扣减确认和结果反馈，核销码展示需支持放大和临时提升屏幕亮度。	查看积分流水、立即兑换、锁定库存、确认兑换、取消兑换、查看核销码、放大核销码、刷新核销码	积分余额、积分任务、礼品 SKU、可用库存、所需积分、领取校区、兑换订单、核销码、有效期、售后状态	积分不足、库存不足、锁库失败、重复点击拦截、礼品下架、核销码过期、重复核销、库存释放失败	兑换先锁库，锁库成功后再确认兑换；核销成功后联动物料礼品出库。建议 Figma Frame：APP-兑换详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5/桌面端	核销码	学员	围绕积分商城完善核销码的入口、字段、状态、异常提示、处理进度和验收反馈	积分商城采用积分中心、礼品详情、兑换记录三层结构；兑换确认使用弹窗完成锁库、积分扣减确认和结果反馈，核销码展示需支持放大和临时提升屏幕亮度。	查看积分流水、立即兑换、锁定库存、确认兑换、取消兑换、查看核销码、放大核销码、刷新核销码	积分余额、积分任务、礼品 SKU、可用库存、所需积分、领取校区、兑换订单、核销码、有效期、售后状态	积分不足、库存不足、锁库失败、重复点击拦截、礼品下架、核销码过期、重复核销、库存释放失败	兑换先锁库，锁库成功后再确认兑换；核销成功后联动物料礼品出库。建议 Figma Frame：APP-核销码；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App/H5/桌面端	售后进度	学员	围绕积分商城完善售后进度的入口、字段、状态、异常提示、处理进度和验收反馈	积分商城采用积分中心、礼品详情、兑换记录三层结构；兑换确认使用弹窗完成锁库、积分扣减确认和结果反馈，核销码展示需支持放大和临时提升屏幕亮度。	查看积分流水、立即兑换、锁定库存、确认兑换、取消兑换、查看核销码、放大核销码、刷新核销码	积分余额、积分任务、礼品 SKU、可用库存、所需积分、领取校区、兑换订单、核销码、有效期、售后状态	积分不足、库存不足、锁库失败、重复点击拦截、礼品下架、核销码过期、重复核销、库存释放失败	兑换先锁库，锁库成功后再确认兑换；核销成功后联动物料礼品出库。建议 Figma Frame：APP-售后进度；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。

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

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

设计原型时，每个关键页面必须能解释前端展示什么、后端提交什么、状态怎么变、异常怎么处理。

原型页面	关键接口	关联对象	状态流	审批/权限触发	消息/待办触达	原型验收要求
01 启动页	GET /api/v1/student/resources	StudentAccount	启动检查 -> 未登录 -> 学员账号待激活 -> 手机号注册中 -> 登录中 -> 登录成功 -> 登录失败 -> 账号锁定 -> 注销申请中	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
02 登录页	GET /api/v1/student/portfolio/items	StudentAccountRegistration	有权益 -> 权益不足 -> 合同到期 -> 课时耗尽 -> 资源过期 -> 资源下架 -> 播放鉴权失败	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
03 非学员注册登录页	GET /api/v1/student/resources	StudentSessionSelection	无作品 -> 可预览 -> 转码中 -> 播放中 -> 加载失败 -> 资源过期 -> 无权限	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
04 找回密码页	GET /api/v1/student/portfolio/items	StudentDeviceSession	正常 -> 静默重试中 -> 弱提示 -> 强提示 -> 同步成功 -> 同步失败 -> 资源无权限 -> 版本过低	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
05 账号注销申请页	GET /api/v1/student/resources	LearningProfile	启动检查 -> 未登录 -> 学员账号待激活 -> 手机号注册中 -> 登录中 -> 登录成功 -> 登录失败 -> 账号锁定 -> 注销申请中	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
06 学习首页	GET /api/v1/student/portfolio/items	LearningTask	有权益 -> 权益不足 -> 合同到期 -> 课时耗尽 -> 资源过期 -> 资源下架 -> 播放鉴权失败	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
07 我的课程页	GET /api/v1/student/resources	HomeworkDraft	无作品 -> 可预览 -> 转码中 -> 播放中 -> 加载失败 -> 资源过期 -> 无权限	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
08 课程详情页	GET /api/v1/student/portfolio/items	HomeworkSubmit	正常 -> 静默重试中 -> 弱提示 -> 强提示 -> 同步成功 -> 同步失败 -> 资源无权限 -> 版本过低	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
09 资源/回放播放页	GET /api/v1/student/resources	WrongQuestionPractice	启动检查 -> 未登录 -> 学员账号待激活 -> 手机号注册中 -> 登录中 -> 登录成功 -> 登录失败 -> 账号锁定 -> 注销申请中	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
10 直播课表/预告页	GET /api/v1/student/portfolio/items	StudentPortfolioItem	有权益 -> 权益不足 -> 合同到期 -> 课时耗尽 -> 资源过期 -> 资源下架 -> 播放鉴权失败	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
11 直播课堂页	GET /api/v1/student/resources	PointsAccount	无作品 -> 可预览 -> 转码中 -> 播放中 -> 加载失败 -> 资源过期 -> 无权限	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
12 作业列表页	GET /api/v1/student/portfolio/items	PointsLock	正常 -> 静默重试中 -> 弱提示 -> 强提示 -> 同步成功 -> 同步失败 -> 资源无权限 -> 版本过低	活码外部资源审批：活码跳转外部链接或公开资源	课程权益与资源提醒 -> 学员	原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口

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

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

本章节为正式 PRD 的交付要求，面向原型图、UI、开发、联调和测试分工。

能力域	功能补充要求	原型交付要求	UI 交互要求	研发实现要求	测试验收要求
草稿闭环	补齐草稿箱、自动保存、手动保存、多端冲突、删除恢复、提交后关闭草稿。	作业详情、草稿箱、草稿恢复弹窗需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。	UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。	后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。	测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；草稿不丢失，提交后草稿状态与作业状态一致。
直播闭环	补齐排队序号、邀请倒计时、设备检测、拒绝/超时/失败提示和回放补看提醒。	直播间、连麦状态、回放列表需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。	UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。	后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。	测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；学员每个直播状态都有明确提示和下一步动作。
积分商城	补齐兑换订单、核销码、取消、过期、售后、积分退回和库存释放。	积分商城、兑换详情、核销码、售后进度需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。	UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。	后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。	测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；积分流水、库存流水和兑换状态一致。

11 · 数据对象与字段字典

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

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

核心对象

对象	说明
StudentAccount	学员端独立账号；落地表：stu_account
StudentAccountRegistration	非学员手机号自主注册记录；落地表：stu_account_registration
StudentSessionSelection	当前上课学员选择记录；落地表：stu_session_selection
StudentDeviceSession	学员端设备登录会话；落地表：stu_device_session
LearningProfile	学员学习进度档案；落地表：stu_learning_profile
LearningTask	学员学习任务；落地表：stu_learning_task
HomeworkDraft	学员作业草稿箱；落地表：edu_homework_draft
HomeworkSubmit	学员作业提交；落地表：edu_homework_submit
WrongQuestionPractice	错题复练与重组测试；落地表：stu_wrong_question_practice
StudentPortfolioItem	学习档案作品集；落地表：stu_portfolio_item
PointsAccount	学员积分账户；落地表：pts_account
PointsLock	积分兑换锁库记录；落地表：pts_lock
PointsOrder	积分商城兑换订单；落地表：pts_order
PointsWriteOffCode	积分兑换线下核销码；落地表：pts_write_off_code
PointsRedemptionAfterSales	积分兑换售后；落地表：pts_after_sales
DesktopSyncTask	学员桌面端学习同步任务；落地表：stu_desktop_sync_task

关联引用对象

对象	说明
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
Student	学员基础档案；引用来源：CRM / stu_student
Course/Product	课程产品；引用来源：EDU / edu_course
Homework	作业任务；引用来源：EDU / edu_homework
HomeworkReview	作业批改与点评；引用来源：EDU / edu_homework_review
LiveRoom	直播间；引用来源：LIVE / live_room
LiveSession/LiveAttendance	直播观看、签到和时长；引用来源：LIVE / live_participant
LiveMicRequest	举手上麦请求；引用来源：LIVE / live_mic_request
LiveMicSeat	连麦座席管理；引用来源：LIVE / live_mic_seat
LiveRecording	直播录制和回放文件；引用来源：LIVE / live_recording_file
LearningResource	教研学习资源；引用来源：RES / res_learning_resource
Material/Inventory/Asset/Book	物料、固定资产、图书、礼品 SKU；引用来源：MAT / mat_sku

完整字段字典

对象	字段	类型	必填	规则	数据级别
StudentAccount	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
StudentAccount	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
StudentAccount	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
StudentAccount	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
StudentAccount	created_by	BIGINT	是	创建人账号 ID	普通
StudentAccount	created_at	DATETIME	是	创建时间	普通
StudentAccount	updated_by	BIGINT	否	最后更新人账号 ID	普通
StudentAccount	updated_at	DATETIME	否	最后更新时间	普通
StudentAccount	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
StudentAccount	deleted_at	DATETIME	否	删除时间，未删除为空	普通
StudentAccount	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
StudentAccount	version	INT	是	乐观锁版本号，写操作必须校验	普通
StudentAccount	account_no	VARCHAR(64)	是	学员账号编号，唯一	普通
StudentAccount	login_name	VARCHAR(64)	是	学校下发的学员用户名或手机号登录名	普通
StudentAccount	student_id	BIGINT	否	默认绑定学员 ID，多学员账号可为空	普通
StudentAccount	account_type	VARCHAR(32)	是	学校下发/手机号自主注册/家长代开通	普通
StudentAccount	mobile	VARCHAR(32)	否	手机号，敏感	敏感
StudentAccount	wechat_openid	VARCHAR(128)	否	微信 OpenID，敏感	敏感
StudentAccount	password_hash	VARCHAR(255)	否	密码哈希，禁止明文存储	敏感
StudentAccount	login_status	VARCHAR(32)	是	待激活/正常/锁定/停用	普通
StudentAccount	activated_at	DATETIME	否	账号激活时间	普通
StudentAccount	cancel_request_status	VARCHAR(32)	否	注销申请状态：无/申请中/已通过/已驳回	普通
StudentAccount	last_login_at	DATETIME	否	最近登录时间	普通
StudentAccountRegistration	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
StudentAccountRegistration	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
StudentAccountRegistration	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
StudentAccountRegistration	campus_id	BIGINT	否	意向校区	普通
StudentAccountRegistration	created_by	BIGINT	是	创建人账号 ID	普通
StudentAccountRegistration	created_at	DATETIME	是	创建时间	普通
StudentAccountRegistration	updated_by	BIGINT	否	最后更新人账号 ID	普通
StudentAccountRegistration	updated_at	DATETIME	否	最后更新时间	普通
StudentAccountRegistration	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
StudentAccountRegistration	deleted_at	DATETIME	否	删除时间，未删除为空	普通
StudentAccountRegistration	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
StudentAccountRegistration	version	INT	是	乐观锁版本号，写操作必须校验	普通
StudentAccountRegistration	register_no	VARCHAR(64)	是	注册单编号，唯一	普通
StudentAccountRegistration	mobile	VARCHAR(32)	是	注册手机号，敏感	敏感
StudentAccountRegistration	sms_verify_id	VARCHAR(64)	是	短信验证码校验流水，不存储明文验证码	普通
StudentAccountRegistration	student_name	VARCHAR(64)	否	注册时填写的学员姓名，敏感	敏感
StudentAccountRegistration	password_set_status	VARCHAR(32)	是	未设置/已设置/需重置	普通
StudentAccountRegistration	agreement_version	VARCHAR(32)	是	已勾选协议版本	普通
StudentAccountRegistration	register_status	VARCHAR(32)	是	待提交/审核中/已开通/已驳回/已取消	普通
StudentAccountRegistration	linked_account_id	BIGINT	否	开通后的学员账号 ID	普通
StudentSessionSelection	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
StudentSessionSelection	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
StudentSessionSelection	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
StudentSessionSelection	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
StudentSessionSelection	created_by	BIGINT	是	创建人账号 ID	普通
StudentSessionSelection	created_at	DATETIME	是	创建时间	普通
StudentSessionSelection	updated_by	BIGINT	否	最后更新人账号 ID	普通
StudentSessionSelection	updated_at	DATETIME	否	最后更新时间	普通
StudentSessionSelection	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
StudentSessionSelection	deleted_at	DATETIME	否	删除时间，未删除为空	普通
StudentSessionSelection	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
StudentSessionSelection	version	INT	是	乐观锁版本号，写操作必须校验	普通
StudentSessionSelection	account_id	BIGINT	是	学员端账号 ID	普通
StudentSessionSelection	selected_student_id	BIGINT	是	当前上课学员 ID	普通
StudentSessionSelection	source_channel	VARCHAR(32)	是	小程序/App/H5/Tauri	普通
StudentSessionSelection	remember_last	TINYINT	是	是否记住本次选择	普通
StudentSessionSelection	selected_at	DATETIME	是	选择时间	普通
StudentSessionSelection	selection_status	VARCHAR(32)	是	有效/权益过期/已切换/同步失败	普通
StudentSessionSelection	last_sync_result	VARCHAR(512)	否	最近一次端侧同步结果	普通
StudentDeviceSession	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
StudentDeviceSession	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
StudentDeviceSession	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
StudentDeviceSession	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
StudentDeviceSession	created_by	BIGINT	是	创建人账号 ID	普通
StudentDeviceSession	created_at	DATETIME	是	创建时间	普通
StudentDeviceSession	updated_by	BIGINT	否	最后更新人账号 ID	普通
StudentDeviceSession	updated_at	DATETIME	否	最后更新时间	普通
StudentDeviceSession	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
StudentDeviceSession	deleted_at	DATETIME	否	删除时间，未删除为空	普通
StudentDeviceSession	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
StudentDeviceSession	version	INT	是	乐观锁版本号，写操作必须校验	普通
StudentDeviceSession	account_id	BIGINT	是	学员端账号 ID	普通
StudentDeviceSession	student_id	BIGINT	否	当前选择学员 ID	普通
StudentDeviceSession	device_id	VARCHAR(128)	是	端侧设备 ID	普通
StudentDeviceSession	client_type	VARCHAR(32)	是	微信小程序/iOS/iPadOS/Android/安卓平板/H5/Tauri-macOS/Tauri-Windows	普通
StudentDeviceSession	app_version	VARCHAR(32)	否	客户端版本号	普通
StudentDeviceSession	login_at	DATETIME	是	登录时间	普通
StudentDeviceSession	last_active_at	DATETIME	否	最近活跃时间	普通
StudentDeviceSession	session_status	VARCHAR(32)	是	有效/过期/踢下线/设备超限	普通
LearningProfile	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
LearningProfile	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
LearningProfile	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
LearningProfile	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
LearningProfile	created_by	BIGINT	是	创建人账号 ID	普通
LearningProfile	created_at	DATETIME	是	创建时间	普通
LearningProfile	updated_by	BIGINT	否	最后更新人账号 ID	普通
LearningProfile	updated_at	DATETIME	否	最后更新时间	普通
LearningProfile	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
LearningProfile	deleted_at	DATETIME	否	删除时间，未删除为空	普通
LearningProfile	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
LearningProfile	version	INT	是	乐观锁版本号，写操作必须校验	普通
LearningProfile	student_id	BIGINT	是	学员 ID	普通
LearningProfile	course_id	BIGINT	是	课程 ID	普通
LearningProfile	progress_percent	DECIMAL(6,2)	是	学习进度百分比	普通
LearningProfile	ability_tags	JSON	否	能力标签	普通
LearningProfile	last_active_at	DATETIME	否	最近学习时间	普通
LearningProfile	profile_snapshot	JSON	否	学习画像快照	普通
LearningTask	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
LearningTask	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
LearningTask	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
LearningTask	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
LearningTask	created_by	BIGINT	是	创建人账号 ID	普通
LearningTask	created_at	DATETIME	是	创建时间	普通
LearningTask	updated_by	BIGINT	否	最后更新人账号 ID	普通
LearningTask	updated_at	DATETIME	否	最后更新时间	普通
LearningTask	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
LearningTask	deleted_at	DATETIME	否	删除时间，未删除为空	普通
LearningTask	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
LearningTask	version	INT	是	乐观锁版本号，写操作必须校验	普通
LearningTask	task_no	VARCHAR(64)	是	任务编号，唯一	普通
LearningTask	student_id	BIGINT	是	学员 ID	普通
LearningTask	task_type	VARCHAR(32)	是	课程/作业/测评/直播/回放	普通
LearningTask	biz_id	BIGINT	是	业务 ID	普通
LearningTask	deadline_at	DATETIME	否	截止时间	普通
LearningTask	complete_status	VARCHAR(32)	是	未开始/进行中/已完成/逾期	普通
HomeworkDraft	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
HomeworkDraft	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
HomeworkDraft	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
HomeworkDraft	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
HomeworkDraft	created_by	BIGINT	是	创建人账号 ID	普通
HomeworkDraft	created_at	DATETIME	是	创建时间	普通
HomeworkDraft	updated_by	BIGINT	否	最后更新人账号 ID	普通
HomeworkDraft	updated_at	DATETIME	否	最后更新时间	普通
HomeworkDraft	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
HomeworkDraft	deleted_at	DATETIME	否	删除时间，未删除为空	普通
HomeworkDraft	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
HomeworkDraft	version	INT	是	乐观锁版本号，写操作必须校验	普通
HomeworkDraft	draft_no	VARCHAR(64)	是	草稿编号，唯一	普通
HomeworkDraft	homework_id	BIGINT	是	作业 ID	普通
HomeworkDraft	student_id	BIGINT	是	学员 ID	普通
HomeworkDraft	draft_status	VARCHAR(32)	是	草稿中/已提交/已删除/已过期/冲突待处理	普通
HomeworkDraft	answer_snapshot	JSON	是	答案草稿	普通
HomeworkDraft	attachment_temp_ids	JSON	否	临时附件	普通
HomeworkDraft	auto_save_version	INT	是	自动保存版本	普通
HomeworkDraft	last_saved_at	DATETIME	是	最近保存时间	普通
HomeworkDraft	expire_at	DATETIME	否	草稿过期时间	普通
HomeworkDraft	client_type	VARCHAR(32)	否	最近保存端	普通
HomeworkDraft	delete_reason	VARCHAR(255)	否	删除或过期原因	普通
HomeworkDraft	conflict_status	VARCHAR(32)	是	无冲突/有冲突/已合并	普通
HomeworkSubmit	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
HomeworkSubmit	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
HomeworkSubmit	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
HomeworkSubmit	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
HomeworkSubmit	created_by	BIGINT	是	创建人账号 ID	普通
HomeworkSubmit	created_at	DATETIME	是	创建时间	普通
HomeworkSubmit	updated_by	BIGINT	否	最后更新人账号 ID	普通
HomeworkSubmit	updated_at	DATETIME	否	最后更新时间	普通
HomeworkSubmit	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
HomeworkSubmit	deleted_at	DATETIME	否	删除时间，未删除为空	普通
HomeworkSubmit	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
HomeworkSubmit	version	INT	是	乐观锁版本号，写操作必须校验	普通
HomeworkSubmit	submit_no	VARCHAR(64)	是	提交编号，唯一	普通
HomeworkSubmit	homework_id	BIGINT	是	作业 ID	普通
HomeworkSubmit	student_id	BIGINT	是	学员 ID	普通
HomeworkSubmit	answer_payload	JSON	是	最终答案	普通
HomeworkSubmit	submit_status	VARCHAR(32)	是	待提交/已提交/已批改/需订正	普通
HomeworkSubmit	submitted_at	DATETIME	否	提交时间	普通
WrongQuestionPractice	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
WrongQuestionPractice	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
WrongQuestionPractice	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
WrongQuestionPractice	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
WrongQuestionPractice	created_by	BIGINT	是	创建人账号 ID	普通
WrongQuestionPractice	created_at	DATETIME	是	创建时间	普通
WrongQuestionPractice	updated_by	BIGINT	否	最后更新人账号 ID	普通
WrongQuestionPractice	updated_at	DATETIME	否	最后更新时间	普通
WrongQuestionPractice	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
WrongQuestionPractice	deleted_at	DATETIME	否	删除时间，未删除为空	普通
WrongQuestionPractice	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
WrongQuestionPractice	version	INT	是	乐观锁版本号，写操作必须校验	普通
WrongQuestionPractice	practice_no	VARCHAR(64)	是	复练任务编号，唯一	普通
WrongQuestionPractice	student_id	BIGINT	是	学员 ID	普通
WrongQuestionPractice	course_id	BIGINT	否	课程 ID	普通
WrongQuestionPractice	source_question_ids	JSON	是	来源错题 ID 列表	普通
WrongQuestionPractice	practice_mode	VARCHAR(32)	是	一键 5 题复练/错题重组测试/知识点专项	普通
WrongQuestionPractice	question_count	INT	是	题目数量	普通
WrongQuestionPractice	practice_status	VARCHAR(32)	是	待练习/进行中/已完成/生成失败	普通
WrongQuestionPractice	result_snapshot	JSON	否	练习结果快照	普通
StudentPortfolioItem	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
StudentPortfolioItem	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
StudentPortfolioItem	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
StudentPortfolioItem	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
StudentPortfolioItem	created_by	BIGINT	是	创建人账号 ID	普通
StudentPortfolioItem	created_at	DATETIME	是	创建时间	普通
StudentPortfolioItem	updated_by	BIGINT	否	最后更新人账号 ID	普通
StudentPortfolioItem	updated_at	DATETIME	否	最后更新时间	普通
StudentPortfolioItem	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
StudentPortfolioItem	deleted_at	DATETIME	否	删除时间，未删除为空	普通
StudentPortfolioItem	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
StudentPortfolioItem	version	INT	是	乐观锁版本号，写操作必须校验	普通
StudentPortfolioItem	student_id	BIGINT	是	学员 ID	普通
StudentPortfolioItem	course_id	BIGINT	否	课程 ID	普通
StudentPortfolioItem	item_type	VARCHAR(32)	是	图片/音频/视频/作业/测评报告/课堂作品	普通
StudentPortfolioItem	title	VARCHAR(128)	是	作品标题	普通
StudentPortfolioItem	file_id	BIGINT	否	文件中心文件 ID	普通
StudentPortfolioItem	media_type	VARCHAR(32)	否	图片/音频/视频/PDF/链接	普通
StudentPortfolioItem	transcode_status	VARCHAR(32)	否	无需转码/转码中/成功/失败	普通
StudentPortfolioItem	teacher_comment_id	BIGINT	否	关联教师点评 ID	普通
StudentPortfolioItem	share_status	VARCHAR(32)	是	不可分享/可分享/已分享/分享失效	普通
PointsAccount	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
PointsAccount	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
PointsAccount	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
PointsAccount	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
PointsAccount	created_by	BIGINT	是	创建人账号 ID	普通
PointsAccount	created_at	DATETIME	是	创建时间	普通
PointsAccount	updated_by	BIGINT	否	最后更新人账号 ID	普通
PointsAccount	updated_at	DATETIME	否	最后更新时间	普通
PointsAccount	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
PointsAccount	deleted_at	DATETIME	否	删除时间，未删除为空	普通
PointsAccount	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
PointsAccount	version	INT	是	乐观锁版本号，写操作必须校验	普通
PointsAccount	student_id	BIGINT	是	学员 ID	普通
PointsAccount	available_points	INT	是	可用积分	普通
PointsAccount	frozen_points	INT	是	冻结积分	普通
PointsAccount	total_earned_points	INT	是	累计获得积分	普通
PointsAccount	total_used_points	INT	是	累计消耗积分	普通
PointsLock	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
PointsLock	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
PointsLock	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
PointsLock	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
PointsLock	created_by	BIGINT	是	创建人账号 ID	普通
PointsLock	created_at	DATETIME	是	创建时间	普通
PointsLock	updated_by	BIGINT	否	最后更新人账号 ID	普通
PointsLock	updated_at	DATETIME	否	最后更新时间	普通
PointsLock	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
PointsLock	deleted_at	DATETIME	否	删除时间，未删除为空	普通
PointsLock	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
PointsLock	version	INT	是	乐观锁版本号，写操作必须校验	普通
PointsLock	lock_no	VARCHAR(64)	是	锁库编号，唯一	普通
PointsLock	student_id	BIGINT	是	学员 ID	普通
PointsLock	gift_sku_id	BIGINT	是	礼品 SKU ID，关联物料库存	普通
PointsLock	quantity	INT	是	锁定数量	普通
PointsLock	points_amount	INT	是	锁定积分	普通
PointsLock	lock_status	VARCHAR(32)	是	锁定中/已确认/已释放/已过期	普通
PointsLock	expire_at	DATETIME	是	锁库过期时间	普通
PointsOrder	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
PointsOrder	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
PointsOrder	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
PointsOrder	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
PointsOrder	created_by	BIGINT	是	创建人账号 ID	普通
PointsOrder	created_at	DATETIME	是	创建时间	普通
PointsOrder	updated_by	BIGINT	否	最后更新人账号 ID	普通
PointsOrder	updated_at	DATETIME	否	最后更新时间	普通
PointsOrder	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
PointsOrder	deleted_at	DATETIME	否	删除时间，未删除为空	普通
PointsOrder	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
PointsOrder	version	INT	是	乐观锁版本号，写操作必须校验	普通
PointsOrder	order_no	VARCHAR(64)	是	积分订单编号，唯一	普通
PointsOrder	student_id	BIGINT	是	学员 ID	普通
PointsOrder	gift_sku_id	BIGINT	是	礼品 SKU ID，关联物料	普通
PointsOrder	lock_id	BIGINT	否	积分锁库记录 ID	普通
PointsOrder	points_amount	INT	是	消耗积分	普通
PointsOrder	write_off_code_id	BIGINT	否	核销码 ID	普通
PointsOrder	order_status	VARCHAR(32)	是	待领取/已核销/已取消/售后中	普通
PointsWriteOffCode	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
PointsWriteOffCode	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
PointsWriteOffCode	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
PointsWriteOffCode	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
PointsWriteOffCode	created_by	BIGINT	是	创建人账号 ID	普通
PointsWriteOffCode	created_at	DATETIME	是	创建时间	普通
PointsWriteOffCode	updated_by	BIGINT	否	最后更新人账号 ID	普通
PointsWriteOffCode	updated_at	DATETIME	否	最后更新时间	普通
PointsWriteOffCode	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
PointsWriteOffCode	deleted_at	DATETIME	否	删除时间，未删除为空	普通
PointsWriteOffCode	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
PointsWriteOffCode	version	INT	是	乐观锁版本号，写操作必须校验	普通
PointsWriteOffCode	points_order_id	BIGINT	是	积分兑换订单 ID	普通
PointsWriteOffCode	write_off_code	VARCHAR(64)	是	核销码，唯一	普通
PointsWriteOffCode	code_type	VARCHAR(32)	是	二维码/条形码/数字码	普通
PointsWriteOffCode	expire_at	DATETIME	是	核销码有效期	普通
PointsWriteOffCode	refresh_count	INT	是	刷新次数	普通
PointsWriteOffCode	write_off_status	VARCHAR(32)	是	待核销/已核销/已过期/已作废	普通
PointsWriteOffCode	brightness_hint	TINYINT	是	端侧是否建议自动调高亮度	普通
PointsRedemptionAfterSales	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
PointsRedemptionAfterSales	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
PointsRedemptionAfterSales	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
PointsRedemptionAfterSales	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
PointsRedemptionAfterSales	created_by	BIGINT	是	创建人账号 ID	普通
PointsRedemptionAfterSales	created_at	DATETIME	是	创建时间	普通
PointsRedemptionAfterSales	updated_by	BIGINT	否	最后更新人账号 ID	普通
PointsRedemptionAfterSales	updated_at	DATETIME	否	最后更新时间	普通
PointsRedemptionAfterSales	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
PointsRedemptionAfterSales	deleted_at	DATETIME	否	删除时间，未删除为空	普通
PointsRedemptionAfterSales	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
PointsRedemptionAfterSales	version	INT	是	乐观锁版本号，写操作必须校验	普通
PointsRedemptionAfterSales	after_sales_no	VARCHAR(64)	是	售后编号，唯一	普通
PointsRedemptionAfterSales	points_order_id	BIGINT	是	积分订单 ID	普通
PointsRedemptionAfterSales	request_type	VARCHAR(32)	是	取消/退积分/补发/异常核销	普通
PointsRedemptionAfterSales	request_reason	VARCHAR(512)	是	申请原因	普通
PointsRedemptionAfterSales	handle_result	VARCHAR(512)	否	处理结果	普通
PointsRedemptionAfterSales	handle_status	VARCHAR(32)	是	待处理/已处理/已驳回	普通
DesktopSyncTask	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
DesktopSyncTask	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
DesktopSyncTask	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
DesktopSyncTask	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
DesktopSyncTask	created_by	BIGINT	是	创建人账号 ID	普通
DesktopSyncTask	created_at	DATETIME	是	创建时间	普通
DesktopSyncTask	updated_by	BIGINT	否	最后更新人账号 ID	普通
DesktopSyncTask	updated_at	DATETIME	否	最后更新时间	普通
DesktopSyncTask	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
DesktopSyncTask	deleted_at	DATETIME	否	删除时间，未删除为空	普通
DesktopSyncTask	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
DesktopSyncTask	version	INT	是	乐观锁版本号，写操作必须校验	普通
DesktopSyncTask	sync_batch_no	VARCHAR(64)	是	同步批次号，唯一	普通
DesktopSyncTask	student_id	BIGINT	是	学员 ID	普通
DesktopSyncTask	device_id	VARCHAR(128)	是	Tauri 桌面端设备 ID	普通
DesktopSyncTask	sync_payload	JSON	是	学习进度、播放位置、作业草稿等同步内容	普通
DesktopSyncTask	retry_count	INT	是	已重试次数	普通
DesktopSyncTask	next_retry_at	DATETIME	否	下次静默重试时间	普通
DesktopSyncTask	strong_prompt	TINYINT	是	是否已触发强提示	普通
DesktopSyncTask	sync_status	VARCHAR(32)	是	待同步/同步中/成功/失败/冲突	普通
DesktopSyncTask	failed_reason	VARCHAR(512)	否	失败原因	普通

引用对象字段字典

引用表	对象	字段	类型	必填	规则	数据级别
sys_organization	Organization	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
sys_organization	Organization	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
sys_organization	Organization	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
sys_organization	Organization	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
sys_organization	Organization	created_by	BIGINT	是	创建人账号 ID	普通
sys_organization	Organization	created_at	DATETIME	是	创建时间	普通
sys_organization	Organization	updated_by	BIGINT	否	最后更新人账号 ID	普通
sys_organization	Organization	updated_at	DATETIME	否	最后更新时间	普通
sys_organization	Organization	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
sys_organization	Organization	deleted_at	DATETIME	否	删除时间，未删除为空	普通
sys_organization	Organization	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
sys_organization	Organization	version	INT	是	乐观锁版本号，写操作必须校验	普通
sys_organization	Organization	org_code	VARCHAR(64)	是	组织编码，租户内唯一	普通
sys_organization	Organization	org_name	VARCHAR(128)	是	组织名称	普通
sys_organization	Organization	org_type	VARCHAR(32)	是	集团/区域/校区/部门/法人主体	普通
sys_organization	Organization	parent_id	BIGINT	否	上级组织 ID，根节点为空	普通
sys_organization	Organization	sort_no	INT	否	同级排序	普通
sys_organization	Organization	enabled	TINYINT	是	是否启用	普通
sys_user	User/Employee	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
sys_user	User/Employee	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
sys_user	User/Employee	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
sys_user	User/Employee	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
sys_user	User/Employee	created_by	BIGINT	是	创建人账号 ID	普通
sys_user	User/Employee	created_at	DATETIME	是	创建时间	普通
sys_user	User/Employee	updated_by	BIGINT	否	最后更新人账号 ID	普通
sys_user	User/Employee	updated_at	DATETIME	否	最后更新时间	普通
sys_user	User/Employee	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
sys_user	User/Employee	deleted_at	DATETIME	否	删除时间，未删除为空	普通
sys_user	User/Employee	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
sys_user	User/Employee	version	INT	是	乐观锁版本号，写操作必须校验	普通
sys_user	User/Employee	user_no	VARCHAR(64)	是	账号编号，唯一	普通
sys_user	User/Employee	login_name	VARCHAR(64)	是	登录名，唯一	普通
sys_user	User/Employee	mobile	VARCHAR(32)	否	手机号，敏感脱敏展示	敏感
sys_user	User/Employee	password_hash	VARCHAR(255)	否	密码哈希，禁止前端返回	高敏
sys_user	User/Employee	user_type	VARCHAR(32)	是	员工/学员/家长/外部账号	普通
sys_user	User/Employee	login_status	VARCHAR(32)	是	正常/锁定/停用/待激活	普通
sys_employee	Employee	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
sys_employee	Employee	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
sys_employee	Employee	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
sys_employee	Employee	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
sys_employee	Employee	created_by	BIGINT	是	创建人账号 ID	普通
sys_employee	Employee	created_at	DATETIME	是	创建时间	普通
sys_employee	Employee	updated_by	BIGINT	否	最后更新人账号 ID	普通
sys_employee	Employee	updated_at	DATETIME	否	最后更新时间	普通
sys_employee	Employee	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
sys_employee	Employee	deleted_at	DATETIME	否	删除时间，未删除为空	普通
sys_employee	Employee	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
sys_employee	Employee	version	INT	是	乐观锁版本号，写操作必须校验	普通
sys_employee	Employee	employee_no	VARCHAR(64)	是	工号，唯一	普通
sys_employee	Employee	user_id	BIGINT	否	关联账号 ID	普通
sys_employee	Employee	employee_name	VARCHAR(64)	是	员工姓名	普通
sys_employee	Employee	primary_campus_id	BIGINT	否	主校区 ID	普通
sys_employee	Employee	job_title	VARCHAR(64)	否	岗位名称	普通
sys_employee	Employee	hire_status	VARCHAR(32)	是	在职/试用/离职/停用	普通
sys_role	Role	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
sys_role	Role	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
sys_role	Role	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
sys_role	Role	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
sys_role	Role	created_by	BIGINT	是	创建人账号 ID	普通
sys_role	Role	created_at	DATETIME	是	创建时间	普通
sys_role	Role	updated_by	BIGINT	否	最后更新人账号 ID	普通
sys_role	Role	updated_at	DATETIME	否	最后更新时间	普通
sys_role	Role	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
sys_role	Role	deleted_at	DATETIME	否	删除时间，未删除为空	普通
sys_role	Role	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
sys_role	Role	version	INT	是	乐观锁版本号，写操作必须校验	普通
sys_role	Role	role_code	VARCHAR(64)	是	角色编码，唯一	普通
sys_role	Role	role_name	VARCHAR(128)	是	角色名称	普通
sys_role	Role	role_level	VARCHAR(32)	是	总部/区域/校区/个人	普通
sys_role	Role	data_scope_type	VARCHAR(32)	是	数据范围类型	普通
sys_role	Role	enabled	TINYINT	是	是否启用	普通
sys_approval_flow	ApprovalFlow	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
sys_approval_flow	ApprovalFlow	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
sys_approval_flow	ApprovalFlow	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
sys_approval_flow	ApprovalFlow	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
sys_approval_flow	ApprovalFlow	created_by	BIGINT	是	创建人账号 ID	普通
sys_approval_flow	ApprovalFlow	created_at	DATETIME	是	创建时间	普通
sys_approval_flow	ApprovalFlow	updated_by	BIGINT	否	最后更新人账号 ID	普通
sys_approval_flow	ApprovalFlow	updated_at	DATETIME	否	最后更新时间	普通
sys_approval_flow	ApprovalFlow	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
sys_approval_flow	ApprovalFlow	deleted_at	DATETIME	否	删除时间，未删除为空	普通
sys_approval_flow	ApprovalFlow	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
sys_approval_flow	ApprovalFlow	version	INT	是	乐观锁版本号，写操作必须校验	普通
sys_approval_flow	ApprovalFlow	flow_code	VARCHAR(64)	是	审批流编码，唯一	普通
sys_approval_flow	ApprovalFlow	biz_type	VARCHAR(64)	是	业务类型	普通
sys_approval_flow	ApprovalFlow	flow_name	VARCHAR(128)	是	审批流名称	普通
sys_approval_flow	ApprovalFlow	condition_json	JSON	否	触发条件	普通
sys_approval_flow	ApprovalFlow	node_json	JSON	是	节点、审批人和超时规则	普通
sys_approval_flow	ApprovalFlow	version_no	INT	是	审批流版本号	普通
sys_approval_flow	ApprovalFlow	enabled	TINYINT	是	是否启用	普通
sys_message_template	MessageTemplate	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
sys_message_template	MessageTemplate	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
sys_message_template	MessageTemplate	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
sys_message_template	MessageTemplate	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
sys_message_template	MessageTemplate	created_by	BIGINT	是	创建人账号 ID	普通
sys_message_template	MessageTemplate	created_at	DATETIME	是	创建时间	普通
sys_message_template	MessageTemplate	updated_by	BIGINT	否	最后更新人账号 ID	普通
sys_message_template	MessageTemplate	updated_at	DATETIME	否	最后更新时间	普通
sys_message_template	MessageTemplate	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
sys_message_template	MessageTemplate	deleted_at	DATETIME	否	删除时间，未删除为空	普通
sys_message_template	MessageTemplate	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
sys_message_template	MessageTemplate	version	INT	是	乐观锁版本号，写操作必须校验	普通
sys_message_template	MessageTemplate	template_code	VARCHAR(64)	是	模板编码，唯一	普通
sys_message_template	MessageTemplate	template_name	VARCHAR(128)	是	模板名称	普通
sys_message_template	MessageTemplate	channel	VARCHAR(32)	是	站内信/短信/微信小程序/企微/Push	普通
sys_message_template	MessageTemplate	receiver_rule	JSON	是	接收人规则	普通
sys_message_template	MessageTemplate	content_template	TEXT	是	模板内容	普通
sys_message_template	MessageTemplate	enabled	TINYINT	是	是否启用	普通
sys_audit_log	AuditLog	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
sys_audit_log	AuditLog	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
sys_audit_log	AuditLog	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
sys_audit_log	AuditLog	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
sys_audit_log	AuditLog	created_by	BIGINT	是	创建人账号 ID	普通
sys_audit_log	AuditLog	created_at	DATETIME	是	创建时间	普通
sys_audit_log	AuditLog	updated_by	BIGINT	否	最后更新人账号 ID	普通
sys_audit_log	AuditLog	updated_at	DATETIME	否	最后更新时间	普通
sys_audit_log	AuditLog	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
sys_audit_log	AuditLog	deleted_at	DATETIME	否	删除时间，未删除为空	普通
sys_audit_log	AuditLog	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
sys_audit_log	AuditLog	version	INT	是	乐观锁版本号，写操作必须校验	普通
sys_audit_log	AuditLog	operator_id	BIGINT	是	操作人 ID	普通
sys_audit_log	AuditLog	biz_type	VARCHAR(64)	是	业务类型	普通
sys_audit_log	AuditLog	biz_id	BIGINT	否	业务主键 ID	普通
sys_audit_log	AuditLog	action_code	VARCHAR(64)	是	操作编码	普通
sys_audit_log	AuditLog	before_snapshot	JSON	否	变更前快照	普通
sys_audit_log	AuditLog	after_snapshot	JSON	否	变更后快照	普通
sys_audit_log	AuditLog	ip_address	VARCHAR(64)	否	操作 IP	普通
int_integration_log	IntegrationLog	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
int_integration_log	IntegrationLog	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
int_integration_log	IntegrationLog	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
int_integration_log	IntegrationLog	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
int_integration_log	IntegrationLog	created_by	BIGINT	是	创建人账号 ID	普通
int_integration_log	IntegrationLog	created_at	DATETIME	是	创建时间	普通
int_integration_log	IntegrationLog	updated_by	BIGINT	否	最后更新人账号 ID	普通
int_integration_log	IntegrationLog	updated_at	DATETIME	否	最后更新时间	普通
int_integration_log	IntegrationLog	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
int_integration_log	IntegrationLog	deleted_at	DATETIME	否	删除时间，未删除为空	普通
int_integration_log	IntegrationLog	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
int_integration_log	IntegrationLog	version	INT	是	乐观锁版本号，写操作必须校验	普通
int_integration_log	IntegrationLog	request_id	VARCHAR(128)	是	请求 ID，幂等键	普通
int_integration_log	IntegrationLog	system_code	VARCHAR(64)	是	外部系统编码	普通
int_integration_log	IntegrationLog	api_path	VARCHAR(512)	是	接口路径	普通
int_integration_log	IntegrationLog	biz_type	VARCHAR(64)	否	业务类型	普通
int_integration_log	IntegrationLog	biz_id	BIGINT	否	业务 ID	普通
int_integration_log	IntegrationLog	request_payload	JSON	否	请求报文，敏感字段脱敏	敏感
int_integration_log	IntegrationLog	response_payload	JSON	否	响应报文	普通
int_integration_log	IntegrationLog	call_status	VARCHAR(32)	是	成功/失败/超时/重试中	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	created_by	BIGINT	是	创建人账号 ID	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	created_at	DATETIME	是	创建时间	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	updated_by	BIGINT	否	最后更新人账号 ID	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	updated_at	DATETIME	否	最后更新时间	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	deleted_at	DATETIME	否	删除时间，未删除为空	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	version	INT	是	乐观锁版本号，写操作必须校验	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	field_code	VARCHAR(128)	是	字段编码，唯一	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	biz_type	VARCHAR(64)	是	业务类型	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	mask_rule	VARCHAR(64)	是	脱敏规则	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	view_requires_approval	TINYINT	是	明文查看是否需审批	普通
sec_sensitive_field_policy	SensitiveFieldPolicy	watermark_required	TINYINT	是	是否加水印	普通
stu_student	Student	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
stu_student	Student	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
stu_student	Student	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
stu_student	Student	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
stu_student	Student	created_by	BIGINT	是	创建人账号 ID	普通
stu_student	Student	created_at	DATETIME	是	创建时间	普通
stu_student	Student	updated_by	BIGINT	否	最后更新人账号 ID	普通
stu_student	Student	updated_at	DATETIME	否	最后更新时间	普通
stu_student	Student	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
stu_student	Student	deleted_at	DATETIME	否	删除时间，未删除为空	普通
stu_student	Student	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
stu_student	Student	version	INT	是	乐观锁版本号，写操作必须校验	普通
stu_student	Student	student_no	VARCHAR(64)	是	学员编号，唯一	普通
stu_student	Student	family_id	BIGINT	否	家庭 ID	普通
stu_student	Student	student_name	VARCHAR(64)	是	学员姓名	普通
stu_student	Student	gender	VARCHAR(16)	否	性别	普通
stu_student	Student	birthday	DATE	否	出生日期	普通
stu_student	Student	grade	VARCHAR(32)	否	年级	普通
stu_student	Student	school_name	VARCHAR(128)	否	学校名称	普通
stu_student	Student	biz_status	VARCHAR(32)	是	业务状态，取值来自状态机字典	普通
stu_student	Student	remark	VARCHAR(512)	否	业务备注，敏感内容按权限脱敏	普通
edu_course	Course/Product	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
edu_course	Course/Product	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
edu_course	Course/Product	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
edu_course	Course/Product	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
edu_course	Course/Product	created_by	BIGINT	是	创建人账号 ID	普通
edu_course	Course/Product	created_at	DATETIME	是	创建时间	普通
edu_course	Course/Product	updated_by	BIGINT	否	最后更新人账号 ID	普通
edu_course	Course/Product	updated_at	DATETIME	否	最后更新时间	普通
edu_course	Course/Product	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
edu_course	Course/Product	deleted_at	DATETIME	否	删除时间，未删除为空	普通
edu_course	Course/Product	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
edu_course	Course/Product	version	INT	是	乐观锁版本号，写操作必须校验	普通
edu_course	Course/Product	course_code	VARCHAR(64)	是	课程编码，唯一	普通
edu_course	Course/Product	course_name	VARCHAR(128)	是	课程名称	普通
edu_course	Course/Product	subject	VARCHAR(32)	是	学科	普通
edu_course	Course/Product	course_type	VARCHAR(32)	是	班课/一对一/直播/录播	普通
edu_course	Course/Product	grade_scope	JSON	否	适用年级	普通
edu_course	Course/Product	enabled	TINYINT	是	是否启用	普通
edu_homework	Homework	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
edu_homework	Homework	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
edu_homework	Homework	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
edu_homework	Homework	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
edu_homework	Homework	created_by	BIGINT	是	创建人账号 ID	普通
edu_homework	Homework	created_at	DATETIME	是	创建时间	普通
edu_homework	Homework	updated_by	BIGINT	否	最后更新人账号 ID	普通
edu_homework	Homework	updated_at	DATETIME	否	最后更新时间	普通
edu_homework	Homework	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
edu_homework	Homework	deleted_at	DATETIME	否	删除时间，未删除为空	普通
edu_homework	Homework	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
edu_homework	Homework	version	INT	是	乐观锁版本号，写操作必须校验	普通
edu_homework	Homework	homework_no	VARCHAR(64)	是	作业编号，唯一	普通
edu_homework	Homework	lesson_id	BIGINT	是	课次 ID	普通
edu_homework	Homework	title	VARCHAR(128)	是	作业标题	普通
edu_homework	Homework	content_schema	JSON	是	题目、附件、提交要求	普通
edu_homework	Homework	deadline_at	DATETIME	否	截止时间	普通
edu_homework	Homework	publish_status	VARCHAR(32)	是	草稿/已发布/已关闭	普通
edu_homework_review	HomeworkReview	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
edu_homework_review	HomeworkReview	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
edu_homework_review	HomeworkReview	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
edu_homework_review	HomeworkReview	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
edu_homework_review	HomeworkReview	created_by	BIGINT	是	创建人账号 ID	普通
edu_homework_review	HomeworkReview	created_at	DATETIME	是	创建时间	普通
edu_homework_review	HomeworkReview	updated_by	BIGINT	否	最后更新人账号 ID	普通
edu_homework_review	HomeworkReview	updated_at	DATETIME	否	最后更新时间	普通
edu_homework_review	HomeworkReview	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
edu_homework_review	HomeworkReview	deleted_at	DATETIME	否	删除时间，未删除为空	普通
edu_homework_review	HomeworkReview	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
edu_homework_review	HomeworkReview	version	INT	是	乐观锁版本号，写操作必须校验	普通
edu_homework_review	HomeworkReview	submit_id	BIGINT	是	作业提交 ID	普通
edu_homework_review	HomeworkReview	teacher_id	BIGINT	是	批改教师 ID	普通
edu_homework_review	HomeworkReview	score	DECIMAL(6,2)	否	得分	普通
edu_homework_review	HomeworkReview	comment	TEXT	否	评语	普通
edu_homework_review	HomeworkReview	wrong_question_json	JSON	否	错题记录	普通
edu_homework_review	HomeworkReview	review_status	VARCHAR(32)	是	待批改/已批改/需订正	普通
live_room	LiveRoom	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
live_room	LiveRoom	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
live_room	LiveRoom	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
live_room	LiveRoom	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
live_room	LiveRoom	created_by	BIGINT	是	创建人账号 ID	普通
live_room	LiveRoom	created_at	DATETIME	是	创建时间	普通
live_room	LiveRoom	updated_by	BIGINT	否	最后更新人账号 ID	普通
live_room	LiveRoom	updated_at	DATETIME	否	最后更新时间	普通
live_room	LiveRoom	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
live_room	LiveRoom	deleted_at	DATETIME	否	删除时间，未删除为空	普通
live_room	LiveRoom	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
live_room	LiveRoom	version	INT	是	乐观锁版本号，写操作必须校验	普通
live_room	LiveRoom	room_no	VARCHAR(64)	是	直播间编号，唯一	普通
live_room	LiveRoom	live_type	VARCHAR(32)	是	教学直播/活动直播/集团会议直播	普通
live_room	LiveRoom	provider_code	VARCHAR(32)	是	启用供应商	普通
live_room	LiveRoom	biz_type	VARCHAR(64)	是	绑定业务类型	普通
live_room	LiveRoom	biz_id	BIGINT	是	绑定业务 ID	普通
live_room	LiveRoom	start_at	DATETIME	否	计划开始时间	普通
live_room	LiveRoom	end_at	DATETIME	否	计划结束时间	普通
live_room	LiveRoom	room_status	VARCHAR(32)	是	待开播/直播中/已结束/异常	普通
live_participant	LiveSession/LiveAttendance	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
live_participant	LiveSession/LiveAttendance	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
live_participant	LiveSession/LiveAttendance	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
live_participant	LiveSession/LiveAttendance	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
live_participant	LiveSession/LiveAttendance	created_by	BIGINT	是	创建人账号 ID	普通
live_participant	LiveSession/LiveAttendance	created_at	DATETIME	是	创建时间	普通
live_participant	LiveSession/LiveAttendance	updated_by	BIGINT	否	最后更新人账号 ID	普通
live_participant	LiveSession/LiveAttendance	updated_at	DATETIME	否	最后更新时间	普通
live_participant	LiveSession/LiveAttendance	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
live_participant	LiveSession/LiveAttendance	deleted_at	DATETIME	否	删除时间，未删除为空	普通
live_participant	LiveSession/LiveAttendance	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
live_participant	LiveSession/LiveAttendance	version	INT	是	乐观锁版本号，写操作必须校验	普通
live_participant	LiveSession/LiveAttendance	live_room_id	BIGINT	是	直播间 ID	普通
live_participant	LiveSession/LiveAttendance	user_id	BIGINT	是	用户 ID	普通
live_participant	LiveSession/LiveAttendance	participant_type	VARCHAR(32)	是	学员/教师/员工/家长/访客	普通
live_participant	LiveSession/LiveAttendance	join_status	VARCHAR(32)	是	未进入/观看中/已离开/掉线	普通
live_participant	LiveSession/LiveAttendance	watch_duration	INT	是	观看时长秒数	普通
live_participant	LiveSession/LiveAttendance	sign_status	VARCHAR(32)	否	签到状态	普通
live_participant	LiveSession/LiveAttendance	last_heartbeat_at	DATETIME	否	最近心跳	普通
live_mic_request	LiveMicRequest	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
live_mic_request	LiveMicRequest	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
live_mic_request	LiveMicRequest	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
live_mic_request	LiveMicRequest	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
live_mic_request	LiveMicRequest	created_by	BIGINT	是	创建人账号 ID	普通
live_mic_request	LiveMicRequest	created_at	DATETIME	是	创建时间	普通
live_mic_request	LiveMicRequest	updated_by	BIGINT	否	最后更新人账号 ID	普通
live_mic_request	LiveMicRequest	updated_at	DATETIME	否	最后更新时间	普通
live_mic_request	LiveMicRequest	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
live_mic_request	LiveMicRequest	deleted_at	DATETIME	否	删除时间，未删除为空	普通
live_mic_request	LiveMicRequest	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
live_mic_request	LiveMicRequest	version	INT	是	乐观锁版本号，写操作必须校验	普通
live_mic_request	LiveMicRequest	live_room_id	BIGINT	是	直播间 ID	普通
live_mic_request	LiveMicRequest	requester_id	BIGINT	是	申请人 ID	普通
live_mic_request	LiveMicRequest	request_status	VARCHAR(32)	是	排队中/已邀请/已上麦/已拒绝/已超时/已取消	普通
live_mic_request	LiveMicRequest	queue_no	INT	否	队列序号	普通
live_mic_request	LiveMicRequest	seat_no	INT	否	座席号	普通
live_mic_request	LiveMicRequest	invite_expire_at	DATETIME	否	邀请过期时间	普通
live_mic_request	LiveMicRequest	device_check_result	JSON	否	设备检测结果	普通
live_mic_seat	LiveMicSeat	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
live_mic_seat	LiveMicSeat	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
live_mic_seat	LiveMicSeat	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
live_mic_seat	LiveMicSeat	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
live_mic_seat	LiveMicSeat	created_by	BIGINT	是	创建人账号 ID	普通
live_mic_seat	LiveMicSeat	created_at	DATETIME	是	创建时间	普通
live_mic_seat	LiveMicSeat	updated_by	BIGINT	否	最后更新人账号 ID	普通
live_mic_seat	LiveMicSeat	updated_at	DATETIME	否	最后更新时间	普通
live_mic_seat	LiveMicSeat	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
live_mic_seat	LiveMicSeat	deleted_at	DATETIME	否	删除时间，未删除为空	普通
live_mic_seat	LiveMicSeat	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
live_mic_seat	LiveMicSeat	version	INT	是	乐观锁版本号，写操作必须校验	普通
live_mic_seat	LiveMicSeat	live_room_id	BIGINT	是	直播间 ID	普通
live_mic_seat	LiveMicSeat	seat_no	INT	是	座席号	普通
live_mic_seat	LiveMicSeat	participant_id	BIGINT	否	上麦参与人 ID	普通
live_mic_seat	LiveMicSeat	seat_status	VARCHAR(32)	是	空闲/邀请中/使用中/异常	普通
live_mic_seat	LiveMicSeat	muted	TINYINT	是	是否静音	普通
live_mic_seat	LiveMicSeat	provider_session_id	VARCHAR(128)	否	供应商会话 ID	普通
live_recording_file	LiveRecording	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
live_recording_file	LiveRecording	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
live_recording_file	LiveRecording	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
live_recording_file	LiveRecording	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
live_recording_file	LiveRecording	created_by	BIGINT	是	创建人账号 ID	普通
live_recording_file	LiveRecording	created_at	DATETIME	是	创建时间	普通
live_recording_file	LiveRecording	updated_by	BIGINT	否	最后更新人账号 ID	普通
live_recording_file	LiveRecording	updated_at	DATETIME	否	最后更新时间	普通
live_recording_file	LiveRecording	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
live_recording_file	LiveRecording	deleted_at	DATETIME	否	删除时间，未删除为空	普通
live_recording_file	LiveRecording	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
live_recording_file	LiveRecording	version	INT	是	乐观锁版本号，写操作必须校验	普通
live_recording_file	LiveRecording	live_room_id	BIGINT	是	直播间 ID	普通
live_recording_file	LiveRecording	provider_record_id	VARCHAR(128)	否	供应商录制 ID	普通
live_recording_file	LiveRecording	recording_status	VARCHAR(32)	是	录制中/转码中/可播放/失败/已过期	普通
live_recording_file	LiveRecording	replay_url	VARCHAR(512)	否	回放地址	普通
live_recording_file	LiveRecording	storage_location	VARCHAR(512)	否	供应商 OSS/COS/Kodo 存储位置	普通
live_recording_file	LiveRecording	duration	INT	否	时长秒数	普通
live_recording_file	LiveRecording	retention_until	DATETIME	否	保留到期时间	普通
res_learning_resource	LearningResource	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
res_learning_resource	LearningResource	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
res_learning_resource	LearningResource	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
res_learning_resource	LearningResource	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
res_learning_resource	LearningResource	created_by	BIGINT	是	创建人账号 ID	普通
res_learning_resource	LearningResource	created_at	DATETIME	是	创建时间	普通
res_learning_resource	LearningResource	updated_by	BIGINT	否	最后更新人账号 ID	普通
res_learning_resource	LearningResource	updated_at	DATETIME	否	最后更新时间	普通
res_learning_resource	LearningResource	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
res_learning_resource	LearningResource	deleted_at	DATETIME	否	删除时间，未删除为空	普通
res_learning_resource	LearningResource	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
res_learning_resource	LearningResource	version	INT	是	乐观锁版本号，写操作必须校验	普通
res_learning_resource	LearningResource	resource_no	VARCHAR(64)	是	资源编号，唯一	普通
res_learning_resource	LearningResource	resource_name	VARCHAR(128)	是	资源名称	普通
res_learning_resource	LearningResource	resource_type	VARCHAR(32)	是	课件/视频/音频/题库/文章/试卷	普通
res_learning_resource	LearningResource	category_id	BIGINT	否	资源分类	普通
res_learning_resource	LearningResource	file_id	BIGINT	否	文件 ID	普通
res_learning_resource	LearningResource	publish_status	VARCHAR(32)	是	草稿/审核中/已发布/已下架	普通
mat_sku	Material/Inventory/Asset/Book	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
mat_sku	Material/Inventory/Asset/Book	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
mat_sku	Material/Inventory/Asset/Book	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
mat_sku	Material/Inventory/Asset/Book	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
mat_sku	Material/Inventory/Asset/Book	created_by	BIGINT	是	创建人账号 ID	普通
mat_sku	Material/Inventory/Asset/Book	created_at	DATETIME	是	创建时间	普通
mat_sku	Material/Inventory/Asset/Book	updated_by	BIGINT	否	最后更新人账号 ID	普通
mat_sku	Material/Inventory/Asset/Book	updated_at	DATETIME	否	最后更新时间	普通
mat_sku	Material/Inventory/Asset/Book	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
mat_sku	Material/Inventory/Asset/Book	deleted_at	DATETIME	否	删除时间，未删除为空	普通
mat_sku	Material/Inventory/Asset/Book	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
mat_sku	Material/Inventory/Asset/Book	version	INT	是	乐观锁版本号，写操作必须校验	普通
mat_sku	Material/Inventory/Asset/Book	sku_code	VARCHAR(64)	是	SKU 编码，唯一	普通
mat_sku	Material/Inventory/Asset/Book	sku_name	VARCHAR(128)	是	SKU 名称	普通
mat_sku	Material/Inventory/Asset/Book	sku_type	VARCHAR(32)	是	物料/固定资产/图书/积分礼品	普通
mat_sku	Material/Inventory/Asset/Book	unit	VARCHAR(16)	是	计量单位	普通
mat_sku	Material/Inventory/Asset/Book	gift_points	INT	否	作为积分礼品时所需积分	普通
mat_sku	Material/Inventory/Asset/Book	enabled	TINYINT	是	是否启用	普通

JSON 字段结构与校验

表名	对象	字段	结构编码	结构定义	校验规则	示例
stu_learning_profile	LearningProfile	ability_tags	LEARNING_PROFILE	{ability:[{code:string, score:number}], weakPoints:string[], lastReportId?:number}	能力分 0-100；来源必须可追溯到课程、作业、测评或直播	{"ability":[{"code":"LISTENING","score":82}],"weakPoints":["过去式"]}
stu_learning_profile	LearningProfile	profile_snapshot	AUDIT_SNAPSHOT	{before?:object, after?:object, changedFields:string[], maskPolicy:string}	敏感字段必须按脱敏策略写入，不允许存储明文密码或密钥	{"changedFields":["owner_id"],"maskPolicy":"MOBILE_MASK"}
edu_homework_draft	HomeworkDraft	answer_snapshot	AUDIT_SNAPSHOT	{before?:object, after?:object, changedFields:string[], maskPolicy:string}	敏感字段必须按脱敏策略写入，不允许存储明文密码或密钥	{"changedFields":["owner_id"],"maskPolicy":"MOBILE_MASK"}
edu_homework_draft	HomeworkDraft	attachment_temp_ids	ID_LIST	array<number>	数组长度 1-500；元素必须为已存在且未逻辑删除的业务 ID	[10001,10002]
edu_homework_submit	HomeworkSubmit	answer_payload	SUPERVISION_PAYLOAD	{bizType:string, contractNo:string, amount:number, student:object, attachments:number[]}	报送字段必须满足教育局/监管账户配置的必填规则	{"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800}
stu_wrong_question_practice	WrongQuestionPractice	source_question_ids	GENERIC	object \| array	必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本	{"version":1,"items":[]}
stu_wrong_question_practice	WrongQuestionPractice	result_snapshot	AUDIT_SNAPSHOT	{before?:object, after?:object, changedFields:string[], maskPolicy:string}	敏感字段必须按脱敏策略写入，不允许存储明文密码或密钥	{"changedFields":["owner_id"],"maskPolicy":"MOBILE_MASK"}
stu_desktop_sync_task	DesktopSyncTask	sync_payload	SUPERVISION_PAYLOAD	{bizType:string, contractNo:string, amount:number, student:object, attachments:number[]}	报送字段必须满足教育局/监管账户配置的必填规则	{"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800}

状态/枚举标准字典

表名	对象	字段	枚举编码	取值	终态/流转规则	字段说明
stu_account	StudentAccount	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
stu_account	StudentAccount	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
stu_account	StudentAccount	account_type	ACCOUNT_TYPE	学校下发、手机号自主注册、家长代开通	非终态，可按状态机或字典规则流转	学校下发/手机号自主注册/家长代开通
stu_account	StudentAccount	login_status	LOGIN_STATUS	PENDING 待激活、NORMAL 正常、LOCKED 锁定、DISABLED 停用	包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程	待激活/正常/锁定/停用
stu_account	StudentAccount	cancel_request_status	CANCEL_REQUEST_STATUS	无、申请中、已通过、已驳回	非终态，可按状态机或字典规则流转	注销申请状态：无/申请中/已通过/已驳回
stu_account_registration	StudentAccountRegistration	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
stu_account_registration	StudentAccountRegistration	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
stu_account_registration	StudentAccountRegistration	password_set_status	PASSWORD_SET_STATUS	未设置、已设置、需重置	非终态，可按状态机或字典规则流转	未设置/已设置/需重置
stu_account_registration	StudentAccountRegistration	register_status	REGISTER_STATUS	待提交、审核中、已开通、已驳回、已取消	包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程	待提交/审核中/已开通/已驳回/已取消
stu_session_selection	StudentSessionSelection	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
stu_session_selection	StudentSessionSelection	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
stu_session_selection	StudentSessionSelection	source_channel	SOURCE_CHANNEL	DOUYIN 抖音、XIAOHONGSHU 小红书、MEITUAN 美团、WECHAT 公众号/小程序、GROUND_PUSH 地推、REFERRAL 转介绍、NATURAL 自然到访、IMPORT 批量导入、OTHER 其他	非终态，可按状态机或字典规则流转	小程序/App/H5/Tauri
stu_session_selection	StudentSessionSelection	remember_last	BOOL	按业务字典配置，需在字典中心维护编码、名称、排序、启停和终态标识	非终态，可按状态机或字典规则流转	是否记住本次选择
stu_session_selection	StudentSessionSelection	selection_status	SELECTION_STATUS	有效、权益过期、已切换、同步失败	包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程	有效/权益过期/已切换/同步失败
stu_device_session	StudentDeviceSession	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
stu_device_session	StudentDeviceSession	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
stu_device_session	StudentDeviceSession	client_type	CLIENT_TYPE	微信小程序、iOS、iPadOS、Android、安卓平板、H5、Tauri-macOS、Tauri-Windows	非终态，可按状态机或字典规则流转	微信小程序/iOS/iPadOS/Android/安卓平板/H5/Tauri-macOS/Tauri-Windows
stu_device_session	StudentDeviceSession	session_status	SESSION_STATUS	有效、过期、踢下线、设备超限	非终态，可按状态机或字典规则流转	有效/过期/踢下线/设备超限
stu_learning_profile	LearningProfile	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
stu_learning_profile	LearningProfile	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
stu_learning_task	LearningTask	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
stu_learning_task	LearningTask	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
stu_learning_task	LearningTask	task_type	TASK_TYPE	课程、作业、测评、直播、回放	非终态，可按状态机或字典规则流转	课程/作业/测评/直播/回放
stu_learning_task	LearningTask	complete_status	LEARNING_STATUS	NOT_STARTED 未开始、IN_PROGRESS 进行中、COMPLETED 已完成、OVERDUE 逾期	非终态，可按状态机或字典规则流转	未开始/进行中/已完成/逾期
edu_homework_draft	HomeworkDraft	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
edu_homework_draft	HomeworkDraft	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
edu_homework_draft	HomeworkDraft	draft_status	DRAFT_STATUS	草稿中、已提交、已删除、已过期、冲突待处理	非终态，可按状态机或字典规则流转	草稿中/已提交/已删除/已过期/冲突待处理
edu_homework_draft	HomeworkDraft	client_type	CLIENT_TYPE	按业务字典配置，需在字典中心维护编码、名称、排序、启停和终态标识	非终态，可按状态机或字典规则流转	最近保存端
edu_homework_draft	HomeworkDraft	conflict_status	CONFLICT_STATUS	无冲突、有冲突、已合并	非终态，可按状态机或字典规则流转	无冲突/有冲突/已合并
edu_homework_submit	HomeworkSubmit	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
edu_homework_submit	HomeworkSubmit	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
edu_homework_submit	HomeworkSubmit	submit_status	SUBMIT_STATUS	待提交、已提交、已批改、需订正	非终态，可按状态机或字典规则流转	待提交/已提交/已批改/需订正
stu_wrong_question_practice	WrongQuestionPractice	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
stu_wrong_question_practice	WrongQuestionPractice	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
stu_wrong_question_practice	WrongQuestionPractice	practice_mode	PRACTICE_MODE	一键 5 题复练、错题重组测试、知识点专项	非终态，可按状态机或字典规则流转	一键 5 题复练/错题重组测试/知识点专项
stu_wrong_question_practice	WrongQuestionPractice	practice_status	PRACTICE_STATUS	待练习、进行中、已完成、生成失败	包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程	待练习/进行中/已完成/生成失败
stu_portfolio_item	StudentPortfolioItem	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
stu_portfolio_item	StudentPortfolioItem	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
stu_portfolio_item	StudentPortfolioItem	item_type	ITEM_TYPE	图片、音频、视频、作业、测评报告、课堂作品	非终态，可按状态机或字典规则流转	图片/音频/视频/作业/测评报告/课堂作品
stu_portfolio_item	StudentPortfolioItem	media_type	MEDIA_TYPE	图片、音频、视频、PDF、链接	非终态，可按状态机或字典规则流转	图片/音频/视频/PDF/链接
stu_portfolio_item	StudentPortfolioItem	transcode_status	TRANSCODE_STATUS	无需转码、转码中、成功、失败	包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程	无需转码/转码中/成功/失败
stu_portfolio_item	StudentPortfolioItem	share_status	SHARE_STATUS	不可分享、可分享、已分享、分享失效	非终态，可按状态机或字典规则流转	不可分享/可分享/已分享/分享失效
pts_account	PointsAccount	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
pts_account	PointsAccount	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
pts_lock	PointsLock	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
pts_lock	PointsLock	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
pts_lock	PointsLock	lock_status	LOCK_STATUS	锁定中、已确认、已释放、已过期	非终态，可按状态机或字典规则流转	锁定中/已确认/已释放/已过期
pts_order	PointsOrder	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
pts_order	PointsOrder	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
pts_order	PointsOrder	order_status	ORDER_STATUS	DRAFT 草稿、PENDING 待处理、PARTIAL 部分完成、COMPLETED 已完成、CANCELLED 已取消、AFTER_SALES 售后中	包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程	待领取/已核销/已取消/售后中
pts_write_off_code	PointsWriteOffCode	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
pts_write_off_code	PointsWriteOffCode	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
pts_write_off_code	PointsWriteOffCode	code_type	CODE_TYPE	二维码、条形码、数字码	非终态，可按状态机或字典规则流转	二维码/条形码/数字码
pts_write_off_code	PointsWriteOffCode	write_off_status	WRITE_OFF_STATUS	待核销、已核销、已过期、已作废	包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程	待核销/已核销/已过期/已作废
pts_write_off_code	PointsWriteOffCode	brightness_hint	BOOL	按业务字典配置，需在字典中心维护编码、名称、排序、启停和终态标识	非终态，可按状态机或字典规则流转	端侧是否建议自动调高亮度
pts_after_sales	PointsRedemptionAfterSales	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
pts_after_sales	PointsRedemptionAfterSales	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
pts_after_sales	PointsRedemptionAfterSales	request_type	REQUEST_TYPE	取消、退积分、补发、异常核销	非终态，可按状态机或字典规则流转	取消/退积分/补发/异常核销
pts_after_sales	PointsRedemptionAfterSales	handle_status	HANDLE_STATUS	待处理、已处理、已驳回	非终态，可按状态机或字典规则流转	待处理/已处理/已驳回
stu_desktop_sync_task	DesktopSyncTask	tenant_id	TENANT_ID	集团、租户隔离字段	非终态，可按状态机或字典规则流转	集团/租户隔离字段，所有查询必须带租户上下文
stu_desktop_sync_task	DesktopSyncTask	is_deleted	BOOL_DELETED	0 未删除、1 已删除	非终态，可按状态机或字典规则流转	是否已删除，0 未删除，1 已删除
stu_desktop_sync_task	DesktopSyncTask	strong_prompt	BOOL	按业务字典配置，需在字典中心维护编码、名称、排序、启停和终态标识	非终态，可按状态机或字典规则流转	是否已触发强提示
stu_desktop_sync_task	DesktopSyncTask	sync_status	SYNC_STATUS	待同步、同步中、成功、失败、冲突	包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程	待同步/同步中/成功/失败/冲突

敏感字段与数据安全策略

来源	表名	对象	字段	数据级别	脱敏/返回策略	明文查看条件	导出策略	审计要求	端侧展示规则
本模块对象	stu_account	StudentAccount	account_no	普通	BANK_ACCOUNT_MASK	默认展示后 4 位；付款、报销、工资发放场景按岗位权限展示	导出银行账号必须走财务/安全双审批	查看、变更、付款使用、导出均记录业务单号和操作者	财务 PC 可按权限明文；员工端和移动端默认脱敏
本模块对象	stu_account	StudentAccount	login_name	普通	BIZ_FIELD_MASK	按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行	导出时按数据级别触发审批、水印、下载有效期和日志	查看、修改、删除、导出、下载和审批均记录操作审计	默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
本模块对象	stu_account	StudentAccount	account_type	普通	BIZ_FIELD_MASK	按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行	导出时按数据级别触发审批、水印、下载有效期和日志	查看、修改、删除、导出、下载和审批均记录操作审计	默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
本模块对象	stu_account	StudentAccount	mobile	敏感	MOBILE_MASK	默认展示 138****0000；明文查看需字段权限或敏感字段查看审批	导出手机号必须触发导出审批、下载水印和有效期控制	明文查看、复制、导出和批量下载均写入 SensitiveAccessLog	PC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息
本模块对象	stu_account	StudentAccount	wechat_openid	敏感	BIZ_FIELD_MASK	按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行	导出时按数据级别触发审批、水印、下载有效期和日志	查看、修改、删除、导出、下载和审批均记录操作审计	默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
本模块对象	stu_account	StudentAccount	password_hash	敏感	NEVER_RETURN	禁止接口返回明文；仅密钥中心/鉴权服务按服务身份读取密钥引用	禁止导出；配置导出只允许导出脱敏引用和启停状态	配置新增、修改、启停、轮换和失败读取均记录安全审计	前端只展示已配置/未配置、到期时间和连通性状态，不展示密钥值
本模块对象	stu_account_registration	StudentAccountRegistration	mobile	敏感	MOBILE_MASK	默认展示 138****0000；明文查看需字段权限或敏感字段查看审批	导出手机号必须触发导出审批、下载水印和有效期控制	明文查看、复制、导出和批量下载均写入 SensitiveAccessLog	PC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息
本模块对象	stu_account_registration	StudentAccountRegistration	student_name	敏感	BIZ_FIELD_MASK	按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行	导出时按数据级别触发审批、水印、下载有效期和日志	查看、修改、删除、导出、下载和审批均记录操作审计	默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
本模块对象	stu_account_registration	StudentAccountRegistration	password_set_status	普通	NEVER_RETURN	禁止接口返回明文；仅密钥中心/鉴权服务按服务身份读取密钥引用	禁止导出；配置导出只允许导出脱敏引用和启停状态	配置新增、修改、启停、轮换和失败读取均记录安全审计	前端只展示已配置/未配置、到期时间和连通性状态，不展示密钥值
本模块对象	edu_homework_submit	HomeworkSubmit	answer_payload	普通	PAYLOAD_DESENSITIZE	接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权	导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段	查看报文、下载附件、失败重放和人工补偿均记录审计	业务端展示摘要和状态，完整报文仅运维/安全后台查看
本模块对象	stu_desktop_sync_task	DesktopSyncTask	sync_payload	普通	PAYLOAD_DESENSITIZE	接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权	导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段	查看报文、下载附件、失败重放和人工补偿均记录审计	业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象	sys_user	User/Employee	mobile	敏感	MOBILE_MASK	默认展示 138****0000；明文查看需字段权限或敏感字段查看审批	导出手机号必须触发导出审批、下载水印和有效期控制	明文查看、复制、导出和批量下载均写入 SensitiveAccessLog	PC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息
引用对象	sys_user	User/Employee	password_hash	高敏	NEVER_RETURN	禁止接口返回明文；仅密钥中心/鉴权服务按服务身份读取密钥引用	禁止导出；配置导出只允许导出脱敏引用和启停状态	配置新增、修改、启停、轮换和失败读取均记录安全审计	前端只展示已配置/未配置、到期时间和连通性状态，不展示密钥值
引用对象	int_integration_log	IntegrationLog	request_payload	敏感	PAYLOAD_DESENSITIZE	接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权	导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段	查看报文、下载附件、失败重放和人工补偿均记录审计	业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象	int_integration_log	IntegrationLog	response_payload	普通	PAYLOAD_DESENSITIZE	接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权	导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段	查看报文、下载附件、失败重放和人工补偿均记录审计	业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象	sec_sensitive_field_policy	SensitiveFieldPolicy	mask_rule	普通	BIZ_FIELD_MASK	按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行	导出时按数据级别触发审批、水印、下载有效期和日志	查看、修改、删除、导出、下载和审批均记录操作审计	默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
引用对象	stu_student	Student	remark	普通	BIZ_FIELD_MASK	按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行	导出时按数据级别触发审批、水印、下载有效期和日志	查看、修改、删除、导出、下载和审批均记录操作审计	默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则

核心数据表完整字段

表名	对象	字段	类型	必填	规则	数据级别
stu_account	StudentAccount	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
stu_account	StudentAccount	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
stu_account	StudentAccount	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
stu_account	StudentAccount	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
stu_account	StudentAccount	created_by	BIGINT	是	创建人账号 ID	普通
stu_account	StudentAccount	created_at	DATETIME	是	创建时间	普通
stu_account	StudentAccount	updated_by	BIGINT	否	最后更新人账号 ID	普通
stu_account	StudentAccount	updated_at	DATETIME	否	最后更新时间	普通
stu_account	StudentAccount	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
stu_account	StudentAccount	deleted_at	DATETIME	否	删除时间，未删除为空	普通
stu_account	StudentAccount	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
stu_account	StudentAccount	version	INT	是	乐观锁版本号，写操作必须校验	普通
stu_account	StudentAccount	account_no	VARCHAR(64)	是	学员账号编号，唯一	普通
stu_account	StudentAccount	login_name	VARCHAR(64)	是	学校下发的学员用户名或手机号登录名	普通
stu_account	StudentAccount	student_id	BIGINT	否	默认绑定学员 ID，多学员账号可为空	普通
stu_account	StudentAccount	account_type	VARCHAR(32)	是	学校下发/手机号自主注册/家长代开通	普通
stu_account	StudentAccount	mobile	VARCHAR(32)	否	手机号，敏感	敏感
stu_account	StudentAccount	wechat_openid	VARCHAR(128)	否	微信 OpenID，敏感	敏感
stu_account	StudentAccount	password_hash	VARCHAR(255)	否	密码哈希，禁止明文存储	敏感
stu_account	StudentAccount	login_status	VARCHAR(32)	是	待激活/正常/锁定/停用	普通
stu_account	StudentAccount	activated_at	DATETIME	否	账号激活时间	普通
stu_account	StudentAccount	cancel_request_status	VARCHAR(32)	否	注销申请状态：无/申请中/已通过/已驳回	普通
stu_account	StudentAccount	last_login_at	DATETIME	否	最近登录时间	普通
stu_account_registration	StudentAccountRegistration	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
stu_account_registration	StudentAccountRegistration	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
stu_account_registration	StudentAccountRegistration	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
stu_account_registration	StudentAccountRegistration	campus_id	BIGINT	否	意向校区	普通
stu_account_registration	StudentAccountRegistration	created_by	BIGINT	是	创建人账号 ID	普通
stu_account_registration	StudentAccountRegistration	created_at	DATETIME	是	创建时间	普通
stu_account_registration	StudentAccountRegistration	updated_by	BIGINT	否	最后更新人账号 ID	普通
stu_account_registration	StudentAccountRegistration	updated_at	DATETIME	否	最后更新时间	普通
stu_account_registration	StudentAccountRegistration	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
stu_account_registration	StudentAccountRegistration	deleted_at	DATETIME	否	删除时间，未删除为空	普通
stu_account_registration	StudentAccountRegistration	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
stu_account_registration	StudentAccountRegistration	version	INT	是	乐观锁版本号，写操作必须校验	普通
stu_account_registration	StudentAccountRegistration	register_no	VARCHAR(64)	是	注册单编号，唯一	普通
stu_account_registration	StudentAccountRegistration	mobile	VARCHAR(32)	是	注册手机号，敏感	敏感
stu_account_registration	StudentAccountRegistration	sms_verify_id	VARCHAR(64)	是	短信验证码校验流水，不存储明文验证码	普通
stu_account_registration	StudentAccountRegistration	student_name	VARCHAR(64)	否	注册时填写的学员姓名，敏感	敏感
stu_account_registration	StudentAccountRegistration	password_set_status	VARCHAR(32)	是	未设置/已设置/需重置	普通
stu_account_registration	StudentAccountRegistration	agreement_version	VARCHAR(32)	是	已勾选协议版本	普通
stu_account_registration	StudentAccountRegistration	register_status	VARCHAR(32)	是	待提交/审核中/已开通/已驳回/已取消	普通
stu_account_registration	StudentAccountRegistration	linked_account_id	BIGINT	否	开通后的学员账号 ID	普通
stu_session_selection	StudentSessionSelection	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
stu_session_selection	StudentSessionSelection	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
stu_session_selection	StudentSessionSelection	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
stu_session_selection	StudentSessionSelection	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
stu_session_selection	StudentSessionSelection	created_by	BIGINT	是	创建人账号 ID	普通
stu_session_selection	StudentSessionSelection	created_at	DATETIME	是	创建时间	普通
stu_session_selection	StudentSessionSelection	updated_by	BIGINT	否	最后更新人账号 ID	普通
stu_session_selection	StudentSessionSelection	updated_at	DATETIME	否	最后更新时间	普通
stu_session_selection	StudentSessionSelection	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
stu_session_selection	StudentSessionSelection	deleted_at	DATETIME	否	删除时间，未删除为空	普通
stu_session_selection	StudentSessionSelection	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
stu_session_selection	StudentSessionSelection	version	INT	是	乐观锁版本号，写操作必须校验	普通
stu_session_selection	StudentSessionSelection	account_id	BIGINT	是	学员端账号 ID	普通
stu_session_selection	StudentSessionSelection	selected_student_id	BIGINT	是	当前上课学员 ID	普通
stu_session_selection	StudentSessionSelection	source_channel	VARCHAR(32)	是	小程序/App/H5/Tauri	普通
stu_session_selection	StudentSessionSelection	remember_last	TINYINT	是	是否记住本次选择	普通
stu_session_selection	StudentSessionSelection	selected_at	DATETIME	是	选择时间	普通
stu_session_selection	StudentSessionSelection	selection_status	VARCHAR(32)	是	有效/权益过期/已切换/同步失败	普通
stu_session_selection	StudentSessionSelection	last_sync_result	VARCHAR(512)	否	最近一次端侧同步结果	普通
stu_device_session	StudentDeviceSession	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
stu_device_session	StudentDeviceSession	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
stu_device_session	StudentDeviceSession	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
stu_device_session	StudentDeviceSession	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
stu_device_session	StudentDeviceSession	created_by	BIGINT	是	创建人账号 ID	普通
stu_device_session	StudentDeviceSession	created_at	DATETIME	是	创建时间	普通
stu_device_session	StudentDeviceSession	updated_by	BIGINT	否	最后更新人账号 ID	普通
stu_device_session	StudentDeviceSession	updated_at	DATETIME	否	最后更新时间	普通
stu_device_session	StudentDeviceSession	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
stu_device_session	StudentDeviceSession	deleted_at	DATETIME	否	删除时间，未删除为空	普通
stu_device_session	StudentDeviceSession	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
stu_device_session	StudentDeviceSession	version	INT	是	乐观锁版本号，写操作必须校验	普通
stu_device_session	StudentDeviceSession	account_id	BIGINT	是	学员端账号 ID	普通
stu_device_session	StudentDeviceSession	student_id	BIGINT	否	当前选择学员 ID	普通
stu_device_session	StudentDeviceSession	device_id	VARCHAR(128)	是	端侧设备 ID	普通
stu_device_session	StudentDeviceSession	client_type	VARCHAR(32)	是	微信小程序/iOS/iPadOS/Android/安卓平板/H5/Tauri-macOS/Tauri-Windows	普通
stu_device_session	StudentDeviceSession	app_version	VARCHAR(32)	否	客户端版本号	普通
stu_device_session	StudentDeviceSession	login_at	DATETIME	是	登录时间	普通
stu_device_session	StudentDeviceSession	last_active_at	DATETIME	否	最近活跃时间	普通
stu_device_session	StudentDeviceSession	session_status	VARCHAR(32)	是	有效/过期/踢下线/设备超限	普通
stu_learning_profile	LearningProfile	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
stu_learning_profile	LearningProfile	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
stu_learning_profile	LearningProfile	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
stu_learning_profile	LearningProfile	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
stu_learning_profile	LearningProfile	created_by	BIGINT	是	创建人账号 ID	普通
stu_learning_profile	LearningProfile	created_at	DATETIME	是	创建时间	普通
stu_learning_profile	LearningProfile	updated_by	BIGINT	否	最后更新人账号 ID	普通
stu_learning_profile	LearningProfile	updated_at	DATETIME	否	最后更新时间	普通
stu_learning_profile	LearningProfile	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
stu_learning_profile	LearningProfile	deleted_at	DATETIME	否	删除时间，未删除为空	普通
stu_learning_profile	LearningProfile	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
stu_learning_profile	LearningProfile	version	INT	是	乐观锁版本号，写操作必须校验	普通
stu_learning_profile	LearningProfile	student_id	BIGINT	是	学员 ID	普通
stu_learning_profile	LearningProfile	course_id	BIGINT	是	课程 ID	普通
stu_learning_profile	LearningProfile	progress_percent	DECIMAL(6,2)	是	学习进度百分比	普通
stu_learning_profile	LearningProfile	ability_tags	JSON	否	能力标签	普通
stu_learning_profile	LearningProfile	last_active_at	DATETIME	否	最近学习时间	普通
stu_learning_profile	LearningProfile	profile_snapshot	JSON	否	学习画像快照	普通
stu_learning_task	LearningTask	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
stu_learning_task	LearningTask	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
stu_learning_task	LearningTask	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
stu_learning_task	LearningTask	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
stu_learning_task	LearningTask	created_by	BIGINT	是	创建人账号 ID	普通
stu_learning_task	LearningTask	created_at	DATETIME	是	创建时间	普通
stu_learning_task	LearningTask	updated_by	BIGINT	否	最后更新人账号 ID	普通
stu_learning_task	LearningTask	updated_at	DATETIME	否	最后更新时间	普通
stu_learning_task	LearningTask	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
stu_learning_task	LearningTask	deleted_at	DATETIME	否	删除时间，未删除为空	普通
stu_learning_task	LearningTask	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
stu_learning_task	LearningTask	version	INT	是	乐观锁版本号，写操作必须校验	普通
stu_learning_task	LearningTask	task_no	VARCHAR(64)	是	任务编号，唯一	普通
stu_learning_task	LearningTask	student_id	BIGINT	是	学员 ID	普通
stu_learning_task	LearningTask	task_type	VARCHAR(32)	是	课程/作业/测评/直播/回放	普通
stu_learning_task	LearningTask	biz_id	BIGINT	是	业务 ID	普通
stu_learning_task	LearningTask	deadline_at	DATETIME	否	截止时间	普通
stu_learning_task	LearningTask	complete_status	VARCHAR(32)	是	未开始/进行中/已完成/逾期	普通
edu_homework_draft	HomeworkDraft	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
edu_homework_draft	HomeworkDraft	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
edu_homework_draft	HomeworkDraft	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
edu_homework_draft	HomeworkDraft	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
edu_homework_draft	HomeworkDraft	created_by	BIGINT	是	创建人账号 ID	普通
edu_homework_draft	HomeworkDraft	created_at	DATETIME	是	创建时间	普通
edu_homework_draft	HomeworkDraft	updated_by	BIGINT	否	最后更新人账号 ID	普通
edu_homework_draft	HomeworkDraft	updated_at	DATETIME	否	最后更新时间	普通
edu_homework_draft	HomeworkDraft	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
edu_homework_draft	HomeworkDraft	deleted_at	DATETIME	否	删除时间，未删除为空	普通
edu_homework_draft	HomeworkDraft	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
edu_homework_draft	HomeworkDraft	version	INT	是	乐观锁版本号，写操作必须校验	普通
edu_homework_draft	HomeworkDraft	draft_no	VARCHAR(64)	是	草稿编号，唯一	普通
edu_homework_draft	HomeworkDraft	homework_id	BIGINT	是	作业 ID	普通
edu_homework_draft	HomeworkDraft	student_id	BIGINT	是	学员 ID	普通
edu_homework_draft	HomeworkDraft	draft_status	VARCHAR(32)	是	草稿中/已提交/已删除/已过期/冲突待处理	普通
edu_homework_draft	HomeworkDraft	answer_snapshot	JSON	是	答案草稿	普通
edu_homework_draft	HomeworkDraft	attachment_temp_ids	JSON	否	临时附件	普通
edu_homework_draft	HomeworkDraft	auto_save_version	INT	是	自动保存版本	普通
edu_homework_draft	HomeworkDraft	last_saved_at	DATETIME	是	最近保存时间	普通
edu_homework_draft	HomeworkDraft	expire_at	DATETIME	否	草稿过期时间	普通
edu_homework_draft	HomeworkDraft	client_type	VARCHAR(32)	否	最近保存端	普通
edu_homework_draft	HomeworkDraft	delete_reason	VARCHAR(255)	否	删除或过期原因	普通
edu_homework_draft	HomeworkDraft	conflict_status	VARCHAR(32)	是	无冲突/有冲突/已合并	普通
edu_homework_submit	HomeworkSubmit	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
edu_homework_submit	HomeworkSubmit	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
edu_homework_submit	HomeworkSubmit	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
edu_homework_submit	HomeworkSubmit	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
edu_homework_submit	HomeworkSubmit	created_by	BIGINT	是	创建人账号 ID	普通
edu_homework_submit	HomeworkSubmit	created_at	DATETIME	是	创建时间	普通
edu_homework_submit	HomeworkSubmit	updated_by	BIGINT	否	最后更新人账号 ID	普通
edu_homework_submit	HomeworkSubmit	updated_at	DATETIME	否	最后更新时间	普通
edu_homework_submit	HomeworkSubmit	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
edu_homework_submit	HomeworkSubmit	deleted_at	DATETIME	否	删除时间，未删除为空	普通
edu_homework_submit	HomeworkSubmit	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
edu_homework_submit	HomeworkSubmit	version	INT	是	乐观锁版本号，写操作必须校验	普通
edu_homework_submit	HomeworkSubmit	submit_no	VARCHAR(64)	是	提交编号，唯一	普通
edu_homework_submit	HomeworkSubmit	homework_id	BIGINT	是	作业 ID	普通
edu_homework_submit	HomeworkSubmit	student_id	BIGINT	是	学员 ID	普通
edu_homework_submit	HomeworkSubmit	answer_payload	JSON	是	最终答案	普通
edu_homework_submit	HomeworkSubmit	submit_status	VARCHAR(32)	是	待提交/已提交/已批改/需订正	普通
edu_homework_submit	HomeworkSubmit	submitted_at	DATETIME	否	提交时间	普通
stu_wrong_question_practice	WrongQuestionPractice	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
stu_wrong_question_practice	WrongQuestionPractice	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
stu_wrong_question_practice	WrongQuestionPractice	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
stu_wrong_question_practice	WrongQuestionPractice	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
stu_wrong_question_practice	WrongQuestionPractice	created_by	BIGINT	是	创建人账号 ID	普通
stu_wrong_question_practice	WrongQuestionPractice	created_at	DATETIME	是	创建时间	普通
stu_wrong_question_practice	WrongQuestionPractice	updated_by	BIGINT	否	最后更新人账号 ID	普通
stu_wrong_question_practice	WrongQuestionPractice	updated_at	DATETIME	否	最后更新时间	普通
stu_wrong_question_practice	WrongQuestionPractice	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
stu_wrong_question_practice	WrongQuestionPractice	deleted_at	DATETIME	否	删除时间，未删除为空	普通
stu_wrong_question_practice	WrongQuestionPractice	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
stu_wrong_question_practice	WrongQuestionPractice	version	INT	是	乐观锁版本号，写操作必须校验	普通
stu_wrong_question_practice	WrongQuestionPractice	practice_no	VARCHAR(64)	是	复练任务编号，唯一	普通
stu_wrong_question_practice	WrongQuestionPractice	student_id	BIGINT	是	学员 ID	普通
stu_wrong_question_practice	WrongQuestionPractice	course_id	BIGINT	否	课程 ID	普通
stu_wrong_question_practice	WrongQuestionPractice	source_question_ids	JSON	是	来源错题 ID 列表	普通
stu_wrong_question_practice	WrongQuestionPractice	practice_mode	VARCHAR(32)	是	一键 5 题复练/错题重组测试/知识点专项	普通
stu_wrong_question_practice	WrongQuestionPractice	question_count	INT	是	题目数量	普通
stu_wrong_question_practice	WrongQuestionPractice	practice_status	VARCHAR(32)	是	待练习/进行中/已完成/生成失败	普通
stu_wrong_question_practice	WrongQuestionPractice	result_snapshot	JSON	否	练习结果快照	普通
stu_portfolio_item	StudentPortfolioItem	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
stu_portfolio_item	StudentPortfolioItem	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
stu_portfolio_item	StudentPortfolioItem	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
stu_portfolio_item	StudentPortfolioItem	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
stu_portfolio_item	StudentPortfolioItem	created_by	BIGINT	是	创建人账号 ID	普通
stu_portfolio_item	StudentPortfolioItem	created_at	DATETIME	是	创建时间	普通
stu_portfolio_item	StudentPortfolioItem	updated_by	BIGINT	否	最后更新人账号 ID	普通
stu_portfolio_item	StudentPortfolioItem	updated_at	DATETIME	否	最后更新时间	普通
stu_portfolio_item	StudentPortfolioItem	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
stu_portfolio_item	StudentPortfolioItem	deleted_at	DATETIME	否	删除时间，未删除为空	普通
stu_portfolio_item	StudentPortfolioItem	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
stu_portfolio_item	StudentPortfolioItem	version	INT	是	乐观锁版本号，写操作必须校验	普通
stu_portfolio_item	StudentPortfolioItem	student_id	BIGINT	是	学员 ID	普通
stu_portfolio_item	StudentPortfolioItem	course_id	BIGINT	否	课程 ID	普通
stu_portfolio_item	StudentPortfolioItem	item_type	VARCHAR(32)	是	图片/音频/视频/作业/测评报告/课堂作品	普通
stu_portfolio_item	StudentPortfolioItem	title	VARCHAR(128)	是	作品标题	普通
stu_portfolio_item	StudentPortfolioItem	file_id	BIGINT	否	文件中心文件 ID	普通
stu_portfolio_item	StudentPortfolioItem	media_type	VARCHAR(32)	否	图片/音频/视频/PDF/链接	普通
stu_portfolio_item	StudentPortfolioItem	transcode_status	VARCHAR(32)	否	无需转码/转码中/成功/失败	普通
stu_portfolio_item	StudentPortfolioItem	teacher_comment_id	BIGINT	否	关联教师点评 ID	普通
stu_portfolio_item	StudentPortfolioItem	share_status	VARCHAR(32)	是	不可分享/可分享/已分享/分享失效	普通
pts_account	PointsAccount	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
pts_account	PointsAccount	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
pts_account	PointsAccount	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
pts_account	PointsAccount	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
pts_account	PointsAccount	created_by	BIGINT	是	创建人账号 ID	普通
pts_account	PointsAccount	created_at	DATETIME	是	创建时间	普通
pts_account	PointsAccount	updated_by	BIGINT	否	最后更新人账号 ID	普通
pts_account	PointsAccount	updated_at	DATETIME	否	最后更新时间	普通
pts_account	PointsAccount	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
pts_account	PointsAccount	deleted_at	DATETIME	否	删除时间，未删除为空	普通
pts_account	PointsAccount	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
pts_account	PointsAccount	version	INT	是	乐观锁版本号，写操作必须校验	普通
pts_account	PointsAccount	student_id	BIGINT	是	学员 ID	普通
pts_account	PointsAccount	available_points	INT	是	可用积分	普通
pts_account	PointsAccount	frozen_points	INT	是	冻结积分	普通
pts_account	PointsAccount	total_earned_points	INT	是	累计获得积分	普通
pts_account	PointsAccount	total_used_points	INT	是	累计消耗积分	普通
pts_lock	PointsLock	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
pts_lock	PointsLock	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
pts_lock	PointsLock	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
pts_lock	PointsLock	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
pts_lock	PointsLock	created_by	BIGINT	是	创建人账号 ID	普通
pts_lock	PointsLock	created_at	DATETIME	是	创建时间	普通
pts_lock	PointsLock	updated_by	BIGINT	否	最后更新人账号 ID	普通
pts_lock	PointsLock	updated_at	DATETIME	否	最后更新时间	普通
pts_lock	PointsLock	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
pts_lock	PointsLock	deleted_at	DATETIME	否	删除时间，未删除为空	普通
pts_lock	PointsLock	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
pts_lock	PointsLock	version	INT	是	乐观锁版本号，写操作必须校验	普通
pts_lock	PointsLock	lock_no	VARCHAR(64)	是	锁库编号，唯一	普通
pts_lock	PointsLock	student_id	BIGINT	是	学员 ID	普通
pts_lock	PointsLock	gift_sku_id	BIGINT	是	礼品 SKU ID，关联物料库存	普通
pts_lock	PointsLock	quantity	INT	是	锁定数量	普通
pts_lock	PointsLock	points_amount	INT	是	锁定积分	普通
pts_lock	PointsLock	lock_status	VARCHAR(32)	是	锁定中/已确认/已释放/已过期	普通
pts_lock	PointsLock	expire_at	DATETIME	是	锁库过期时间	普通
pts_order	PointsOrder	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
pts_order	PointsOrder	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
pts_order	PointsOrder	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
pts_order	PointsOrder	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
pts_order	PointsOrder	created_by	BIGINT	是	创建人账号 ID	普通
pts_order	PointsOrder	created_at	DATETIME	是	创建时间	普通
pts_order	PointsOrder	updated_by	BIGINT	否	最后更新人账号 ID	普通
pts_order	PointsOrder	updated_at	DATETIME	否	最后更新时间	普通
pts_order	PointsOrder	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
pts_order	PointsOrder	deleted_at	DATETIME	否	删除时间，未删除为空	普通
pts_order	PointsOrder	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
pts_order	PointsOrder	version	INT	是	乐观锁版本号，写操作必须校验	普通
pts_order	PointsOrder	order_no	VARCHAR(64)	是	积分订单编号，唯一	普通
pts_order	PointsOrder	student_id	BIGINT	是	学员 ID	普通
pts_order	PointsOrder	gift_sku_id	BIGINT	是	礼品 SKU ID，关联物料	普通
pts_order	PointsOrder	lock_id	BIGINT	否	积分锁库记录 ID	普通
pts_order	PointsOrder	points_amount	INT	是	消耗积分	普通
pts_order	PointsOrder	write_off_code_id	BIGINT	否	核销码 ID	普通
pts_order	PointsOrder	order_status	VARCHAR(32)	是	待领取/已核销/已取消/售后中	普通
pts_write_off_code	PointsWriteOffCode	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
pts_write_off_code	PointsWriteOffCode	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
pts_write_off_code	PointsWriteOffCode	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
pts_write_off_code	PointsWriteOffCode	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
pts_write_off_code	PointsWriteOffCode	created_by	BIGINT	是	创建人账号 ID	普通
pts_write_off_code	PointsWriteOffCode	created_at	DATETIME	是	创建时间	普通
pts_write_off_code	PointsWriteOffCode	updated_by	BIGINT	否	最后更新人账号 ID	普通
pts_write_off_code	PointsWriteOffCode	updated_at	DATETIME	否	最后更新时间	普通
pts_write_off_code	PointsWriteOffCode	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
pts_write_off_code	PointsWriteOffCode	deleted_at	DATETIME	否	删除时间，未删除为空	普通
pts_write_off_code	PointsWriteOffCode	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
pts_write_off_code	PointsWriteOffCode	version	INT	是	乐观锁版本号，写操作必须校验	普通
pts_write_off_code	PointsWriteOffCode	points_order_id	BIGINT	是	积分兑换订单 ID	普通
pts_write_off_code	PointsWriteOffCode	write_off_code	VARCHAR(64)	是	核销码，唯一	普通
pts_write_off_code	PointsWriteOffCode	code_type	VARCHAR(32)	是	二维码/条形码/数字码	普通
pts_write_off_code	PointsWriteOffCode	expire_at	DATETIME	是	核销码有效期	普通
pts_write_off_code	PointsWriteOffCode	refresh_count	INT	是	刷新次数	普通
pts_write_off_code	PointsWriteOffCode	write_off_status	VARCHAR(32)	是	待核销/已核销/已过期/已作废	普通
pts_write_off_code	PointsWriteOffCode	brightness_hint	TINYINT	是	端侧是否建议自动调高亮度	普通
pts_after_sales	PointsRedemptionAfterSales	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
pts_after_sales	PointsRedemptionAfterSales	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
pts_after_sales	PointsRedemptionAfterSales	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
pts_after_sales	PointsRedemptionAfterSales	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
pts_after_sales	PointsRedemptionAfterSales	created_by	BIGINT	是	创建人账号 ID	普通
pts_after_sales	PointsRedemptionAfterSales	created_at	DATETIME	是	创建时间	普通
pts_after_sales	PointsRedemptionAfterSales	updated_by	BIGINT	否	最后更新人账号 ID	普通
pts_after_sales	PointsRedemptionAfterSales	updated_at	DATETIME	否	最后更新时间	普通
pts_after_sales	PointsRedemptionAfterSales	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
pts_after_sales	PointsRedemptionAfterSales	deleted_at	DATETIME	否	删除时间，未删除为空	普通
pts_after_sales	PointsRedemptionAfterSales	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
pts_after_sales	PointsRedemptionAfterSales	version	INT	是	乐观锁版本号，写操作必须校验	普通
pts_after_sales	PointsRedemptionAfterSales	after_sales_no	VARCHAR(64)	是	售后编号，唯一	普通
pts_after_sales	PointsRedemptionAfterSales	points_order_id	BIGINT	是	积分订单 ID	普通
pts_after_sales	PointsRedemptionAfterSales	request_type	VARCHAR(32)	是	取消/退积分/补发/异常核销	普通
pts_after_sales	PointsRedemptionAfterSales	request_reason	VARCHAR(512)	是	申请原因	普通
pts_after_sales	PointsRedemptionAfterSales	handle_result	VARCHAR(512)	否	处理结果	普通
pts_after_sales	PointsRedemptionAfterSales	handle_status	VARCHAR(32)	是	待处理/已处理/已驳回	普通
stu_desktop_sync_task	DesktopSyncTask	id	BIGINT	是	主键，雪花或号段生成，禁止复用	普通
stu_desktop_sync_task	DesktopSyncTask	tenant_id	BIGINT	是	集团/租户隔离字段，所有查询必须带租户上下文	普通
stu_desktop_sync_task	DesktopSyncTask	org_id	BIGINT	否	所属组织，集团级或公共配置为空	普通
stu_desktop_sync_task	DesktopSyncTask	campus_id	BIGINT	否	所属校区，跨校区或总部级数据为空	普通
stu_desktop_sync_task	DesktopSyncTask	created_by	BIGINT	是	创建人账号 ID	普通
stu_desktop_sync_task	DesktopSyncTask	created_at	DATETIME	是	创建时间	普通
stu_desktop_sync_task	DesktopSyncTask	updated_by	BIGINT	否	最后更新人账号 ID	普通
stu_desktop_sync_task	DesktopSyncTask	updated_at	DATETIME	否	最后更新时间	普通
stu_desktop_sync_task	DesktopSyncTask	is_deleted	TINYINT	是	是否已删除，0 未删除，1 已删除	普通
stu_desktop_sync_task	DesktopSyncTask	deleted_at	DATETIME	否	删除时间，未删除为空	普通
stu_desktop_sync_task	DesktopSyncTask	deleted_by	BIGINT	否	删除人账号 ID，未删除为空	普通
stu_desktop_sync_task	DesktopSyncTask	version	INT	是	乐观锁版本号，写操作必须校验	普通
stu_desktop_sync_task	DesktopSyncTask	sync_batch_no	VARCHAR(64)	是	同步批次号，唯一	普通
stu_desktop_sync_task	DesktopSyncTask	student_id	BIGINT	是	学员 ID	普通
stu_desktop_sync_task	DesktopSyncTask	device_id	VARCHAR(128)	是	Tauri 桌面端设备 ID	普通
stu_desktop_sync_task	DesktopSyncTask	sync_payload	JSON	是	学习进度、播放位置、作业草稿等同步内容	普通
stu_desktop_sync_task	DesktopSyncTask	retry_count	INT	是	已重试次数	普通
stu_desktop_sync_task	DesktopSyncTask	next_retry_at	DATETIME	否	下次静默重试时间	普通
stu_desktop_sync_task	DesktopSyncTask	strong_prompt	TINYINT	是	是否已触发强提示	普通
stu_desktop_sync_task	DesktopSyncTask	sync_status	VARCHAR(32)	是	待同步/同步中/成功/失败/冲突	普通
stu_desktop_sync_task	DesktopSyncTask	failed_reason	VARCHAR(512)	否	失败原因	普通

数据表与对象映射

表名	对象	用途	完整字段	索引建议
stu_account	StudentAccount	学员端独立账号	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,必填)、account_no(VARCHAR(64),必填)、login_name(VARCHAR(64),必填)、student_id(BIGINT)、account_type(VARCHAR(32),必填)、mobile(VARCHAR(32))、wechat_openid(VARCHAR(128))、password_hash(VARCHAR(255))、login_status(VARCHAR(32),必填)、activated_at(DATETIME)、cancel_request_status(VARCHAR(32))、last_login_at(DATETIME)	uk_account_no、uk_login_name、idx_student、idx_mobile_status
stu_account_registration	StudentAccountRegistration	非学员手机号自主注册记录	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,必填)、register_no(VARCHAR(64),必填)、mobile(VARCHAR(32),必填)、sms_verify_id(VARCHAR(64),必填)、student_name(VARCHAR(64))、password_set_status(VARCHAR(32),必填)、agreement_version(VARCHAR(32),必填)、register_status(VARCHAR(32),必填)、linked_account_id(BIGINT)	uk_register_no、idx_mobile_status
stu_session_selection	StudentSessionSelection	当前上课学员选择记录	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,必填)、account_id(BIGINT,必填)、selected_student_id(BIGINT,必填)、source_channel(VARCHAR(32),必填)、remember_last(TINYINT,必填)、selected_at(DATETIME,必填)、selection_status(VARCHAR(32),必填)、last_sync_result(VARCHAR(512))	idx_account_status、idx_selected_student
stu_device_session	StudentDeviceSession	学员端设备登录会话	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,必填)、account_id(BIGINT,必填)、student_id(BIGINT)、device_id(VARCHAR(128),必填)、client_type(VARCHAR(32),必填)、app_version(VARCHAR(32))、login_at(DATETIME,必填)、last_active_at(DATETIME)、session_status(VARCHAR(32),必填)	idx_account_client、uk_device_active
stu_learning_profile	LearningProfile	学员学习进度档案	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,必填)、course_id(BIGINT,必填)、progress_percent(DECIMAL(6,2),必填)、ability_tags(JSON)、last_active_at(DATETIME)、profile_snapshot(JSON)	uk_student_course、idx_progress
stu_learning_task	LearningTask	学员学习任务	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,必填)、task_no(VARCHAR(64),必填)、student_id(BIGINT,必填)、task_type(VARCHAR(32),必填)、biz_id(BIGINT,必填)、deadline_at(DATETIME)、complete_status(VARCHAR(32),必填)	uk_task_no、idx_student_status
edu_homework_draft	HomeworkDraft	学员作业草稿箱	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,必填)、draft_no(VARCHAR(64),必填)、homework_id(BIGINT,必填)、student_id(BIGINT,必填)、draft_status(VARCHAR(32),必填)、answer_snapshot(JSON,必填)、attachment_temp_ids(JSON)、auto_save_version(INT,必填)、last_saved_at(DATETIME,必填)、expire_at(DATETIME)、client_type(VARCHAR(32))、delete_reason(VARCHAR(255))、conflict_status(VARCHAR(32),必填)	uk_homework_student、idx_student_status、idx_expire
edu_homework_submit	HomeworkSubmit	学员作业提交	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_no(VARCHAR(64),必填)、homework_id(BIGINT,必填)、student_id(BIGINT,必填)、answer_payload(JSON,必填)、submit_status(VARCHAR(32),必填)、submitted_at(DATETIME)	uk_submit_no、idx_homework_student
stu_wrong_question_practice	WrongQuestionPractice	错题复练与重组测试	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,必填)、practice_no(VARCHAR(64),必填)、student_id(BIGINT,必填)、course_id(BIGINT)、source_question_ids(JSON,必填)、practice_mode(VARCHAR(32),必填)、question_count(INT,必填)、practice_status(VARCHAR(32),必填)、result_snapshot(JSON)	uk_practice_no、idx_student_status
stu_portfolio_item	StudentPortfolioItem	学习档案作品集	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,必填)、course_id(BIGINT)、item_type(VARCHAR(32),必填)、title(VARCHAR(128),必填)、file_id(BIGINT)、media_type(VARCHAR(32))、transcode_status(VARCHAR(32))、teacher_comment_id(BIGINT)、share_status(VARCHAR(32),必填)	idx_student_type、idx_course
pts_account	PointsAccount	学员积分账户	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,必填)、available_points(INT,必填)、frozen_points(INT,必填)、total_earned_points(INT,必填)、total_used_points(INT,必填)	uk_student
pts_lock	PointsLock	积分兑换锁库记录	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,必填)、lock_no(VARCHAR(64),必填)、student_id(BIGINT,必填)、gift_sku_id(BIGINT,必填)、quantity(INT,必填)、points_amount(INT,必填)、lock_status(VARCHAR(32),必填)、expire_at(DATETIME,必填)	uk_lock_no、idx_student_status、idx_expire
pts_order	PointsOrder	积分商城兑换订单	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,必填)、order_no(VARCHAR(64),必填)、student_id(BIGINT,必填)、gift_sku_id(BIGINT,必填)、lock_id(BIGINT)、points_amount(INT,必填)、write_off_code_id(BIGINT)、order_status(VARCHAR(32),必填)	uk_order_no、idx_student_status、idx_lock
pts_write_off_code	PointsWriteOffCode	积分兑换线下核销码	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,必填)、points_order_id(BIGINT,必填)、write_off_code(VARCHAR(64),必填)、code_type(VARCHAR(32),必填)、expire_at(DATETIME,必填)、refresh_count(INT,必填)、write_off_status(VARCHAR(32),必填)、brightness_hint(TINYINT,必填)	uk_write_off_code、idx_order_status、idx_expire
pts_after_sales	PointsRedemptionAfterSales	积分兑换售后	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,必填)、after_sales_no(VARCHAR(64),必填)、points_order_id(BIGINT,必填)、request_type(VARCHAR(32),必填)、request_reason(VARCHAR(512),必填)、handle_result(VARCHAR(512))、handle_status(VARCHAR(32),必填)	uk_after_sales_no、idx_order_status
stu_desktop_sync_task	DesktopSyncTask	学员桌面端学习同步任务	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,必填)、sync_batch_no(VARCHAR(64),必填)、student_id(BIGINT,必填)、device_id(VARCHAR(128),必填)、sync_payload(JSON,必填)、retry_count(INT,必填)、next_retry_at(DATETIME)、strong_prompt(TINYINT,必填)、sync_status(VARCHAR(32),必填)、failed_reason(VARCHAR(512))	uk_sync_batch_no、idx_student_status、idx_retry

12 · 状态机与业务规则