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

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

docs/app/schedules.md

@@ -1,70 +1,39 @@
 ---
 title: 课表
-description: 周课表与「今天」时间轴、单双周、学期周数、课表来源，以及上课时段是怎么判定的。
+description: 日课表、共享作息、轮换、临时换课和教学周。
 ---
 
 # 课表
 
-课表不只是"给学生们看看"的表格 —— **「上课时段」的判定完全基于它**。
-课表排错，提醒就会在该弹的时候不弹。所以这一页值得读完。
+Web 管理端可查看周课表并编辑时间表与日课表，客户端提供“今天”时间轴和“本周”视图。
+上课状态、灵动岛课程提醒和紧急通知确认共用服务端的课表判定。
 
-## 两个视图
+## 日课表与时间表
 
-| 视图           | 在哪                                      | 内容                                                     |
-| -------------- | ----------------------------------------- | -------------------------------------------------------- |
-| **周视图**     | Web 端「课表管理」、客户端「课表 → 本周」 | 节次 × 星期 的 7 列表格                                  |
-| **今天时间轴** | 客户端「课表 → 今天」                     | 大时钟 + 当前状态卡 + 时间轴（已结束 / 正在上 / 下一节） |
+时间表保存时间点：上课、课间、分割线、行动；日课表引用时间表，每节课程通过外键关联时间点。
+可以维护多套班级作息或共享作息、复制日课表、调整课程、配置启用规则和群组。
+时间点排序不会改变课程关联。行动配置当前保存数据，不执行外部动作。
 
-「今天」时间轴是客户端默认打开的那一屏：
+日课表按星期、周次范围和轮换规则启用，支持 1–9 周轮换；单双周是 2 周轮换的特例，第 1 教学周为单周。
+可以预定某天使用某张表，临时换课/叠加层保留原表。相同日期的最终启用选择由服务端唯一解析器完成。
 
-- **大时钟**：时:分（大字）+ 秒（小字），下面一行是日期 / 星期 / 第 N 教学周。
-- **当前状态卡**：「正在上 XXX」+ 时段地点 + **距下课 X 分钟**；没课时显示"今天的课都上完了"或"今天没有课程安排"。
-- **时间轴**：左侧时间栏（开始 / 结束）+ 竖向轨道与节点 + 右侧课卡。已结束的置灰、
-  正在上的用强调色实底 + 进度条 + 距下课倒计时、下一节用橙色标记 + "还有多久开始"。
+## 教学周
 
-## 单双周
+班级有自己的学期周数；全校上限由“学期周次”设置，默认 30、可设 1–60，班级不能超过该上限。
+默认班级周数为 20。管理员可在界面修改全校开学日和逐周起止区间，班级可有独立设置。
+计算优先使用班级逐周区间、再全校区间；无适用区间时按开学日线性计算。
+开学日解析还会参考第 1 周起点，环境变量 TERM_START_DATE 是兜底，具体顺序见 `lib/term.ts`。
 
-一门课可以设成**每周**（默认）、**单周**或**双周**。判定口径是 **第 1 周 = 单周**。
+## 上课状态与提醒
 
-从 ClassIsland 导入时，`WeekCountDiv`（`0=每周 / 1=单周 / 2=双周`）会换算成这套 `ALL / ODD / EVEN`。
-**3 周及以上的轮换没法用单双周表达**，导入时会给出 warning 并按"每周"处理 ——
-如果学校里真的是三周轮换，目前只能用两份课表 + 手工切换的方式绕过。
+`GET /api/schedules/current?classId=<id>&at=<ISO时间>` 返回 inClass/current/next/week/serverTime 等状态；at 用于诊断。
+`/schedules` 是新模型的兼容门面，旧 Schedule 只保留迁移审计记录。
+经典岛普通通知上课暂存、下课补弹；普通叫人保留可点击胶囊，紧急消息立即展开。
+自定义常驻岛先显示铃铛，由用户主动查看。紧急通知在课堂发布仍需服务端二次确认。
 
-## 学期周数
+## 权限与导入
 
-每个班有自己的**学期周数**（`Class.termWeeks`，默认 20，**上限 30**），只有管理员能改。
-
-它决定三件事：课表的周次下拉能选到第几周、`weekEnd` 的默认值、以及"现在是第几教学周"。
-周次换算的起点是服务端 `.env` 里的 `TERM_START_DATE`（当学期第 1 教学周的周一）。
-
-> **`TERM_START_DATE` 设错，整套周次都错。** 它不在界面上改，要改 `.env` 后重启服务端。
-> 上限三处必须一致（`MAX_TERM_WEEK`、周次校验、班级设置），曾经出现过"班级能设到 40 周、
-> 而课表只到 30 周"的错位。
-
-## 上课时段是怎么判定的
-
-服务端有一个接口专门回答"这个班现在是不是在上课"：
-
-```
-GET /api/schedules/current?classId=<班级 id>[&at=<ISO 时间>]
-```
-
-返回 `{ inClass, current, next, week, serverTime }`。`at` 参数可以覆盖判定时刻，用来联调与测试。
-
-判定结果被用在三处，规则完全一致：
-
-1. 客户端灵动岛：上课时段普通通知**不显示**（窗口直接隐藏）并进队列，下课自动补弹；
-2. 服务端发布接口：上课时段发紧急通知会被拦（`409 URGENT_DURING_CLASS`），确认后放行；
-3. Web 端：提交紧急通知前先查一次状态，命中就弹全屏二次确认。
-
-## 课表来源
-
-课表由管理端维护，支持手工录入与离线 JSON 导入。升级会保留旧联动课表并将其来源归为 `manual`。
-
-## 排课 / 改课 / 导入
-
-- 手工排课在 **课表管理**（管理员 / 本班班主任）。科目下拉是全校统一的 18 科目录，
-  选中一个该班还没有的科目会自动建课。
-- 从 ClassIsland 档案导入最省事，课表、节次时间、单双周会一起进来，
-  见[表格与课表导入](imports.md)。
-- 课表变更后会广播 `schedule:updated`，客户端与灵动岛立刻刷新。
+日课表写入需 schedule:write，并通过管理员或本班班主任检查；时间表写入需 timetable:manage。
+离线导入完整 ClassIsland 档案可创建班级自有作息，不依赖在线联动插件。
+完整导入保留 1–9 周轮换、空课、停用、群组和预定；旧预览界面的单双周展示不代表新模型只能表达双周。
+见[表格与课表导入](imports.md)。修改后广播 schedule:updated，客户端刷新。