GradeReviewService

部門確認/退回核心服務（Confirm/Return Department）+ 主管端 SubmitDepartment。

主要方法

方法	用途
ConfirmDepartmentAsync	HR 確認虛擬部門等第審核完成
ReturnDepartmentAsync	退回給主管修正
SubmitDepartmentAsync	主管端提交（從 ReviewController 委派）

流程位置

等第審核：
  部門全員完成 → 主管調整等第 → 提交（SubmitDepartment）→ 
  HR 確認（ConfirmDepartment）→ 考核等第已確認

退回：
  主管端任何階段 → 退回上一關（清除 FinalScore/FinalGrade/IsLocked）

A3 重構

• ReviewController.SubmitDepartmentAsync 委派此服務（~370 行 → ~22 行薄殼）
• 天花板/配額/Confirmation/稽核全保留行為

DepartmentConfirmation 欄位

欄位	值
ConfirmationType	"GradeReview"（等第審核）vs "Settlement"（年度結算）
Status	Pending → Submitted → Confirmed（可 Returned）

等第審核與年度結算用同一 API 端點，透過 ?type=GradeReview / ?type=Settlement 區分。

自動公告

ConfirmDepartmentAsync 確認後寫入「【部門】X 年 Y 考核已全數完成！」公告（詳見 公告系統）。

相關概念

強連結（原文明確提及）

• 等第審核流程
• SettlementService — 結算階段使用同 API
• 退回流程
• 超額說明歷程 — 退回時的紀錄

← 回到 wiki