Skip to content

feat: 三角調課(v1.4.20) - #85

Merged
begin0808 merged 1 commit into
mainfrom
feat/triangle-swap
Nov 17, 2026
Merged

begin0808 merged 1 commit into
mainfrom
feat/triangle-swap

Conversation

@begin0808

Copy link
Copy Markdown
Owner

三角調課(v1.4.20)

組長拿別家系統的畫面來問「會出三角調課嗎?」。兩人互調湊不出來時,同一班三位老師輪流換課:
乙來上請假那節、丙來上乙原本的一節、請假的老師回來上丙原本的一節。

規則(使用者 2026-11-17 同意)

  1. 只限同一個班(一位老師上的一般課;跑班、單雙週組、協同教學不列)
  2. 請假老師發起,系統列出可行的三人組合
  3. 範圍與互調相同(預設兩週、最多四週、可從較早的週開始找)
  4. 鐘點都不計
  5. 調課單:三位老師各一張、班級一張
  6. 撤回(或銷假)三格一起撤
  7. 三角調的節次不能再調

做法

  • 遷移 0022_triangle_swaps:substitutions 新增 tri_teacher_id 與 tri_*(乙原本那一節,改由丙上),全部可為空;既有資料不變。swap_* 仍是「請假老師回來上的那一節」,此時是丙的課。
  • 新模組 services/swap_legs.py:一筆調課換人上的每一格。巡堂表、週課表、教師週總表、調課單、調代課紀錄、停課衝突都改用它。
  • swap_options.triangle_search(新 API GET /affected-periods/{id}/triangle-options)與送出時的 substitutions._validate_triangle 共用 SwapChecker。
  • 可用時段:丙在中間那一節算已安排;_taken_slots 含三角的兩格;重新發布時兩格一起接到新課表。
  • 順手修正:對方那一節已經在他自己的「調課(未請假)」裡時,不再列為可對調。
  • 前端:調課面板「兩人互調/三角調課」切換;處置、看板、公告單、紀錄文字。

驗證

  • 後端 804 passed(新增 12 項)、ruff、mypy
  • 前端 lint、vue-tsc、vitest 81 passed
  • 主環境(dev 映像,PostgreSQL 遷移 0021 → 0022,升級前自動備份)e2e 63 passed(新增 triangle-swap.spec.ts)
  • 測試資料一律用假名

🤖 Generated with Claude Code

- 遷移 0022:substitutions 新增 tri_teacher_id 與 tri_*(乙原本那一節,改由丙上),可為空
- services/swap_legs.py:一筆調課換人上的每一格(互調兩格、三角三格),巡堂表、週課表、
  教師週總表、調課單、調代課紀錄、停課衝突共用
- swap_options.triangle_search 與 substitutions._validate_triangle 共用 SwapChecker;
  只限同一班、一位老師上的一般課;三角調的節次不能再調
- 通知三位老師;撤回、銷假一起撤並通知丙;重新發布課表兩節一起接到新課表
- 修正:對方那一節已在他自己的調課(未請假)裡時,不再列為可對調
- 前端調課面板「兩人互調/三角調課」切換;手冊 8.3、FAQ、CHANGELOG、升級與退回說明

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@begin0808
begin0808 merged commit a5ec7fa 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