From c1293cf52ea330b4eeaef7d0b1b79737c1ec466f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=8E=E4=BD=B3=E6=81=A9?= Date: Tue, 10 Nov 2026 22:29:47 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20=E8=B7=91=E7=8F=AD=205=20=E7=B5=84?= =?UTF-8?q?=E4=BB=A5=E5=85=A7=E5=88=97=E5=87=BA=E8=80=81=E5=B8=AB=E3=80=81?= =?UTF-8?q?=E5=85=88=E8=AA=BF=E8=AA=B2=E5=86=8D=E8=AB=8B=E5=81=87=E4=B8=8D?= =?UTF-8?q?=E9=87=8D=E8=A4=87=E5=88=97=E7=AF=80=E6=AC=A1=E3=80=81=E9=8A=B7?= =?UTF-8?q?=E5=81=87=E5=BE=8C=E4=BB=A3=E5=B0=8E=E9=A1=AF=E7=A4=BA;?= =?UTF-8?q?=E7=99=BC=E5=B8=83=20v1.4.16?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 班級、場地課表(畫面、匯出、某一週課表)的跑班格子改為 6 組以上才只寫「共 N 組」;巡堂表維持 4 - 登記請假時跳過已在別張有效假單或「調課(未請假)」裡的節次,回傳 skipped 讓畫面說明;代導照常產生 - 假單上的代導說明:銷假後寫「已銷假,代導已取消」,都安排好寫「都已處理」 Co-Authored-By: Claude Opus 5.5 --- .env.example | 2 +- CHANGELOG.md | 16 +++- README.md | 6 +- backend/app/api/leaves.py | 8 +- backend/app/schemas/leave.py | 10 +++ backend/app/services/leaves.py | 45 ++++++++-- backend/app/services/patrol_sheets.py | 3 + backend/app/services/timetable_export.py | 4 +- backend/app/services/timetable_week.py | 4 +- backend/tests/test_exports.py | 14 ++- backend/tests/test_full_flow.py | 2 +- backend/tests/test_leave_after_swap_v1416.py | 88 +++++++++++++++++++ docs/deploy/upgrade.html | 6 +- docs/deploy/upgrade.md | 4 +- docs/features.html | 11 +-- docs/index.html | 11 +-- docs/roadmap.html | 5 ++ docs/roadmap.md | 1 + frontend/src/api/leaves.ts | 8 ++ .../components/timetable/groupCells.test.ts | 13 ++- .../src/components/timetable/groupCells.ts | 5 +- frontend/src/views/leaves/Leaves.vue | 9 +- frontend/src/views/leaves/leaveText.test.ts | 37 ++++++++ frontend/src/views/leaves/leaveText.ts | 35 ++++++++ 24 files changed, 301 insertions(+), 46 deletions(-) create mode 100644 backend/tests/test_leave_after_swap_v1416.py create mode 100644 frontend/src/views/leaves/leaveText.test.ts create mode 100644 frontend/src/views/leaves/leaveText.ts diff --git a/.env.example b/.env.example index d61c1942..b247bfa1 100644 --- a/.env.example +++ b/.env.example @@ -32,7 +32,7 @@ HTTP_PORT=80 # ── 預建映像版本(僅「拉取映像」部署方式需要)────────── # 用 docker compose pull 拉官方映像時,決定要拉哪一版。 # 預設 latest(最新);正式部署建議釘選版本號以利可控升級,例如: -# IMAGE_TAG=v1.4.15 +# IMAGE_TAG=v1.4.16 # 若你是從原始碼 docker compose up -d 自行建置,此項可忽略。 IMAGE_TAG=latest diff --git a/CHANGELOG.md b/CHANGELOG.md index 83c65d65..84883fed 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,10 +4,24 @@ 破壞性變更(需人工介入才能升級)以 ⚠️ 標註。 -> **新使用者請直接安裝 v1.4.15**(見 [README](README.md) 快速開始)。v1.0.0 ~ v1.4.14 是先前版本;以下條目保留作為變更紀錄。 +> **新使用者請直接安裝 v1.4.16**(見 [README](README.md) 快速開始)。v1.0.0 ~ v1.4.15 是先前版本;以下條目保留作為變更紀錄。 ## [Unreleased] +## [1.4.16] — 2026-11-10 + +**修正:跑班顯示、先調課再請假**(LINE 社群組長回報)。 + +**資料表沒有變動**,照一般方式升級即可(`.env` 改 `IMAGE_TAG=v1.4.16` → `docker compose pull && docker compose up -d`)。 + +官方映像(amd64 + arm64 雙架構)已發布於 GHCR: +`ghcr.io/begin0808/course_scheduling_system-{api,worker,web}:v1.4.16` + +### 修正 +- **跑班 4、5 組也列出每位老師**:v1.4.13 起班級課表的跑班格子 4 組以上只寫「共 N 組」,數學、英語分組常有 4 組,看不到老師。改成 5 組以內都列出老師,6 組以上(社團這類)才寫群組名稱與組數。課表查詢、匯出(Excel、PDF、PNG)、看某一週的課表都一樣;巡堂表仍是 4 組以上另出分組巡堂單。 +- **先調課、再請假**:導師要外出一整天,組長先用「新增調課(未請假)」把當天的課調走,再登記請假讓系統排代導——那幾節原本又被列成「待處理」,怎麼處理都不對。現在已經在調課或別張有效假單裡的節次,登記請假時不再列入,完成訊息會寫出哪幾節已在哪一筆裡處理;代導照常產生。同一天重複登記兩張假,也不會再重複列出同樣的節次。 +- **銷假後的代導**:假單上「代導:…」那一行在銷假後仍寫「請到調代課處理安排代導老師」,改成「已銷假,代導已取消」;都安排好的寫「都已處理」。 + ## [1.4.15] — 2026-11-10 **新功能:課表查詢可以看某一週實際的課表;新增常用假別**(老師建議)。 diff --git a/README.md b/README.md index 903b42a9..54ea44d9 100644 --- a/README.md +++ b/README.md @@ -132,11 +132,11 @@ docker compose up -d # 首次會建置映像,需數分鐘 ## 專案狀態 -**v1.4.15 已發行(2026-11-10)。** 六大里程碑 M0–M5 全部完成,功能齊備並經完整驗收(後端 772 項單元/整合測試、61 項 Playwright 端對端測試涵蓋全部 20 個頁面,每次提交皆對真實 Docker 全棧跑過)。官方映像(amd64 + arm64)已發布於 GHCR。 +**v1.4.16 已發行(2026-11-10)。** 六大里程碑 M0–M5 全部完成,功能齊備並經完整驗收(後端 778 項單元/整合測試、61 項 Playwright 端對端測試涵蓋全部 20 個頁面,每次提交皆對真實 Docker 全棧跑過)。官方映像(amd64 + arm64)已發布於 GHCR。 -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.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.15` 是目前建議使用的版本。各版變更見 [CHANGELOG](CHANGELOG.md),開發歷程見 [docs/tasks.md](docs/tasks.md)。 +**請直接從最新版開始安裝**(見上方快速開始);`v1.4.16` 是目前建議使用的版本。各版變更見 [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) 回報任何問題。 diff --git a/backend/app/api/leaves.py b/backend/app/api/leaves.py index 0b7f3656..4eeaadee 100644 --- a/backend/app/api/leaves.py +++ b/backend/app/api/leaves.py @@ -34,6 +34,7 @@ LeaveRequestIn, LeaveRequestOut, LeaveUpdateIn, + SkippedPeriodOut, SwapRequestIn, ) from app.services import leaves as leave_service @@ -146,7 +147,7 @@ def create_leave( on_behalf = teacher.user_id != user.id try: - leave = leave_service.create( + leave, skipped = leave_service.create( db, sem, teacher, leave_type=body.leave_type, start_date=body.start_date, start_time=body.start_time, @@ -170,7 +171,10 @@ def create_leave( )) db.commit() db.refresh(leave) - return _serialize(leave) + out = _serialize(leave) + out.skipped = [SkippedPeriodOut(date=s.day, period_name=s.period_name, taken_by=s.taken_by) + for s in skipped] + return out @router.get("/leaves", response_model=list[LeaveRequestOut]) diff --git a/backend/app/schemas/leave.py b/backend/app/schemas/leave.py index aa4fb9e6..fe852ce2 100644 --- a/backend/app/schemas/leave.py +++ b/backend/app/schemas/leave.py @@ -73,6 +73,14 @@ class LeaveUpdateIn(BaseModel): reason: str | None = Field(default=None, max_length=200) +class SkippedPeriodOut(BaseModel): + """登記請假時沒列入的一節:它已經在別張假單或「調課(未請假)」裡(v1.4.16)。""" + + date: date + period_name: str + taken_by: str + + class DayPeriodOut(BaseModel): """這位老師這一天的一節課(新增調課時勾選,v1.4.5)。""" @@ -115,6 +123,8 @@ class LeaveRequestOut(BaseModel): affected_periods: list[AffectedPeriodOut] = [] homeroom_covers: list[HomeroomCoverOut] = [] cover_pending_count: int = 0 # 還沒安排的代導(天次) + # 只有登記時回傳:已經在別張假單或調課裡、這次沒列入的節次(v1.4.16) + skipped: list[SkippedPeriodOut] = [] class LeaveCancelled(BaseModel): diff --git a/backend/app/services/leaves.py b/backend/app/services/leaves.py index ad0240c3..f3130205 100644 --- a/backend/app/services/leaves.py +++ b/backend/app/services/leaves.py @@ -16,6 +16,7 @@ """ from collections.abc import Iterator +from dataclasses import dataclass from datetime import date, datetime, time, timedelta from sqlalchemy import select @@ -244,6 +245,15 @@ def expand_covers(db: Session, leave: LeaveRequest) -> list[HomeroomCover]: return out +@dataclass(frozen=True, slots=True) +class Skipped: + """登記請假時沒列入的一節:它已經在別張假單或調課裡(v1.4.16)。""" + + day: date + period_name: str + taken_by: str # 那張的假別名稱,例如「調課(未請假)」 + + def cover_is_past(day: date) -> bool: """代導以天為單位:那一天過完了才算代過(當天仍可改派、銷假仍會取消)。""" return day < clock.school_today() @@ -279,8 +289,13 @@ def create( created_by_user_id: int | None, created_by_name: str, notify_teacher: bool, -) -> LeaveRequest: - """登記請假並展開受影響節次。呼叫端負責 commit。""" +) -> tuple[LeaveRequest, list[Skipped]]: + """登記請假並展開受影響節次。呼叫端負責 commit。 + + 已經在別張有效假單或「調課(未請假)」裡的節次不再列入,回傳在第二個值(v1.4.16, + 組長回報:導師先把當天的課調走,再請假讓系統排代導,那兩節又變成待處理,怎麼處理都不對)。 + 同一節不能處理兩次——和「新增調課」的檢查同一條規則,只是反過來。 + """ validate(semester, start_date, end_date) if start_date == end_date and start_time and end_time and end_time <= start_time: raise LeaveError("結束時間不可早於開始時間") @@ -294,7 +309,13 @@ def create( db.add(leave) db.flush() + taken = taken_slots(db, teacher.id, start_date, end_date) + skipped: list[Skipped] = [] for period in expand(db, leave): + label = taken.get((period.date, period.period_no)) + if label: + skipped.append(Skipped(period.date, period.period_name, label)) + continue db.add(period) for cover in expand_covers(db, leave): db.add(cover) @@ -311,7 +332,7 @@ def create( title=f"{created_by_name} 已為您登記{LEAVE_TYPE_CN[leave.leave_type]}", body=body, ) - return leave + return leave, skipped def day_periods( @@ -329,19 +350,27 @@ def day_periods( return sorted(expand(db, probe), key=lambda p: p.period_no) -def taken_periods(db: Session, teacher_id: int, day: date) -> dict[int, str]: - """這一天已經在別張有效假單(或調課)裡的節次 → 那張的假別名稱。同一節不能處理兩次。""" +def taken_slots( + db: Session, teacher_id: int, start: date, end: date +) -> dict[tuple[date, int], str]: + """這段期間已經在有效假單(或調課)裡的節次 → 那張的假別名稱。同一節不能處理兩次。""" rows = db.execute( - select(AffectedPeriod.period_no, LeaveRequest.leave_type) + select(AffectedPeriod.date, AffectedPeriod.period_no, LeaveRequest.leave_type) .join(LeaveRequest, AffectedPeriod.leave_request_id == LeaveRequest.id) .where( LeaveRequest.teacher_id == teacher_id, LeaveRequest.status == LeaveStatus.registered.value, - AffectedPeriod.date == day, + AffectedPeriod.date >= start, + AffectedPeriod.date <= end, AffectedPeriod.status != AffectedStatus.cancelled.value, ) ).all() - return {no: LEAVE_TYPE_CN.get(lt, lt) for no, lt in rows} + return {(d, no): LEAVE_TYPE_CN.get(lt, lt) for d, no, lt in rows} + + +def taken_periods(db: Session, teacher_id: int, day: date) -> dict[int, str]: + """這一天已經在別張有效假單(或調課)裡的節次 → 那張的假別名稱。""" + return {no: label for (_, no), label in taken_slots(db, teacher_id, day, day).items()} def create_swap_request( diff --git a/backend/app/services/patrol_sheets.py b/backend/app/services/patrol_sheets.py index 5c4de829..2a443f80 100644 --- a/backend/app/services/patrol_sheets.py +++ b/backend/app/services/patrol_sheets.py @@ -42,6 +42,9 @@ CLASSES_PER_PAGE = 12 # A4 橫式一頁放得下的班級欄數(照使用學校的紙本) GROUP_LIST_MIN = 4 # 群組在同一節有幾門課以上,就改列成分組巡堂單 +# 班級、場地課表的一格:群組有幾組以上才只寫「共 N 組」(v1.4.16,組長回報:數學、英語分組 +# 有 4 組,原本門檻 4 看不到老師)。分組教學多半 5 組以內,社團才會更多。巡堂表另有分組巡堂單,維持 4。 +GRID_GROUP_LIST_MIN = 6 MAX_DAYS = 14 # 一次最多印幾天 _NOON = time(12, 0) diff --git a/backend/app/services/timetable_export.py b/backend/app/services/timetable_export.py index 7833a931..6ec29213 100644 --- a/backend/app/services/timetable_export.py +++ b/backend/app/services/timetable_export.py @@ -160,7 +160,7 @@ def _merge_groups(entries: list[_EntryView]) -> list[_EntryView]: 群組裡每位老師各是一筆格位,班級課表的一格原本只取其中一筆。 寫法同巡堂表與即時概況:組數少時科目、老師以「/」並列; - 社團這類 `GROUP_LIST_MIN` 組以上的大型跑班一格塞不下,只寫群組名稱與組數。 + 社團這類 `GRID_GROUP_LIST_MIN` 組以上的大型跑班一格塞不下,只寫群組名稱與組數。 """ out: list[_EntryView] = [] groups: dict[tuple[int | None, int, int], list[_EntryView]] = {} @@ -176,7 +176,7 @@ def _merge_groups(entries: list[_EntryView]) -> list[_EntryView]: out.append(first) continue span = max(m.span for m in members) - if len(members) >= patrol_sheets.GROUP_LIST_MIN: + if len(members) >= patrol_sheets.GRID_GROUP_LIST_MIN: out.append(replace(first, subject=first.unit_name, teachers=f"共 {len(members)} 組", room="", span=span)) continue diff --git a/backend/app/services/timetable_week.py b/backend/app/services/timetable_week.py index 0fdadf74..5181db77 100644 --- a/backend/app/services/timetable_week.py +++ b/backend/app/services/timetable_week.py @@ -20,7 +20,7 @@ from app.services import period_tables as pt_service from app.services import teacher_week_sheets as tw from app.services.availability import published_timetable -from app.services.patrol_sheets import GROUP_LIST_MIN, Day, join +from app.services.patrol_sheets import GRID_GROUP_LIST_MIN, Day, join from app.services.slip_layout import Tables _Date = date @@ -76,7 +76,7 @@ def _class_cells(db: Session, day: Day, klass: ClassUnit, tables: Tables) -> lis kind = next((_KIND.get(n, tw.NORMAL) for n in notes), tw.NORMAL) note = join([f"{x.note}(原:{x.original})" if x.original and x.teacher != x.original else x.note for x in lessons if x.note], "、") - big = lessons[0].is_group and len(lessons) >= GROUP_LIST_MIN + big = lessons[0].is_group and len(lessons) >= GRID_GROUP_LIST_MIN out.append(WeekCell( date=day.on, weekday=day.on.isoweekday(), ordinal=ordinal, period_no=period.period_no, diff --git a/backend/tests/test_exports.py b/backend/tests/test_exports.py index f8a7e28e..9db5428a 100644 --- a/backend/tests/test_exports.py +++ b/backend/tests/test_exports.py @@ -323,12 +323,20 @@ def test_class_grid_lists_every_group_teacher(env): assert lines == [("英語", "師0/師1")] -def test_class_grid_big_group_shows_name_and_count(env): - """社團這類 4 組以上的跑班:一格塞不下,寫群組名稱與組數(同巡堂表)。""" +def test_class_grid_lists_five_groups(env): + """v1.4.16 組長回報:數學分組有 4 組,原本只寫「共 4 組」看不到老師。5 組以內都列出來。""" w = _group_world(env, 5) grid, _ = tex.build_grid(w.db, w.sid, "class", w.classes["701"]) lines = [c.lines for r in grid.rows for c in r.cells if c.lines] - assert lines == [("九年級英語分組", "共 5 組")] + assert lines == [("英語", "師0/師1/師2/師3/師4")] + + +def test_class_grid_big_group_shows_name_and_count(env): + """社團這類 6 組以上的跑班:一格塞不下,寫群組名稱與組數。""" + w = _group_world(env, 6) + grid, _ = tex.build_grid(w.db, w.sid, "class", w.classes["701"]) + lines = [c.lines for r in grid.rows for c in r.cells if c.lines] + assert lines == [("九年級英語分組", "共 6 組")] # 教師課表只看自己那一組 grid, _ = tex.build_grid(w.db, w.sid, "teacher", w.teachers["師3"]) lines = [c.lines for r in grid.rows for c in r.cells if c.lines] diff --git a/backend/tests/test_full_flow.py b/backend/tests/test_full_flow.py index df8b1ce0..c16e0aab 100644 --- a/backend/tests/test_full_flow.py +++ b/backend/tests/test_full_flow.py @@ -106,7 +106,7 @@ def test_full_pipeline_per_track(name, builder, db): assert teacher is not None leave_day = _first_date_with_isoweekday(weekday) - leave = leave_svc.create( + leave, _ = leave_svc.create( db, fx.semester, teacher, leave_type=LeaveType.personal.value, start_date=leave_day, start_time=None, end_date=leave_day, end_time=None, diff --git a/backend/tests/test_leave_after_swap_v1416.py b/backend/tests/test_leave_after_swap_v1416.py new file mode 100644 index 00000000..c5b2fa22 --- /dev/null +++ b/backend/tests/test_leave_after_swap_v1416.py @@ -0,0 +1,88 @@ +"""先調課、再請假(v1.4.16,LINE 社群組長回報)。 + +導師那天要外出一整天:組長先用「新增調課(未請假)」把他當天的課調走, +再登記請假讓系統排代導。原本請假又依固定課表把那幾節列成「待處理」—— +已經調走的課,再調一次、選停課都不對,待處理就一直掛著。 + +規則:同一節不能處理兩次。已經在別張有效假單或調課裡的節次,登記請假時不再列入, +回傳在 `skipped` 讓畫面說明;代導照常產生(導師人不在)。 +""" + +from tests.dates import WED, WED2 +from tests.test_homeroom_cover import _homeroom, _leave +from tests.test_substitutions import _find_entry, env2 # noqa: F401 - env2 為 fixture +from tests.test_swap_without_leave import _create, _school + + +def _swap_first(w) -> dict: + """王師週三兩節都放進「調課(未請假)」,第一節和陳師對調。""" + code, req = _create(w, [w.wed[0]["period_no"], w.wed[1]["period_no"]]) + assert code == 201, req + ap = req["affected_periods"][0] + code, body = w.assign(ap["id"], type="swap", handler_teacher_id=w.teachers["陳師"], + swap_entry_id=_find_entry(w, "陳師"), swap_date=WED2.isoformat()) + assert code == 200, body + return req + + +def test_leave_skips_periods_already_swapped(env2): # noqa: F811 + w = env2 + _school(w) + _homeroom(w, "701", "王師") + _swap_first(w) + + leave = _leave(w, "王師", WED) + assert leave["affected_periods"] == [], "兩節都已在調課裡,不再列成待處理" + assert leave["pending_count"] == 0 + assert [(s["period_name"], s["taken_by"]) for s in leave["skipped"]] == [ + (w.wed[0]["name"], "調課(未請假)"), (w.wed[1]["name"], "調課(未請假)")] + assert len(leave["homeroom_covers"]) == 1, "導師人不在,照樣要代導" + + # 之後再讀假單,不再帶 skipped(只有登記當下回傳) + again = w.client.get(f"/api/leaves/{leave['id']}").json() + assert again["skipped"] == [] and again["affected_count"] == 0 + + +def test_leave_keeps_periods_not_yet_handled(env2): # noqa: F811 + """只調走第一節:請假只列第二節。""" + w = env2 + _school(w) + code, req = _create(w, [w.wed[0]["period_no"]]) + assert code == 201, req + + leave = _leave(w, "王師", WED) + assert [p["period_name"] for p in leave["affected_periods"]] == [w.wed[1]["name"]] + assert [s["period_name"] for s in leave["skipped"]] == [w.wed[0]["name"]] + + +def test_second_leave_on_same_day_does_not_duplicate(env2): # noqa: F811 + """同一天重複登記兩張假:第二張不再重複列出同樣的節次。""" + w = env2 + _school(w) + first = _leave(w, "王師", WED) + assert len(first["affected_periods"]) == 2 and first["skipped"] == [] + second = _leave(w, "王師", WED) + assert second["affected_periods"] == [] + assert {s["taken_by"] for s in second["skipped"]} == {"事假"} + + +def test_cancelled_swap_no_longer_blocks(env2): # noqa: F811 + """調課已銷假,那兩節回到王師身上:請假照常列入。""" + w = env2 + _school(w) + req = _swap_first(w) + assert w.client.post(f"/api/leaves/{req['id']}/cancel").status_code == 200 + + leave = _leave(w, "王師", WED) + assert len(leave["affected_periods"]) == 2 and leave["skipped"] == [] + + +def test_other_teachers_and_days_unaffected(env2): # noqa: F811 + """只看同一位老師、同一天的節次。""" + w = env2 + _school(w) + _swap_first(w) + chen = _leave(w, "陳師", WED) + assert len(chen["affected_periods"]) == 1 and chen["skipped"] == [] + next_week = _leave(w, "王師", WED2) + assert len(next_week["affected_periods"]) == 2 and next_week["skipped"] == [] diff --git a/docs/deploy/upgrade.html b/docs/deploy/upgrade.html index bcbdff3d..81df59ee 100644 --- a/docs/deploy/upgrade.html +++ b/docs/deploy/upgrade.html @@ -172,7 +172,7 @@ 路線圖開發用 開發任務卡開發用 -
本頁目錄
+
本頁目錄
@@ -190,8 +190,8 @@

升級指南

開始前先備份。 升級本身不會刪資料,但任何重大操作前留一份備份是好習慣。到「系統管理 → 資料備份與還原 → 立即備份」,或見備份指南。

-

升級到 v1.4.2 ~ v1.4.15:補登、修改假別與計費方式、未請假的調課、批次 PDF、登入鎖定資安修正

-

v1.4.2(補登)、v1.4.3(操作紀錄修正)、v1.4.4(修改假別與計費方式)、v1.4.5(未請假的調課)、v1.4.6(全校課表匯出 PDF)、v1.4.7(登入鎖定資安修正,建議升級)、v1.4.8(自動排課自動建立草稿)、v1.4.9(同一天幾節一起調課)、v1.4.10(補登調課)、v1.4.11(鐘點統計自訂區間)、v1.4.12(調課從較早的週開始找、換不了的原因)、v1.4.13(跑班群組在班級課表的顯示)、v1.4.14(全校教師週總表)、v1.4.15(某一週實際課表、新增假別)都沒有資料表變更,照下方方式 A 或方式 B 一般升級即可。

+

升級到 v1.4.2 ~ v1.4.16:補登、修改假別與計費方式、未請假的調課、批次 PDF、登入鎖定資安修正

+

v1.4.2(補登)、v1.4.3(操作紀錄修正)、v1.4.4(修改假別與計費方式)、v1.4.5(未請假的調課)、v1.4.6(全校課表匯出 PDF)、v1.4.7(登入鎖定資安修正,建議升級)、v1.4.8(自動排課自動建立草稿)、v1.4.9(同一天幾節一起調課)、v1.4.10(補登調課)、v1.4.11(鐘點統計自訂區間)、v1.4.12(調課從較早的週開始找、換不了的原因)、v1.4.13(跑班群組在班級課表的顯示)、v1.4.14(全校教師週總表)、v1.4.15(某一週實際課表、新增假別)、v1.4.16(跑班顯示、先調課再請假)都沒有資料表變更,照下方方式 A 或方式 B 一般升級即可。

升級到 v1.4.1:授權改為 AGPL-3.0

v1.4.1 只改了授權(由 MIT 改為 AGPL-3.0),並在登入頁與側邊欄加上「原始碼」連結。功能與資料表都沒有變動, 照下方方式 A 或方式 B 一般升級即可;從 v1.3.x 或更早的版本升上來,一樣會經過 v1.4.0 的資料表變更(會先自動備份)。

diff --git a/docs/deploy/upgrade.md b/docs/deploy/upgrade.md index 799319fb..a5cbd19a 100644 --- a/docs/deploy/upgrade.md +++ b/docs/deploy/upgrade.md @@ -8,9 +8,9 @@ > **開始前先備份。** 升級本身不會刪資料,但任何重大操作前留一份備份是好習慣。到「系統管理 → 資料備份與還原 → 立即備份」,或見[備份指南](backup.md)。 -## 升級到 v1.4.2 ~ v1.4.15:補登、修改假別與計費方式、未請假的調課、批次 PDF、登入鎖定資安修正 +## 升級到 v1.4.2 ~ v1.4.16:補登、修改假別與計費方式、未請假的調課、批次 PDF、登入鎖定資安修正 -v1.4.2(補登)、v1.4.3(操作紀錄修正)、v1.4.4(修改假別與計費方式)、v1.4.5(未請假的調課)、v1.4.6(全校課表匯出 PDF)、v1.4.7(登入鎖定資安修正,**建議升級**)、v1.4.8(自動排課自動建立草稿)、v1.4.9(同一天幾節一起調課)、v1.4.10(補登調課)、v1.4.11(鐘點統計自訂區間)、v1.4.12(調課從較早的週開始找、換不了的原因)、v1.4.13(跑班群組在班級課表的顯示)、v1.4.14(全校教師週總表)、v1.4.15(某一週實際課表、新增假別)都沒有資料表變更,照下方方式 A 或方式 B 一般升級即可。 +v1.4.2(補登)、v1.4.3(操作紀錄修正)、v1.4.4(修改假別與計費方式)、v1.4.5(未請假的調課)、v1.4.6(全校課表匯出 PDF)、v1.4.7(登入鎖定資安修正,**建議升級**)、v1.4.8(自動排課自動建立草稿)、v1.4.9(同一天幾節一起調課)、v1.4.10(補登調課)、v1.4.11(鐘點統計自訂區間)、v1.4.12(調課從較早的週開始找、換不了的原因)、v1.4.13(跑班群組在班級課表的顯示)、v1.4.14(全校教師週總表)、v1.4.15(某一週實際課表、新增假別)、v1.4.16(跑班顯示、先調課再請假)都沒有資料表變更,照下方方式 A 或方式 B 一般升級即可。 ## 升級到 v1.4.1:授權改為 AGPL-3.0 diff --git a/docs/features.html b/docs/features.html index 9bd69111..1ae78e33 100644 --- a/docs/features.html +++ b/docs/features.html @@ -3,7 +3,7 @@ - + 功能總覽 · 排課與調代課系統