Repository navigation
Expand file tree
/
Copy pathfeatures.html
More file actions
323 lines (303 loc) · 30.5 KB
/
Copy pathfeatures.html
File metadata and controls
323 lines (303 loc) · 30.5 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
<!doctype html>
<html lang="zh-Hant">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="排课与调代课系统 v1.3.0 的完整功能清单:基础资料、配课、手动与自动排课、发布查询、调代课、导出、系统管理与部署,以及目前的限制与规划中的功能。">
<title>功能总览 · 排课与调代课系统</title>
<link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='88'>📋</text></svg>">
<style>
:root{
--bg:#faf6f0; --surface:#fffdfa; --surface-2:#f4ece2;
--text:#241b14; --text-soft:#5c4c3f; --text-faint:#8d7a6a;
--border:#e5d8c8; --accent:#b4531f; --accent-soft:#fbeade;
--good:#5a7d2a; --good-soft:#eef3e3; --warn:#9c6008; --warn-soft:#fdefd6;
--info:#3d6485; --info-soft:#e9eef3;
--font-sans:"PingFang TC","Microsoft JhengHei","Noto Sans TC",system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;
--font-mono:"SF Mono","Cascadia Code","Consolas","Courier New",monospace;
}
@media (prefers-color-scheme:dark){
:root:not([data-theme="light"]){
--bg:#16110d; --surface:#1e1813; --surface-2:#29211a;
--text:#f0e7dd; --text-soft:#bcaa9a; --text-faint:#96826f;
--border:#3b2f25; --accent:#f0864a; --accent-soft:#37200f;
--good:#8fbf5c; --good-soft:#1f2a14; --warn:#e0a53c; --warn-soft:#33260f;
--info:#86a9cf; --info-soft:#1c242e;
}
}
:root[data-theme="dark"]{
--bg:#16110d; --surface:#1e1813; --surface-2:#29211a;
--text:#f0e7dd; --text-soft:#bcaa9a; --text-faint:#96826f;
--border:#3b2f25; --accent:#f0864a; --accent-soft:#37200f;
--good:#8fbf5c; --good-soft:#1f2a14; --warn:#e0a53c; --warn-soft:#33260f;
--info:#86a9cf; --info-soft:#1c242e;
}
*{box-sizing:border-box}
body{margin:0;background:var(--bg);color:var(--text);font-family:var(--font-sans);
line-height:1.7;font-size:15.5px;-webkit-font-smoothing:antialiased}
a{color:var(--accent)}
.page{max-width:1040px;margin:0 auto;padding:40px 16px 64px}
header{border-bottom:2px solid var(--border);padding-bottom:20px;margin-bottom:8px}
.eyebrow{color:var(--accent);font-weight:700;letter-spacing:.08em;font-size:13px}
h1{font-size:30px;margin:6px 0 8px;line-height:1.3}
.lead{color:var(--text-soft);margin:0}
.byline{margin:12px 0 0;color:var(--text-soft);font-size:14.5px}
.meta{display:flex;flex-wrap:wrap;gap:8px;margin-top:14px}
.chip{background:var(--surface-2);border:1px solid var(--border);border-radius:999px;
padding:2px 12px;font-size:13px;color:var(--text-soft)}
nav.toc{background:var(--surface);border:1px solid var(--border);border-radius:10px;
padding:14px 18px;margin:24px 0 8px}
nav.toc ol{margin:0;padding-left:20px;columns:2;column-gap:32px}
nav.toc li{break-inside:avoid;margin:2px 0}
h2{font-size:22px;margin:40px 0 4px;padding-top:8px;scroll-margin-top:12px}
h2 .no{color:var(--accent);font-family:var(--font-mono);margin-right:8px;font-size:18px}
h3{font-size:17px;margin:22px 0 6px;color:var(--text)}
.intro{color:var(--text-soft);margin:4px 0 12px}
.tbl{width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}
table{border-collapse:collapse;width:100%;min-width:560px;background:var(--surface);
border:1px solid var(--border);border-radius:8px;overflow:hidden;font-size:14.5px}
th,td{border-bottom:1px solid var(--border);padding:8px 12px;text-align:left;vertical-align:top}
th{background:var(--surface-2);font-weight:700;white-space:nowrap}
td:first-child{font-weight:600;white-space:nowrap}
td.ver{white-space:nowrap;color:var(--text-faint);font-family:var(--font-mono);font-size:13px}
tr:last-child td{border-bottom:0}
.note{border-left:4px solid var(--info);background:var(--info-soft);padding:10px 14px;
border-radius:0 8px 8px 0;margin:12px 0;font-size:14.5px}
.note.warn{border-color:var(--warn);background:var(--warn-soft)}
.note.good{border-color:var(--good);background:var(--good-soft)}
.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:12px;margin:12px 0}
.card{background:var(--surface);border:1px solid var(--border);border-radius:10px;padding:12px 14px}
.card b{display:block;margin-bottom:2px}
.card span{color:var(--text-soft);font-size:14px}
.tag{display:inline-block;font-size:12px;border-radius:4px;padding:0 6px;margin-left:4px;
font-weight:700;vertical-align:1px}
.tag.plan{background:var(--accent-soft);color:var(--accent)}
.tag.limit{background:var(--warn-soft);color:var(--warn)}
footer{margin-top:48px;border-top:1px solid var(--border);padding-top:16px;color:var(--text-faint);font-size:13px}
@media (max-width:640px){
h1{font-size:24px} nav.toc ol{columns:1}
td:first-child{white-space:normal}
}
@media print{
body{background:#fff;font-size:12px} .page{padding:0} nav.toc{display:none}
h2{break-after:avoid} table{break-inside:auto} tr{break-inside:avoid}
}
</style>
</head>
<body>
<div class="page">
<header>
<div class="eyebrow">FEATURE OVERVIEW</div>
<h1>排课与调代课系统 · 功能总览</h1>
<p class="lead">目前最新版 <b>v1.3.0</b>(2026-10-18)已经具备的全部功能,依「一个学期的工作流程」整理。每项功能的操作步骤请见<a href="index.html">教学组长操作手册</a>;各版变更细节见 <a href="https://github.com/begin0808/Course_Scheduling_System/blob/main/CHANGELOG.md">CHANGELOG</a>。遇到问题或有建议,欢迎<a href="#feedback">写信或到 GitHub Issues 回报</a>。</p>
<div class="meta">
<span class="chip">单校自架 · 资料不出校</span>
<span class="chip">开源免费(MIT)</span>
<span class="chip">小学/初中/普高/综高/技高五种范本</span>
<span class="chip">全繁体中文 · 台湾教务用语</span>
</div>
<p class="byline">开发者:国立南大附中 李佳恩老师 · <a href="mailto:begin0808@gmail.com">begin0808@gmail.com</a></p>
</header>
<nav class="toc" aria-label="目录">
<ol>
<li><a href="#roles">角色与权限</a></li>
<li><a href="#setup">开始使用与基础资料</a></li>
<li><a href="#assign">配课</a></li>
<li><a href="#manual">手动排课工作台</a></li>
<li><a href="#auto">自动排课</a></li>
<li><a href="#publish">发布与全校查询</a></li>
<li><a href="#leave">请假与调代课处理</a></li>
<li><a href="#print">看板、纪录与各式通知单</a></li>
<li><a href="#stats">代课课时统计</a></li>
<li><a href="#patrol">巡堂表</a></li>
<li><a href="#export">导出课表</a></li>
<li><a href="#admin">系统管理</a></li>
<li><a href="#ops">部署、升级与备份</a></li>
<li><a href="#limits">目前的限制</a></li>
<li><a href="#plan">规划中</a></li>
<li><a href="#history">版本沿革</a></li>
<li><a href="#feedback">意见回报</a></li>
</ol>
</nav>
<h2 id="roles"><span class="no">01</span>角色与权限</h2>
<p class="intro">登录后依角色显示不同的选单。</p>
<div class="tbl"><table>
<tr><th>角色</th><th>负责什么</th><th>看得到的功能</th></tr>
<tr><td>系统管理员</td><td>安装、帐号、备份还原、SMTP 等系统层设置</td><td>全部,含「系统管理」</td></tr>
<tr><td>教务主任</td><td>综览与审核</td><td>与教学组长几乎相同(除系统管理)</td></tr>
<tr><td>教学组长</td><td>日常主力:基础资料、配课、排课、调代课</td><td>基础资料、排课作业、调代课</td></tr>
<tr><td>教师</td><td>查自己的课表、自己请假、确认代课通知</td><td>课表查询(默认本人)、请假登记、我的代课课时</td></tr>
</table></div>
<div class="note">帐号安全:首次登录强制改密码;登录连续失败 5 次锁定 15 分钟;用户可自行改密码,组长可替教师重设密码、停用或启用登录帐号。</div>
<h2 id="setup"><span class="no">02</span>开始使用与基础资料</h2>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>设置精灵</td><td>全新系统第一次登录自动进入五步骤:学制范本 → 学年学期与起讫日期 → 节次表 → 导入资料 → 完成。可中途离开、下次接续,系统管理可重新启动。</td><td class="ver">v1.0</td></tr>
<tr><td>一键示范资料</td><td>全新系统可载入一所虚构初中(18 班、48 位教师、24 科、384 笔配课),两分钟内就能跑自动排课、请假、代课、导出。已有学期时不出现,避免覆盖正式资料。</td><td class="ver">v1.2.0</td></tr>
<tr><td>学制范本</td><td>小学、初中、普高、综高、技高,自动带入该学制的节次表与常见科目。</td><td class="ver">v1.0</td></tr>
<tr><td>学期管理</td><td>学年度、学期别、起讫日期(请假展开节次、看板、调代课都以此为准),可在「学期与节次表」编辑。</td><td class="ver">v1.2.7</td></tr>
<tr><td>节次表编辑器</td><td>每一天每一节的名称、起讫时间、类型(一般课/早自习/午休/不排课),可新增节次列(例如第八节)。</td><td class="ver">v1.0</td></tr>
<tr><td>多套节次表</td><td>同学期多套作息(初中小、完全中学),班级各自指定。跨部老师以「实际时间是否重叠」判断冲堂;两部节数不同也正确处理,课表与通知单标出实际上课时间。</td><td class="ver">v1.2.10–11</td></tr>
<tr><td>教师</td><td>姓名、任教科目、基本课时、行政职与减课、Email/手机/LINE、在职状态;可同时建立登录帐号。离职建议「设为非在职+停用帐号」,删除前会列出会一并消失的纪录。</td><td class="ver">v1.0 / v1.2.8</td></tr>
<tr><td>教师时段规则</td><td>每位教师每一节可设「不可排/尽量避开/偏好」。储存不可排时段时,若那几节已经有课会当场列出。</td><td class="ver">v1.0 / v1.2.18</td></tr>
<tr><td>班级</td><td>年级、班名(同学期不可重复)、学制、导师、群科、使用的节次表。</td><td class="ver">v1.0</td></tr>
<tr><td>科目</td><td>名称、是否主科(自动排课会优先排上午)。</td><td class="ver">v1.0</td></tr>
<tr><td>场地</td><td>名称、类型(一般/专科/实习工场/户外)、容量、适用科目。</td><td class="ver">v1.0</td></tr>
<tr><td>Excel 批次导入</td><td>科目、教师、班级、配课四种范本;错误会指出第几列哪一栏。教师导入可选「既有教师改为更新资料」,只覆盖有填的栏位。</td><td class="ver">v1.0 / v1.2.8</td></tr>
<tr><td>开新学期复制精灵</td><td>从既有学期复制教师/班级/科目/场地/节次表,班级年级自动 +1,毕业年级提示移除;两学期资料互不影响。</td><td class="ver">v1.0</td></tr>
</table></div>
<h2 id="assign"><span class="no">03</span>配课</h2>
<p class="intro">决定哪位老师、教哪个班、哪一科、每周几节——排课的核心输入。</p>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>基本配课</td><td>班级 × 科目 × 任课教师 × 每周节数。</td><td class="ver">v1.0</td></tr>
<tr><td>连堂</td><td>设置连堂长度(2~4 节)与每周次数,例如实习 3 节连上每周 2 次;连堂不跨午休。</td><td class="ver">v1.0</td></tr>
<tr><td>场地需求</td><td>指定特定场地,或只指定场地类型由自动排课挑选。</td><td class="ver">v1.0</td></tr>
<tr><td>协同教学</td><td>同一笔配课多位教师(第一位为主教),所有教师同时被占用。</td><td class="ver">v1.0</td></tr>
<tr><td>跑班群组</td><td>多个班级组成群组,群组内的多笔配课同一节一起上(多元选修、英数分组、社团)。成员班级须同一套节次表、各笔节数与连堂结构一致;同一位教师在群组内只能有一笔(v1.2.15 起会挡下)。</td><td class="ver">v1.0 / v1.2.15</td></tr>
<tr><td>单双周组</td><td>同一节单周、双周轮流上两门课(例:701 周一三四节单周生科、双周资科;702 反过来)。一组一个班,单周、双周各一笔,节数与连堂相同。学期第一周为单周、之后固定轮流;隔周的课课时算一半。</td><td class="ver">v1.3.0</td></tr>
<tr><td>即时课时侧栏</td><td>每位教师「配课节数 vs 应授课时」,超课时红字标示(如 +2)。</td><td class="ver">v1.0</td></tr>
<tr><td>超课时上限</td><td>配课超过「应授 + N 节」时挡下并指名(N 默认 8,0 表示不限制;没填基本课时的教师不受限)。</td><td class="ver">v1.2.0</td></tr>
<tr><td>班级负荷警告</td><td>某班每周配课总节数超过可排节次时警告。</td><td class="ver">v1.0</td></tr>
</table></div>
<h2 id="manual"><span class="no">04</span>手动排课工作台</h2>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>拖拉排课</td><td>左侧未排课务清单(附剩余节数)拖进周课表;拖回清单即移除。清单很长时课表固定、清单自己卷动。</td><td class="ver">v1.0 / v1.2.6</td></tr>
<tr><td>即时冲突检查</td><td>可放显示绿框、冲突显示红框并用人话说明原因(教师/班级/场地冲堂、教师不可排、非上课节次、每日上限…);跨节次表以实际时间判断。</td><td class="ver">v1.0</td></tr>
<tr><td>三视角同步</td><td>班级/教师/场地三种角度查看同一份课表,彼此即时同步。</td><td class="ver">v1.0</td></tr>
<tr><td>锁定格位</td><td>锁定后自动排课不会移动(第八节课后辅导、社团都靠这招)。</td><td class="ver">v1.0</td></tr>
<tr><td>复原/重做、自动储存</td><td>Ctrl+Z 复原;编辑过程自动存草稿。</td><td class="ver">v1.0</td></tr>
<tr><td>跑班群组连动</td><td>群组内任一门课放入、移动、删除、锁定,整组一起动。</td><td class="ver">v1.0</td></tr>
<tr><td>单双周</td><td>单双周组合成一张卡片,拖一次放入单周、双周两堂(可连堂);冲堂判断分单双周,单周在 701、双周在 702 不算冲堂。格子上下列出「单/双」两堂。</td><td class="ver">v1.3.0</td></tr>
</table></div>
<h2 id="auto"><span class="no">05</span>自动排课</h2>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>排课引擎</td><td>以 Google OR-Tools(CP-SAT)求解;在背景工作排程执行,不影响导出等其他工作。结果另存新草稿「来源名 自排结果」,来源草稿不受影响。</td><td class="ver">v1.0</td></tr>
<tr><td>硬性规则</td><td>班级、教师、场地同一节只能一堂课(跨节次表看实际时间);教师不可排时段;只排一般课节次;连堂连续且不跨午休;跑班群组同时段;每周节数守恒;锁定格位不动;同班同科目每日上限(默认 2 节);场地类型符合。</td><td class="ver">v1.0</td></tr>
<tr><td>软性偏好(S1–S8)</td><td>教师偏好/避开时段、同科分散在不同天、教师每日节数上限、空堂集中、主科排上午、教师连续授课上限、导师的课优先排自己班第一节、全校教师偏好达成的公平性。排完附各项达成度报告。</td><td class="ver">v1.0</td></tr>
<tr><td>排课前检查</td><td>先检查资料是否可能排得出来(教师配课超过可排格数、班级超量、场地不足、连堂放不下、跑班群组节数不一致或同一教师重复…),逐项说明。</td><td class="ver">v1.0 / v1.2.15</td></tr>
<tr><td>进度与提前结束</td><td>即时显示已找到几个解、目前目标值、经过时间;可设时间上限,找到解后可提前结束取当前最佳解。</td><td class="ver">v1.0</td></tr>
<tr><td>冲突定位</td><td>排不出来时指出是哪几件事凑在一起、附数字与建议(例如「301 国文 12 节单节,但每日上限 2 × 5 天 = 10」),可一键照建议放宽后重试。</td><td class="ver">v1.0</td></tr>
<tr><td>部分排课</td><td>尽量排,把真的排不下的课列成未排清单并说明原因;可勾选放宽每日上限、教师不可排时段、锁定格位;发布后仍查得到原因。</td><td class="ver">v1.1</td></tr>
</table></div>
<h2 id="publish"><span class="no">06</span>发布与全校查询</h2>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>多份草稿</td><td>同学期多份草稿并存,可复制、改名、删除;已发布/已封存为唯读快照。</td><td class="ver">v1.0</td></tr>
<tr><td>检查课表</td><td>课务有没有排完,以及冲堂、排在不可排时段、超过每日上限、连堂或节数与配课不符等冲突(多半来自排好后又改了资料)。草稿、已发布皆可检查。</td><td class="ver">v1.2.18</td></tr>
<tr><td>发布</td><td>有未排完或冲突时先列清单,确认后才可强制发布;同学期至多一份已发布,旧版自动封存。重新发布时提醒有多少日后的调代课是依旧课表安排的。</td><td class="ver">v1.0 / v1.2.18</td></tr>
<tr><td>全校课表查询</td><td>唯读,依班级/教师/场地查询已发布课表,手机版面可用;教师登录默认显示本人课表。</td><td class="ver">v1.0</td></tr>
</table></div>
<h2 id="leave"><span class="no">07</span>请假与调代课处理</h2>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>请假登记</td><td>教师自登或组长代登;假别有公假、事假、病假、婚假、丧假、产假、进修等;可整天、半天(指定时段)、多天、跨周。依已发布课表自动展开每一节受影响的课;单双周的课只列那一周真的有上的。</td><td class="ver">v1.0 / v1.3.0</td></tr>
<tr><td>销假</td><td>未上的节次自动取消并通知代课老师;已上完的课照常计课时。</td><td class="ver">v1.0</td></tr>
<tr><td>五种处置</td><td>代课(计课时)、调课(两人互换,不计)、并班(默认不计,可改)、自习、不处理;已处置的节次写出「怎么处置」,可撤回。</td><td class="ver">v1.0 / v1.2.4</td></tr>
<tr><td>代课推荐</td><td>列出当节有空的老师,同科、当天已在校者优先,附理由与本月已代节数;排很满的老师自动排后面;无人可代时提示改并班或自习。</td><td class="ver">v1.0</td></tr>
<tr><td>计费方式</td><td>公费代课、自费代课、日薪代课、课务自理、不支课时,也可自行输入;默认依假别(事假自费、其余公费)。印在代课通知单上。</td><td class="ver">v1.2.5 / v1.2.19</td></tr>
<tr><td>整批指派代课</td><td>整张假单或其中一天一次派给同一位老师;代课老师自己有课的节次跳过并说明原因,已处理的不动。</td><td class="ver">v1.2.19</td></tr>
<tr><td>调课</td><td>列出可对调的节次:默认请假当周到下周,可放宽到往后 3 或 4 周;每个选项都已检查双方有空、没有请假、没被换过。默认列「也教这个班」的老师,可指定其他老师;支援连堂中的其中一节。研习可先登公假再调课。</td><td class="ver">v1.2.1</td></tr>
<tr><td>通知与确认</td><td>站内铃铛通知(含未读数),设置 SMTP 时同步寄 Email;老师一键「确认收到」;调课双方都收到通知,撤回也会通知。</td><td class="ver">v1.0</td></tr>
<tr><td>通知确认看板</td><td>每一笔的确认状态,对未确认者一键再次提醒。</td><td class="ver">v1.0</td></tr>
</table></div>
<h2 id="print"><span class="no">08</span>看板、纪录与各式通知单</h2>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>今日调代课看板</td><td>选一天,列出全部异动(代课、调课、并班、自习、教室变动);调课在请假日与补课日两天都列出。可打印 A4 公告单。</td><td class="ver">v1.0 / v1.2.1</td></tr>
<tr><td>调代课纪录</td><td>依教师、日期区间、假别筛选;查一位老师时,他「缺的课」和「代的课」都会出现。</td><td class="ver">v1.0</td></tr>
<tr><td>调课通知单</td><td>照学校纸本格式的教师单与班级单(A4 直式周课表),可印一节、一张假单或筛选出的一周;跨周调课印成两页。</td><td class="ver">v1.2.2</td></tr>
<tr><td>代课通知单</td><td>教师单与班级单(含计费方式),并班标「[并]」;同一位代课老师多节合并成一张。</td><td class="ver">v1.2.5</td></tr>
</table></div>
<h2 id="stats"><span class="no">09</span>代课课时统计</h2>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>月结报表</td><td>依教师汇总代课节数与计费节数(并班、自习不计),附逐节明细;跨月的假单依每一节的日期自动分月;可导出 Excel(汇总+明细)。</td><td class="ver">v1.0</td></tr>
<tr><td>日薪代课</td><td>计费方式为日薪的节次不计入课时,改列「日薪天数」(同一天算 1 天,注明共几节);同一位请假教师同一天由两位以上日薪代课分担时,各算 1 天并标示「分担」。</td><td class="ver">v1.2.19</td></tr>
<tr><td>教师个人查询</td><td>教师可查自己每月代课的明细。</td><td class="ver">v1.0</td></tr>
</table></div>
<div class="note">只提供节数与天数,<b>不计算金额</b>(各县市、各学制的单价与规定不同)。</div>
<h2 id="patrol"><span class="no">10</span>巡堂表</h2>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>巡堂纪录</td><td>已发布课表+当天调代课叠起来的真实样貌。A4 横式,班级为栏、节次为列,上午、下午各一张(早自习、午休不列);代课、调课、并班、自习、停课、请假待处理都会标示;超过 12 班自动分页。可印当天或整周。</td><td class="ver">v1.2.12</td></tr>
<tr><td>分组巡堂单</td><td>同一节 4 组以上的跑班群组(社团、多元选修)另列清单,一列一组,编号固定依配课建立顺序。</td><td class="ver">v1.2.12–13</td></tr>
<tr><td>导出 Excel</td><td>内容同打印页,每天上午、下午各一分页,分组单另成页;已设 A4 横向一页宽,可先改再印。</td><td class="ver">v1.2.14</td></tr>
<tr><td>记录说明自订</td><td>表格下方「授课情形、学生学习」的代码说明可在系统管理改成各校写法。</td><td class="ver">v1.2.12</td></tr>
</table></div>
<h2 id="export"><span class="no">11</span>导出课表</h2>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>单一课表</td><td>班级、教师或场地课表,Excel、PDF(内嵌中文字型)、PNG 三选一;所有登录者都能导出。</td><td class="ver">v1.0</td></tr>
<tr><td>全校总表</td><td>一个 Excel,每班或每位教师一个分页(教学组长以上)。</td><td class="ver">v1.0 / v1.2.9</td></tr>
<tr><td>批次打包</td><td>每班或每位教师一个 Excel,打包成 zip;在职教师全部列入(没排课也有空白课表)。</td><td class="ver">v1.0 / v1.2.9</td></tr>
</table></div>
<h2 id="admin"><span class="no">12</span>系统管理</h2>
<div class="tbl"><table>
<tr><th>功能</th><th>说明</th><th>版本</th></tr>
<tr><td>版本与新版提醒</td><td>显示目前版本与 GitHub 上的最新正式版,有新版时附更新内容与升级指南连结;只提醒、不自动升级,每天最多查一次,可关闭。选单底部随时显示版本。</td><td class="ver">v1.2.3</td></tr>
<tr><td>学校信息</td><td>校名(显示在介面、导出课表、通知信、公告单),改完立即生效。</td><td class="ver">v1.2.0</td></tr>
<tr><td>排课设置</td><td>超课时上限(应授 + N 节)。</td><td class="ver">v1.2.0</td></tr>
<tr><td>巡堂表设置</td><td>记录说明的代码文字。</td><td class="ver">v1.2.12</td></tr>
<tr><td>备份与还原</td><td>每日凌晨自动备份、保留 30 份;立即备份;下载异地保存、上传还原;还原前自动先备份现状,还原后所有人重新登录。</td><td class="ver">v1.0</td></tr>
<tr><td>Email 通知(SMTP)</td><td>选填;可寄测试信验证。未设置时只有站内通知。</td><td class="ver">v1.0</td></tr>
<tr><td>重新启动设置精灵</td><td>限系统管理员。</td><td class="ver">v1.0</td></tr>
</table></div>
<h2 id="ops"><span class="no">13</span>部署、升级与备份</h2>
<div class="cards">
<div class="card"><b>Docker 一键部署</b><span>六个容器(网页、API、排课工作、导出/备份工作、PostgreSQL、Redis);官方映像 amd64+arm64 双架构,免建置直接拉取。</span></div>
<div class="card"><b>升级</b><span>改 .env 的 IMAGE_TAG 后 pull、up;资料库迁移自动执行。1.2.x 各版都没有资料表结构变更;v1.3.0 首次变更,升级前务必备份,退回需还原备份。</span></div>
<div class="card"><b>HTTPS</b><span>设置网域即自动申请凭证(Caddy);未设置时为校内 HTTP。</span></div>
<div class="card"><b>资料不出校</b><span>单校自架,不连任何云端服务;唯一的对外连线是每天一次的版本查询,可关闭。</span></div>
</div>
<div class="note good">每一版发布前都经过:后端 654 项、前端 31 项、端对端 50 项自动测试(对真实 Docker 全栈),合并与标签两轮 CI,以及用正式映像在全新环境的实测。</div>
<h2 id="limits"><span class="no">14</span>目前的限制</h2>
<p class="intro">已知、尚未处理的部分。多数有变通做法(见手册 FAQ)。</p>
<div class="tbl"><table>
<tr><th>项目</th><th>现况与变通</th></tr>
<tr><td>跑班群组+单双周<span class="tag limit">未做</span></td><td>单双周组只支援一个班的两门课;「单周社团、双周班会」这类整个群组隔周轮流尚未支援。</td></tr>
<tr><td>导入配课的单双周<span class="tag limit">未做</span></td><td>Excel 导入配课还不能设置单双周,请导入后在界面上组成单双周组。</td></tr>
<tr><td>兼课、辅导费月结<span class="tag plan">待讨论</span></td><td>月结只有代课;超课时(兼课)与课后辅导「当月实际上了几节」需要学校停课日资料,尚未提供。</td></tr>
<tr><td>课时费金额<span class="tag limit">不做</span></td><td>系统只算节数与天数,金额由学校依规定计算。</td></tr>
<tr><td>跑班格子的显示<span class="tag limit">限制</span></td><td>班级课表与导出的同一格若是跑班群组(多门课同时),只显示其中一门。</td></tr>
<tr><td>配课清单的场地栏<span class="tag limit">限制</span></td><td>指定了特定场地的配课,清单的「场地」栏仍只显示类型需求。</td></tr>
<tr><td>跑班群组只能单节放入<span class="tag limit">限制</span></td><td>手动放入群组一律是单节;连上两节的社团请「节数 2、不设连堂、拖两次再锁定」。</td></tr>
<tr><td>分组巡堂单顺序<span class="tag limit">限制</span></td><td>固定依配课建立的顺序,无法手动调整。</td></tr>
<tr><td>课表格子的违规标记<span class="tag limit">未做</span></td><td>冲突在「检查课表」与发布时列出,课表格子上没有常驻标记。</td></tr>
<tr><td>排课参数没有设置界面<span class="tag limit">限制</span></td><td>同班同科目每日上限(2 节)、教师每日节数与连续授课上限、偏好权重都使用默认值,界面上没有地方修改;排不出来时可在「部分排课」勾选放宽每日上限。</td></tr>
<tr><td>两部之间的移动时间</td><td>跨部老师不考虑移动时间;需要的话用教师不可排时段保留。</td></tr>
</table></div>
<h2 id="plan"><span class="no">15</span>规划中</h2>
<div class="tbl"><table>
<tr><th>项目</th><th>内容</th><th>预定</th></tr>
<tr><td>导入配课支援单双周</td><td>Excel 范本加上单周/双周与配对栏位,并与旧范本相容。</td><td class="ver">v1.3.x</td></tr>
<tr><td>工程改善</td><td>API 映像拆掉排课引擎(约 674MB → 200MB)、前端按需载入、科目导入支援主科栏、配课当下挡群组节数不一致、还原上传改串流。</td><td class="ver">之后</td></tr>
</table></div>
<h2 id="history"><span class="no">16</span>版本沿革</h2>
<div class="tbl"><table>
<tr><th>版本</th><th>日期</th><th>重点</th></tr>
<tr><td>v1.0.0</td><td class="ver">2026-07-12</td><td>首次公开发行:基础资料、配课、手动与自动排课、发布、调代课、导出、备份全流程</td></tr>
<tr><td>v1.1.0–1.1.2</td><td class="ver">2026-07-14</td><td>加固:排课不堵导出、部分排课、班名不重复</td></tr>
<tr><td>v1.2.0</td><td class="ver">2026-08-02</td><td>一键示范资料、校名可在系统内设置、超课时上限</td></tr>
<tr><td>v1.2.1–1.2.5</td><td class="ver">2026-09-17~26</td><td>调课、调课通知单、版本提醒、处置写清楚、代课通知单与计费方式</td></tr>
<tr><td>v1.2.6–1.2.9</td><td class="ver">2026-10-01~02</td><td>外部用户回报修正、学期起讫可编辑、教师批次更新与帐号停用、全校教师课表导出</td></tr>
<tr><td>v1.2.10–1.2.11</td><td class="ver">2026-10-04</td><td>初中小、完全中学:跨部老师的实际上课时间与节数不同</td></tr>
<tr><td>v1.2.12–1.2.14</td><td class="ver">2026-10-06</td><td>巡堂表打印、分组巡堂单、导出 Excel</td></tr>
<tr><td>v1.2.15–1.2.16</td><td class="ver">2026-10-07</td><td>跑班群组:重复教师检查、每日节数算法</td></tr>
<tr><td>v1.2.17–1.2.18</td><td class="ver">2026-10-08</td><td>登录重复送出修正、检查课表</td></tr>
<tr><td>v1.2.19</td><td class="ver">2026-10-09</td><td>日薪代课、整批指派代课</td></tr>
<tr><td>v1.3.0</td><td class="ver">2026-10-18</td><td>单双周课程(首次资料表结构变更)</td></tr>
</table></div>
<h2 id="feedback"><span class="no">17</span>意见回报</h2>
<p class="intro">这一版的多数改进都来自老师们的回报。遇到问题、学校有特别的做法,或想要什么功能,都欢迎告诉我们。两种方式择一即可:</p>
<div class="cards">
<div class="card"><b>✉️ 写信</b><span>不需要任何帐号,直接寄到<br><a href="mailto:begin0808@gmail.com">begin0808@gmail.com</a>(李佳恩老师)</span></div>
<div class="card"><b>🐞 GitHub Issues</b><span><a href="https://github.com/begin0808/Course_Scheduling_System/issues">github.com/begin0808/Course_Scheduling_System/issues</a><br>按「New issue」留言(需要免费的 GitHub 帐号),其他学校也看得到讨论与处理进度。</span></div>
</div>
<div class="note good">回报问题时附上<b>系统版本</b>(选单底部)、<b>操作步骤</b>和<b>界面截图</b>,会更快找到原因;截图请先遮住老师姓名等个人资料。</div>
<footer>排课与调代课系统 · 功能总览 · 对应 v1.3.0 · 开源免费(MIT)· 单校自架<br>开发者:国立南大附中 李佳恩老师 · <a href="mailto:begin0808@gmail.com">begin0808@gmail.com</a></footer>
</div>
</body>
</html>