Roles & Permissions · 角色与权限

洞见给谁用：四类角色，四套可见范围

产品关闭了公开注册。学生与家长凭一次性邀请码开通，教师由管理员建号后调整角色；所有新账号开通时即写入默认模型授权，并被置为「待签同意书」状态。[S3][S4]

角色能力矩阵

开通与首登：邀请码与同意书

邀请码开通

• 学生与家长账号由管理员生成邀请码，一次性使用、默认 72 小时有效，可手工作废。[S3]
• 用户通过含邀请码的注册链接设置登录名与密码（服务端要求至少 8 位）。[S3]
• 学生也可用教师提供的 6 位班级加入码自助入班，加入码接口有限流保护。[S3][S5]
• 自助注册默认关闭，仅第一个用户可自助注册；此后账号只能由管理员开通。[S3][S4]

同意书闸门

邀请码兑换与管理员建号走同一套初始化流程：写入默认模型授权，并标记为「待签同意书」。学生首次进入学习面前必须签署三份文件（v1）：《监护人知情同意书》《隐私政策》《数据留存与删除政策》。[S3][S4]

• 未签署时，学习面接口统一返回 403，detail 为 consent_required。[S4]
• 家长账号不进学习面，兑换后直接进入家长端；其绑定页仍按同一版本勾选同意。家长访问学习页同样返回 403，这是预期行为。[S3][S4]
• 该状态只对新开通的账号写入，修复前已存在的账号不会被重新弹窗。[S3]

默认模型授权

管理员手工保存的授权优先于默认值，不会被后续登录覆盖；只有授权被清空时对话才会提示缺少模型分配。[S3]

教师端：聚合学情，不读对话

教师端页面标题为「教师端 · 班级学习概览」，只能看到聚合数据与学生个体指标。[S3]

家长端：先确认绑定，再看周报

家长提交孩子的登录账号与关系并发起绑定，必须由学生本人在「我的监护人」中确认后，家长才能看到数据；确认前页面明确提示看不到任何学习数据。[S3]

• 周报指标：有效学习时长、学习天数、完成题目、正确率、完成讲解、完成实验，另有薄弱知识点、错因分布、每日有效学习柱状图与历史周报。[S3]
• 数据来源：周报全部由服务端事件聚合，不是模型生成的文字；同一账号同一天的数据在家长端、管理员看板与学生端应完全一致。[S3]
• 时长口径：单次事件按 120 秒截断，单日上限 45 分钟。这是统计口径，不是对学习时长的要求。[S3]
• 可撤销：学生可随时在家长端解除授权。[S3]

管理员：开通、分配与用量

• 账号：建号、改角色、删除账号；删除会级联清理学习事件、实验进度、诊断计划、周报与班级成员关系，并移除个人工作区，家长绑定关系做匿名化保留。[S3]
• 邀请码：按角色批量生成，显示剩余有效期与状态，可作废。[S3]
• 用量看板：今日活跃、有效学习时长、完成实验、诊断次数、周报生成、模型调用与错误率；下方为学生明细与配额。[S3]
• 口径统一：看板数字由服务端统一聚合接口计算，与家长端、学生端同源。[S3]