Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .env.example
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ HTTP_PORT=80
# ── 預建映像版本(僅「拉取映像」部署方式需要)──────────
# 用 docker compose pull 拉官方映像時,決定要拉哪一版。
# 預設 latest(最新);正式部署建議釘選版本號以利可控升級,例如:
# IMAGE_TAG=v1.4.17
# IMAGE_TAG=v1.4.18
# 若你是從原始碼 docker compose up -d 自行建置,此項可忽略。
IMAGE_TAG=latest

Expand Down
19 changes: 18 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,27 @@

破壞性變更(需人工介入才能升級)以 ⚠️ 標註。

> **新使用者請直接安裝 v1.4.17**(見 [README](README.md) 快速開始)。v1.0.0 ~ v1.4.16 是先前版本;以下條目保留作為變更紀錄。
> **新使用者請直接安裝 v1.4.18**(見 [README](README.md) 快速開始)。v1.0.0 ~ v1.4.17 是先前版本;以下條目保留作為變更紀錄。

## [Unreleased]

## [1.4.18] — 2026-11-11

**修正:調課之後重新發布課表,補課那一節不見了**(LINE 社群組長回報,**建議升級**)。

**資料表沒有變動**,照一般方式升級即可(`.env` 改 `IMAGE_TAG=v1.4.18` → `docker compose pull && docker compose up -d`)。升級時系統會自動修正既有調課的資料(見下),修正前會先自動備份。

官方映像(amd64 + arm64 雙架構)已發布於 GHCR:
`ghcr.io/begin0808/course_scheduling_system-{api,worker,web}:v1.4.18`

### 修正
- **重新發布課表後,調課的補課那一節不見了**:調課記下補課那一節時,記的是「課表的哪一格」;學期中改課表再發布,新課表每一格都是新的,補課那一節還指著已封存的舊課表。結果:
- 班級、教師的週課表、全校教師週總表、巡堂表、即時概況都畫不出補課那一節(只有請假那一格變色,看起來像「只有一個人被調」);
- 調課清單以為那一節還沒被拿去調,**同一節可能再換給別的老師**。

現在發布新課表時,調課會自動接到新課表「同一門課、同一天、同一節」的格子。新課表把那堂課搬走、接不上的,發布後會提醒「有 N 筆調課的補課節次…」,請到「調代課處理」按該節的「撤回」後重新安排。
- **升級時修正已經發生的**:升級到 v1.4.18 時,既有調課會用同一套規則接回目前已發布的課表(只改調課的資料,不改資料表)。

## [1.4.17] — 2026-11-11

**修正:調課寫出補課在哪一天**(LINE 社群組長回報)。
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,11 +132,11 @@ docker compose up -d # 首次會建置映像,需數分鐘

## 專案狀態

**v1.4.17 已發行(2026-11-11)。** 六大里程碑 M0–M5 全部完成,功能齊備並經完整驗收(後端 779 項單元/整合測試、61 項 Playwright 端對端測試涵蓋全部 20 個頁面,每次提交皆對真實 Docker 全棧跑過)。官方映像(amd64 + arm64)已發布於 GHCR。
**v1.4.18 已發行(2026-11-11)。** 六大里程碑 M0–M5 全部完成,功能齊備並經完整驗收(後端 783 項單元/整合測試、61 項 Playwright 端對端測試涵蓋全部 20 個頁面,每次提交皆對真實 Docker 全棧跑過)。官方映像(amd64 + arm64)已發布於 GHCR。

v1.4.17 調代課紀錄與某一週的班級課表,調課**寫出對調的另一節在哪一天**;v1.4.16 跑班 5 組以內在班級課表**列出每位老師**,先調課再請假時已調走的節次**不再重複列出**;v1.4.15 課表查詢可以**看某一週實際的課表**(含調代課,異動標色),並新增身心調適假等常用假別;v1.4.14 新增**全校教師週總表**(老師為欄、標出這週的調代課,可列印或匯出 Excel);v1.4.13 修正跑班群組在班級課表只顯示一位老師(同一格改列出每一組);v1.4.12 調課可以**從較早的週開始找**(老師提早請假、想先補課),換不了的節次會**寫出原因**,代導半天改以「次」計;v1.4.11「代課鐘點統計」可以**自訂統計區間**(每月 15 日結算的學校可選 10/16~11/15);v1.4.10 已經上過的調課可以**事後補登**(「新增調課(未請假)」勾已經上過的節次;不通知老師),調代課紀錄也能篩出「調課(未請假)」,查老師多常換課;v1.4.9 同一天好幾節要一起換(例如學校活動讓兩班的第七、八節同時對調)也**調得成**了;v1.4.8 新學期第一次進「自動排課」會**自動建立草稿**,配完課就能直接排;v1.4.7 **資安修正**:登入失敗鎖定不會再被「同時送出」繞過(建議升級);v1.4.6 全校總表與批次 zip 都可以**匯出 PDF**;v1.4.5 老師**沒請假也能調課**(調代課處理的「新增調課」);v1.4.4 登記後可以**修改假別與計費方式**(已經上過的代課也可以改計費方式),請假的假別改成一定要選;v1.4.3 修正安排代導時操作紀錄沒寫出老師名字;v1.4.2 可以**補登**事後才登記的請假(已經過去的節次補登代課,不通知老師、列入鐘點統計);v1.4.1 起改採 **AGPL-3.0 授權**(見下方「授權」;功能與資料都沒有變動);v1.4.0 新增**代導**(導師請假當天由誰代他帶班,當天沒課也算、半天也算;可印代導通知單,月結分開記全天與半天天數;⚠️ 資料表結構變更,升級前會自動備份);v1.3.5 修正**併班**選不到老師(改列出這一節正在上課的老師),調課單加上記號說明;v1.3.4 讓跑班群組、導師、任教科目等下拉選單都能**打字搜尋**;v1.3.3 的儀表板新增**即時概況**(現在這一節各班在上什麼課、誰在上,已套用當天的調代課);v1.3.2 新增**重設管理員密碼**的指令(忘了密碼或第一次就登不進去時,不必刪資料或還原備份);v1.3.1 新增**帳號管理**(系統管理員可設定教學組長、教務主任的帳號);v1.3.0 支援**單雙週課程**(同一節單週、雙週輪流上不同的課,排課、請假代課、調課、巡堂表、鐘點都分單雙週;⚠️ 首次改動資料表結構,升級前請先備份);v1.2.19 支援**日薪代課**(國小常見:月結統計把鐘點與日薪分開列)並可**整批指派代課**(整張假單或整天一次派給同一位老師);v1.2.18 可**檢查課表**(發布前列出衝堂、教師不可排時段等衝突;事後修改不可排時段時當場提示已排的課);v1.2.17 修正登入按一次送出兩筆請求(輸錯密碼約第 3 次就被鎖定);v1.2.15、v1.2.16 修正跑班群組的兩個問題(同一位老師在群組裡重複配課時自動排課會排出撞課的課表;同一格有多筆同科目配課時,手動排課把每日節數重複計算);v1.2.12~v1.2.14 可列印**巡堂表**並匯出 Excel(依當天的調代課結果產生,社團另出分組巡堂單);v1.2.10、v1.2.11 讓**國中小、完全中學**跨部上課的老師,課表與通知單都標出實際上課時間,兩部節數不同(國中七節、高中八節)也不會漏課;v1.2.9 可一次匯出**全校教師課表**(總表與批次打包);v1.2.8 可用 Excel **批次更新既有教師**(新學年職務異動),並能**停用/啟用教師登入帳號**(離職教師保留歷史紀錄又進不來);v1.2.7 補上**學期起訖日期**的填寫與修改(先前畫面上無處可填,導致請假被擋);v1.2.6 修掉第一批外部使用者回報的三個問題(教師帳號首次登入卡死、無法事後補開教師帳號、未排課務清單過長時拖不動),並可在畫面上自行修改與重設密碼;v1.2.5 可列印**教師代課通知單與班級代課通知單**(照學校紙本格式,代課時可選計費方式);v1.2.4 的調代課處理會寫出處置方式(代課或調課、哪天補課);v1.2.3 起系統會顯示目前版本,並在有新版時提醒系統管理員(只提醒、不自動升級);v1.2.2 可列印**教師調課通知單與班級調課通知單**(照學校紙本格式);v1.2.1 補上**調課**的操作畫面——請假(含研習)的節次可直接列出雙方都有空的對調節次,支援跨週(最多四週)與連堂,補課日也會出現在今日看板。v1.2.0 起另有**一鍵示範資料**,裝好後兩分鐘內就能看到一張排好的全校課表。
v1.4.18 修正調課後**重新發布課表**時補課那一節消失的問題;v1.4.17 調代課紀錄與某一週的班級課表,調課**寫出對調的另一節在哪一天**;v1.4.16 跑班 5 組以內在班級課表**列出每位老師**,先調課再請假時已調走的節次**不再重複列出**;v1.4.15 課表查詢可以**看某一週實際的課表**(含調代課,異動標色),並新增身心調適假等常用假別;v1.4.14 新增**全校教師週總表**(老師為欄、標出這週的調代課,可列印或匯出 Excel);v1.4.13 修正跑班群組在班級課表只顯示一位老師(同一格改列出每一組);v1.4.12 調課可以**從較早的週開始找**(老師提早請假、想先補課),換不了的節次會**寫出原因**,代導半天改以「次」計;v1.4.11「代課鐘點統計」可以**自訂統計區間**(每月 15 日結算的學校可選 10/16~11/15);v1.4.10 已經上過的調課可以**事後補登**(「新增調課(未請假)」勾已經上過的節次;不通知老師),調代課紀錄也能篩出「調課(未請假)」,查老師多常換課;v1.4.9 同一天好幾節要一起換(例如學校活動讓兩班的第七、八節同時對調)也**調得成**了;v1.4.8 新學期第一次進「自動排課」會**自動建立草稿**,配完課就能直接排;v1.4.7 **資安修正**:登入失敗鎖定不會再被「同時送出」繞過(建議升級);v1.4.6 全校總表與批次 zip 都可以**匯出 PDF**;v1.4.5 老師**沒請假也能調課**(調代課處理的「新增調課」);v1.4.4 登記後可以**修改假別與計費方式**(已經上過的代課也可以改計費方式),請假的假別改成一定要選;v1.4.3 修正安排代導時操作紀錄沒寫出老師名字;v1.4.2 可以**補登**事後才登記的請假(已經過去的節次補登代課,不通知老師、列入鐘點統計);v1.4.1 起改採 **AGPL-3.0 授權**(見下方「授權」;功能與資料都沒有變動);v1.4.0 新增**代導**(導師請假當天由誰代他帶班,當天沒課也算、半天也算;可印代導通知單,月結分開記全天與半天天數;⚠️ 資料表結構變更,升級前會自動備份);v1.3.5 修正**併班**選不到老師(改列出這一節正在上課的老師),調課單加上記號說明;v1.3.4 讓跑班群組、導師、任教科目等下拉選單都能**打字搜尋**;v1.3.3 的儀表板新增**即時概況**(現在這一節各班在上什麼課、誰在上,已套用當天的調代課);v1.3.2 新增**重設管理員密碼**的指令(忘了密碼或第一次就登不進去時,不必刪資料或還原備份);v1.3.1 新增**帳號管理**(系統管理員可設定教學組長、教務主任的帳號);v1.3.0 支援**單雙週課程**(同一節單週、雙週輪流上不同的課,排課、請假代課、調課、巡堂表、鐘點都分單雙週;⚠️ 首次改動資料表結構,升級前請先備份);v1.2.19 支援**日薪代課**(國小常見:月結統計把鐘點與日薪分開列)並可**整批指派代課**(整張假單或整天一次派給同一位老師);v1.2.18 可**檢查課表**(發布前列出衝堂、教師不可排時段等衝突;事後修改不可排時段時當場提示已排的課);v1.2.17 修正登入按一次送出兩筆請求(輸錯密碼約第 3 次就被鎖定);v1.2.15、v1.2.16 修正跑班群組的兩個問題(同一位老師在群組裡重複配課時自動排課會排出撞課的課表;同一格有多筆同科目配課時,手動排課把每日節數重複計算);v1.2.12~v1.2.14 可列印**巡堂表**並匯出 Excel(依當天的調代課結果產生,社團另出分組巡堂單);v1.2.10、v1.2.11 讓**國中小、完全中學**跨部上課的老師,課表與通知單都標出實際上課時間,兩部節數不同(國中七節、高中八節)也不會漏課;v1.2.9 可一次匯出**全校教師課表**(總表與批次打包);v1.2.8 可用 Excel **批次更新既有教師**(新學年職務異動),並能**停用/啟用教師登入帳號**(離職教師保留歷史紀錄又進不來);v1.2.7 補上**學期起訖日期**的填寫與修改(先前畫面上無處可填,導致請假被擋);v1.2.6 修掉第一批外部使用者回報的三個問題(教師帳號首次登入卡死、無法事後補開教師帳號、未排課務清單過長時拖不動),並可在畫面上自行修改與重設密碼;v1.2.5 可列印**教師代課通知單與班級代課通知單**(照學校紙本格式,代課時可選計費方式);v1.2.4 的調代課處理會寫出處置方式(代課或調課、哪天補課);v1.2.3 起系統會顯示目前版本,並在有新版時提醒系統管理員(只提醒、不自動升級);v1.2.2 可列印**教師調課通知單與班級調課通知單**(照學校紙本格式);v1.2.1 補上**調課**的操作畫面——請假(含研習)的節次可直接列出雙方都有空的對調節次,支援跨週(最多四週)與連堂,補課日也會出現在今日看板。v1.2.0 起另有**一鍵示範資料**,裝好後兩分鐘內就能看到一張排好的全校課表。

**請直接從最新版開始安裝**(見上方快速開始);`v1.4.17` 是目前建議使用的版本。各版變更見 [CHANGELOG](CHANGELOG.md),開發歷程見 [docs/tasks.md](docs/tasks.md)。
**請直接從最新版開始安裝**(見上方快速開始);`v1.4.18` 是目前建議使用的版本。各版變更見 [CHANGELOG](CHANGELOG.md),開發歷程見 [docs/tasks.md](docs/tasks.md)。

系統仍在實際校園環境試用中,若你是第一批使用者,歡迎加入 [LINE 社群](https://line.me/ti/g2/hP0Lg7mqvE5rvWg0sE9MHI-QsLkd94Cfp3wKcg) 或透過 [Issues](https://github.com/begin0808/Course_Scheduling_System/issues) 回報任何問題。

Expand Down
69 changes: 69 additions & 0 deletions backend/alembic/versions/0020_relink_swaps.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
"""v1.4.18:調課的補課節次接回目前已發布的課表(只修資料,不改資料表)。

調課記下補課那一節時記的是「課表的哪一格」。v1.4.17 以前,學期中重新發布課表後,
補課那一節還指著舊課表(已封存)的格子:週課表、巡堂表畫不出補課那一節,調課清單
也以為那一節還能再拿去調。v1.4.18 起發布時會自動接過去(`app.services.swap_relink`);
這裡把升級前已經發生的接回來,規則相同:目前已發布課表裡「同一門課(配課)、同一天、
涵蓋那一節」的格子。找不到的(新課表把那堂課移走了)維持原樣。

Revision ID: 0020_relink_swaps
Revises: 0019_homeroom_covers
"""

from datetime import date

import sqlalchemy as sa

from alembic import op

revision = "0020_relink_swaps"
down_revision = "0019_homeroom_covers"
branch_labels = None
depends_on = None


def _weekday(value) -> int:
d = value if isinstance(value, date) else date.fromisoformat(str(value)[:10])
return d.isoweekday()


def relink(conn) -> int:
"""回傳接上的筆數(測試也直接呼叫)。"""
rows = conn.execute(sa.text(
"""
SELECT s.id, s.swap_date, s.swap_period_no, oe.course_assignment_id, oe.period_no,
tp.id AS published_id
FROM substitutions s
JOIN schedule_entries oe ON oe.id = s.swap_entry_id
JOIN timetables tp ON tp.semester_id = s.semester_id AND tp.status = 'published'
WHERE s.type = 'swap' AND s.swap_date IS NOT NULL AND oe.timetable_id <> tp.id
"""
)).all()
moved = 0
for sub_id, swap_date, swap_period_no, assignment_id, old_period_no, published_id in rows:
period_no = swap_period_no if swap_period_no is not None else old_period_no
new_id = conn.execute(sa.text(
"""
SELECT id FROM schedule_entries
WHERE timetable_id = :tt AND course_assignment_id = :a AND weekday = :wd
AND period_no <= :p AND :p < period_no + span
ORDER BY id LIMIT 1
"""
), {"tt": published_id, "a": assignment_id, "wd": _weekday(swap_date),
"p": period_no}).scalar()
if new_id is None:
continue
conn.execute(sa.text(
"UPDATE substitutions SET swap_entry_id = :e, swap_period_no = :p WHERE id = :i"
), {"e": new_id, "p": period_no, "i": sub_id})
moved += 1
return moved


def upgrade() -> None:
relink(op.get_bind())


def downgrade() -> None:
# 接到新課表的格子是正確的資料,不還原
pass
3 changes: 2 additions & 1 deletion backend/app/api/timetables.py
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@
TimetableWeekOut,
)
from app.services import conflict_checker as cc
from app.services import timetable_check, timetable_week
from app.services import swap_relink, timetable_check, timetable_week
from app.services import timetable_publish as pub
from app.services.teachers import current_teacher

Expand Down Expand Up @@ -285,6 +285,7 @@ def publish_timetable(
# 條件 D:重新發布後,提醒仍有多少「今日之後」的調代課是依舊課表展開的
out = get_timetable(timetable_id, db, None)
out.stale_affected = pub.stale_future_affected_count(db, tt.semester_id)
out.swap_unlinked = swap_relink.unlinked_count(db, tt)
return out


Expand Down
2 changes: 2 additions & 0 deletions backend/app/schemas/timetable.py
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,8 @@ class TimetableOut(BaseModel):
entries: list[ScheduleEntryOut] = []
# 發布後回填:今日之後、依舊課表展開的受影響節次數(>0 提醒組長重新檢視調代課)
stale_affected: int = 0
# 發布後回填:今日之後的調課裡,補課那一節在新課表找不到同一堂課的筆數(v1.4.18)
swap_unlinked: int = 0


class ConflictOut(BaseModel):
Expand Down
Loading
Loading