Skip to content

feat: 停課日;發布 v1.4.19 - #84

Merged
begin0808 merged 1 commit into
mainfrom
feat/class-suspensions
Nov 17, 2026
Merged

begin0808 merged 1 commit into
mainfrom
feat/class-suspensions

Conversation

@begin0808

Copy link
Copy Markdown
Owner

背景

組長回報:「停課日在哪邊可以設定?」系統原本只有請假節次的「不處理(當天停課)」,只管請假老師的那一節,不知道全校或整個班停課。

做了什麼

停課日(「調代課 → 停課日」):日期或期間 × 對象(全校,或指定年級/班級;勾年級 = 勾整個年級的班)× 範圍(整天,或第幾節到第幾節,只數一般課、依各班自己的節次表)。

停課的課:

  • 請假時不列為受影響節次(登記結果寫出哪幾節停課);整天停課的班不產生代導
  • 調課清單不能拿停課的那一節補課(列在「換不了」並寫原因;送出時同一套檢查)
  • 巡堂表、某一週課表、教師週總表、即時概況標「停課」,優先於當天調代課;全校整天停課的日子巡堂表與教師週總表略過
  • 合班、跑班要每一個班都停課才算
  • 事後設的停課不自動改已安排的調代課(可能已通知老師),儲存時列出讓組長處理

資料表:新增 class_suspensions、class_suspension_classes(遷移 0021,只新增,升級前自動備份)。

另外:e2e「系統管理」備份測試原本比對備份數量 +1,備份滿 30 份時建立新的會輪替掉最舊的一份,數量不變而失敗;改成檢查最上面多了一份新的。

驗證

  • 後端 792 項(新增 9 項 test_suspensions_v1419.py)、ruff、mypy
  • 前端 lint、vue-tsc、vitest 78 項
  • 主環境以 dev 映像升級:自動備份後 PostgreSQL 跑 0020 → 0021;e2e 62 項全過(新增 suspensions.spec.ts)
  • 文件:手冊 8.11 與 FAQ、架構、升級指南(含退回 v1.4.18)、CHANGELOG、功能總覽、README

🤖 Generated with Claude Code

組長回報「停課日在哪邊可以設定?」。系統原本只有請假節次的「不處理(當天停課)」,
不知道全校或整個班停課。

- 新增 class_suspensions / class_suspension_classes(遷移 0021,只新增資料表)
- services/suspensions.py:一門課的每一個班都停課才算停課;第幾節依各班節次表換算
- 請假展開不列停課節次(回傳 skipped「停課(…)」),整天停課的班不產生代導
- 調課清單:停課的那一節不能拿來補課(SwapChecker.reason,送出時同一套檢查)
- patrol_sheets.Day 標「停課」並優先於當天調代課;全校整天停課的日子巡堂表、教師週總表略過
- 事後設的停課不自動改已安排的調代課,儲存時回傳 conflicts
- 前端「調代課 → 停課日」頁;請假登記訊息寫出停課節次
- e2e 系統管理備份測試改為不依賴備份數量(滿 30 份時會輪替)
- 文件:手冊 8.11 與 FAQ、架構、升級指南(含退回 v1.4.18)、CHANGELOG、功能總覽

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@begin0808
begin0808 merged commit 3d66cb0 into main Nov 17, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant