GradeAdjustment（等第調整記錄）
ExamParticipant 的調分記錄表。每次主管/HR 調整分數或等第，都在此寫入一筆。
與 GradeOverrideLog 的差異
容易混淆，但是兩個不同概念：
| GradeAdjustment | GradeOverrideLog | |
|---|---|---|
| 記錄什麼 | 分數/等第本身的變動 | 調整的原因說明文字 |
| 欄位重點 | OriginalScore/AdjustedScore | Reason 文字 |
| 觸發時機 | 任何分數異動 | 超額/不足/主動填寫原因時 |
| 累積方式 | 每次調整一筆 | 累積，退回不覆蓋 |
實務上兩者並用：先寫 GradeAdjustment 記錄分數變動，再寫 GradeOverrideLog 記錄為什麼變。
主要欄位
| 欄位 | 說明 |
|---|---|
Id | PK |
ParticipantId | 關聯到 ExamParticipant |
Scope | "MidYear" / "YearEnd" / "Annual" |
OriginalScore | 調整前 |
AdjustedScore | 調整後 |
OriginalGrade | 調整前等第 |
AdjustedGrade | 調整後等第 |
AdjustedBy | 調整人 |
AdjustedAt | 時間戳 |
Reason | 簡短原因 |
Scope 區分（重要）
| 值 | 何時用 |
|---|---|
MidYear | 年中考核期間調整 |
YearEnd | 年終考核期間調整 |
Annual | 年度結算階段調整（年度結算流程） |
超額說明歷程 的查詢規則會依 Scope 過濾：
- 考核表單審核歷程：排除
Scope == "Annual" - 年度結算頁面：優先顯示
Scope == "Annual"
FinalScore 重算保護
主管交接時，孤立記錄清理後重算 FinalScore 必須優先使用 GradeAdjustment：
- 有 GradeAdjustment → 使用最後一筆的
AdjustedScore/AdjustedGrade - 沒有 → 從 ExamRecord 重算 ScoreD
涉及精度
OriginalScore 與 AdjustedScore 同樣是 decimal(6,3)，支援 0.125 公式產生的 3 位小數。
相關概念
強連結（原文明確提及）
- 超額說明歷程 — 配對使用，記錄原因
- 年度結算流程 — Annual scope 來源
- 等第審核流程 — MidYear/YearEnd scope 來源
- 主管交接 — 重算保護
- 分數精度
- GradingService — 調整後仍用此服務算等第
← 回到 wiki