feat(courseware,docs): 完善课件传输与岛编辑并统一全仓文档

- 增加课件上传、班级可见范围、设备补收与传输进度
- 整合自定义灵动岛编辑器和相关客户端交互
- 同步三端契约、数据库迁移、部署配置与隔离回归
- 按源码统一文档与官网说明，移除过时任务书和审查记录
- 保持产品版本为 1.4.0

docs/get-started/setup-class.md

@@ -1,71 +1,37 @@
 ---
 title: 建班级、排课表
-description: 建第一个班级、配班级账号、加学生与老师、排课表——后面所有功能的前提。
+description: 班级、名单、任课关系与日课表的首次配置。
 ---
 
 # 建班级、排课表
 
-后面所有功能（发通知、布置作业、录成绩）都挂在**班级**上，所以先把班级建出来。
+## 创建班级
 
-## 1. 建班级（仅管理员）
+管理员在“班级管理”填写入学年份、班号、年级等资料；班级名称按年份和班号生成，如“2026级1班”。
+设置班主任、学期周数及班级凭据；班主任可暂空，但发布依赖教师归属的内容前需先完成配置。
+班级周数默认 20，受全校可配置上限限制，全校默认上限 30、范围 1–60。
+保存班级码与密码，教室客户端用它登录；已读和作业状态操作代表全班。
 
-Web 管理端 → **班级管理** → 「新建班级」：
+## 录入学生与教师
 
-| 字段     | 说明                                                                    |
-| -------- | ----------------------------------------------------------------------- |
-| 班级名称 | 例如「高二(3)班」                                                       |
-| 年级     | 用于分组与统计                                                          |
-| 班主任   | 从教师账号里选，默认是自己；之后随时可在班级详情顶部「更换班主任」改    |
-| 学期周数 | 默认 20，**上限 30**。课表的周次选择与周次范围都以它为准                |
-| 班级码   | 保存时自动生成（字母数字 4–16 位，存大写），可以改成好记的，例如 `G203` |
-| 班级密码 | 新建班级时的初始密码就是它 —— 学生在教室机器上要用这个登录              |
+学生是名单，填写学号和姓名，不创建账号、密码或自动登录名。
+学号 1–32 位字母/数字/._-，不能复用；支持管理员表格导入，班主任有名单管理权限时可维护本班。
+教师使用工号账号，管理员在教师管理录入或导入。
+在班级详情按科目配置任课老师：任课关系只存 Course，决定该科作业/成绩写权限。
+班主任不任教某科就不能改该科内容，详见[班级与人员](../app/classes.md)。
 
-> **班级码 + 班级密码 = ClassHelper 班级端的登录凭据。** ClassHelper 班级端没有个人账号，一台教室机器用班级账号登录后，
-> 那台机器上的「已读 / 完成」是**代全班**操作的。
->
-> 学期周数只有管理员能改：它决定"现在是第几教学周"，乱改会让课表的周次过滤和上课时段判定错位。
+## 配置作息与日课表
 
-## 2. 加学生（仅管理员）
+先在“时间表与课表编辑”维护时间表的上课/课间等时间点，再创建班级日课表并为时间点选择课程。
+按星期、周次范围和 1–9 周轮换设置启用规则，也可复制、临时换课或预定某天。
+时间表写入需 timetable:manage；日课表写入需 schedule:write 并通过本班班主任/管理员检查。
+可以从 ClassIsland 完整 JSON 离线导入作息、日课表、群组与预定，见[导入](../app/imports.md)。
 
-**学生管理** → 「新建」或「导入名单」：
+## 校对周次与提醒
 
-- **单个新建**：填姓名即可，登录名会自动生成。
-- **导入名单**：下载模板（列是 `学号 / 姓名 / 班级 / 性别 / 家长手机号`，学生**不是账号**，没有密码列），填好上传。
-  用户名要匹配 `^[A-Za-z0-9_.-]{3,32}$`；重复用户名在 `append` 模式下跳过、`upsert` 模式下更新姓名。
-  用户名已经属于某个教师 / 管理员账号时，这一行会进错误列表，不会覆盖别人的账号。
+管理员在“学期周次”设置开学日、全校上限和逐周日期，班级可以有独立区间。
+在周视图和客户端今天时间轴核对当前课程、下一节、上下课时刻。
+经典岛普通通知上课暂存、普通叫人保留可点胶囊、紧急消息立即展开；自定义常驻岛先提示铃铛，主动点击查看。
+验证应使用独立测试班级，详见[验收](../dev/testing.md)，不要给业务班级发送测试通知。
 
-学生的用途是：**成绩、未交名单、叫人、已读记录都按名单记录**。所以名单不全，这几项就不准。
-
-## 3. 加科任老师
-
-教师的**录入**只有管理员能做（**教师管理**页，支持单个录入与导入名单）。班级层面的**分配**在班级详情里：
-在「班级详情 → 任课老师」里给某位老师配一门课，他就能看到这个班，并**只能改自己任教科目**的作业与成绩。
-
-角色与可见范围见[班级、学生与教师](../app/classes.md)与[角色与权限](../dev/permissions.md)。
-
-## 4. 排课表
-
-**课表管理** → 选中班级 → 「新增课表」：
-
-- **科目**下拉直接列出全校统一的 18 科目录（语文 / 数学 / 英语 / 政治 / 历史 / 物理 / 化学 / 地理 /
-  生物 / 信息技术 / 体育 / 美术 / 音乐 / 班会 / 早读 / 晚读 / 通用技术 / 听力）。
-  选中一个该班还没有的科目时，前端会**自动为该班建同名课程**，不用先去把科目的建一遍。
-- 填星期、开始 / 结束时间、周次范围（第几周到第几周）、单双周（每周 / 单周 / 双周）。
-- 一节课**必须同时有开始时间和结束时间** —— 「上课时段」的判定就是拿这两个时间比对的。
-
-排完在**课表管理**里能看到周视图（7 列），客户端那边则多一个「今天」时间轴视图。
-
-### 从 ClassIsland 导入更省事
-
-如果教室里已经在用 ClassIsland，直接导入它的档案 JSON 就行：课表、节次时间、单双周都会一起进来，
-不用排两遍。见[表格与课表导入](../app/imports.md)。
-
-## 5. 确认「上课时段」判定是对的
-
-ClassHelper有一整套「上课时段策略」：普通通知在上课时段只进队列、下课自动补弹，紧急通知与叫人则立刻弹。
-这套判定完全基于课表，所以**课表排错，提醒就会在该弹的时候不弹**。
-
-排完课之后建议立刻验一下：在**通知发布**页选这个班，随便发一条普通通知，
-看客户端是不是在课间弹出来、上课时是不是安静地收着。规则详见[通知与提醒](../app/notifications.md)。
-
-下一步：[装 ClassHelper 班级端](client.md)。
+下一步：[装班级端](client.md)。