docs(audit): 同步安全边界并整理全仓审计入口
This commit is contained in:
1 parent
3a7aed0800
commit
8bd5bcb9ff
17 files changed
+319
-30
No files matched your search
@@ -0,0 +1,26 @@
|
||||
---
|
||||
title: AI 助手
|
||||
description: 将自然语言解析成待确认动作,核对后通过现有业务接口发布。
|
||||
---
|
||||
|
||||
# AI 助手
|
||||
|
||||
AI 助手位于 Web 管理端工作台。输入要发布的作业、通知或叫人请求,助手会展示解析出的班级、科目、内容与提醒级别;核对并确认后才发布。内容仍通过原有业务接口,继续校验当前账号的功能权限、班级范围及任课关系。
|
||||
|
||||
## 配置与使用
|
||||
|
||||
管理员在大模型设置中开启助手,选择服务地址和模型并保存 API Key。密钥加密存储,读取设置只返回是否已配置及末尾提示,不返回完整密钥。修改服务端 JWT 密钥后,原有加密 Key 需要重新配置。
|
||||
|
||||
1. 在助手页面描述操作与目标班级,等待解析预览。
|
||||
2. 核对班级、科目、标题、正文和提醒级别;有歧义时修改后重新解析。
|
||||
3. 点击确认发布。紧急通知在上课期间仍需完成额外确认;批量操作逐班返回结果。
|
||||
|
||||
解析成功不代表已经发布,也不代表拥有对应班级或科目的写权限。缺少任课关系时,请由管理员配置;助手不能替用户建立授权。
|
||||
|
||||
## 离线示例与审计
|
||||
|
||||
`mock` 提供确定性的离线示例解析,用于自动化验收,不访问外网;预览会提示当前为示例结果。真实模型调用失败时页面保留可操作的错误说明,不会自动改用发布接口。
|
||||
|
||||
有管理权限的账号可查看助手审计。审计记录解析意图和状态,不代替作业、通知或叫人的最终发布结果;请结合对应业务页面核对。
|
||||
|
||||
相关规则:[作业](homeworks.md)、[通知](notifications.md)、[叫人](calls.md)、[角色与权限](../dev/permissions.md)。
|
||||
@@ -32,6 +32,8 @@ Student 存学号、姓名、班级、性别、家长电话和状态,没有密
|
||||
科任关系唯一存于 Course(classId, name, teacherId),分配任课关系由班级管理权限及服务端断言限制。
|
||||
班主任不任教某科就不能修改该科作业/成绩;科任老师有相应权限时可以管理自己任教科目。
|
||||
|
||||
新建科目同时建立任课关系,只对管理员开放。教师需要增加科目或改变任课老师时,请联系管理员;年级、部或全校课表维护范围不能用来给自己任课。
|
||||
|
||||
删除教师前,服务端检查其负责的班级、任课课程、发布过的作业/通知与所属课件;仍有业务内容则返回冲突,避免级联丢失。
|
||||
教师本人改密码、管理员修改教师密码、班级账号密码是不同入口;学生没有密码接口。
|
||||
|
||||
|
||||
+3
-1
@@ -6,11 +6,13 @@ description: 录入、按学号查询、排名与关闭个人查询后的集体
|
||||
# 成绩
|
||||
|
||||
Web 管理端支持单条、批量和表格导入成绩;记录通过 Grade.studentId 关联学生名单。
|
||||
科目来自班级课程与共享科目目录,分数、总分和等级按录入规则校验。
|
||||
科目来自班级课程与共享科目目录,分数、总分和等级按录入规则校验。新增科目及任课关系由管理员配置。
|
||||
成绩写入需 grade:write 或相应导入权限,并通过班级和科目检查:
|
||||
管理员可管理,教师只能编辑自己任课科目,无科目内容按班主任规则;班级端不能写成绩。
|
||||
表格导入另有管理员/本班班主任门槛,班主任也只能导入符合科目权限的行;它与单条/批量录入的准入不同。
|
||||
|
||||
整班批量录入在同一事务中校验学生、授权并写入成绩;任意一行无效或写入失败时整批回滚,不留下部分成绩。等级批量修改按每个班级与科目组合独立检查授权。
|
||||
|
||||
## 查看、排名与隐私
|
||||
|
||||
班级客户端可显示本班考试、成绩总览、等级分布,以及按学号查询明细。
|
||||
|
||||
@@ -10,6 +10,7 @@ description: ClassHelper每一项功能怎么用:课表、作业、通知、
|
||||
|
||||
| 页面 | 讲什么 |
|
||||
| --------------------------------- | ---------------------------------------------------------- |
|
||||
| [AI 助手](assistant.md) | 自然语言解析、核对确认、业务权限与离线示例 |
|
||||
| [课表](schedules.md) | 周视图与「今天」时间轴、单双周、学期周数、课表来源 |
|
||||
| [课件](courseware.md) | 上传、班级可见范围、推送与逐设备接收 |
|
||||
| [作业](homeworks.md) | 按所属日期归类、看板与全屏看板、教室机器录入、未交名单 |
|
||||
|
||||
@@ -22,6 +22,8 @@ Web 管理端统一从「教学事务 → 课表档案」查看周课表并编
|
||||
|
||||
时间表保存时间点:上课、课间、分割线、行动;日课表引用时间表,每节课程通过外键关联时间点。
|
||||
可以维护多套班级作息或共享作息、复制日课表、调整课程、配置启用规则和群组。
|
||||
|
||||
新增科目会建立任课关系,仅管理员可执行;课表维护者可以使用已配置的科目排课,需要新增或更换任课老师时联系管理员。
|
||||
时间点排序不会改变课程关联。行动配置当前保存数据,不执行外部动作。
|
||||
|
||||
日课表按星期、周次范围和轮换规则启用,支持 1–9 周轮换;单双周是 2 周轮换的特例,第 1 教学周为单周。
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
- name: 应用帮助
|
||||
href: index.md
|
||||
- name: AI 助手
|
||||
href: assistant.md
|
||||
- name: 课表
|
||||
href: schedules.md
|
||||
- name: 作业
|
||||
|
||||
Reference in new issue
Block a user