ClassHelper/docs/app/schedules.md

---
title: 课表
description: 日课表、共享作息、轮换、临时换课和教学周。
---

# 课表

Web 管理端可查看周课表并编辑时间表与日课表，客户端提供“今天”时间轴和“本周”视图。
上课状态、灵动岛课程提醒和紧急通知确认共用服务端的课表判定。

## 日课表与时间表

时间表保存时间点：上课、课间、分割线、行动；日课表引用时间表，每节课程通过外键关联时间点。
可以维护多套班级作息或共享作息、复制日课表、调整课程、配置启用规则和群组。
时间点排序不会改变课程关联。行动配置当前保存数据，不执行外部动作。

日课表按星期、周次范围和轮换规则启用，支持 1–9 周轮换；单双周是 2 周轮换的特例，第 1 教学周为单周。
可以预定某天使用某张表，临时换课/叠加层保留原表。相同日期的最终启用选择由服务端唯一解析器完成。

## 教学周

班级有自己的学期周数；全校上限由“学期周次”设置，默认 30、可设 1–60，班级不能超过该上限。
默认班级周数为 20。管理员可在界面修改全校开学日和逐周起止区间，班级可有独立设置。
计算优先使用班级逐周区间、再全校区间；无适用区间时按开学日线性计算。
开学日解析还会参考第 1 周起点，环境变量 TERM_START_DATE 是兜底，具体顺序见 `lib/term.ts`。

## 上课状态与提醒

`GET /api/schedules/current?classId=<id>&at=<ISO时间>` 返回 inClass/current/next/week/serverTime 等状态；at 用于诊断。
`/schedules` 是新模型的兼容门面，旧 Schedule 只保留迁移审计记录。
经典岛普通通知上课暂存、下课补弹；普通叫人保留可点击胶囊，紧急消息立即展开。
自定义常驻岛先显示铃铛，由用户主动查看。紧急通知在课堂发布仍需服务端二次确认。

## 权限与导入

日课表写入需 schedule:write，并通过管理员或本班班主任检查；时间表写入需 timetable:manage。
离线导入完整 ClassIsland 档案可创建班级自有作息，不依赖在线联动插件。
完整导入保留 1–9 周轮换、空课、停用、群组和预定；旧预览界面的单双周展示不代表新模型只能表达双周。
见[表格与课表导入](imports.md)。修改后广播 schedule:updated，客户端刷新。