NAPAICP 平台管理操作手冊

3.1. 總覽（Dashboard）

顯示啟用中使用者數、已停權使用者數、競賽總數、進行中競賽數、評審關係數、平台管理員數等聚合指標，以及「近期平台稽核」列表（跨所有競賽的最新治理操作）。若部分指標本次無法計算，畫面會標示「部分降級」而不是整頁失敗，其餘資料仍準確可信。

3.2. 使用者

平台上所有帳號的清單，含帳號狀態、全域角色與各競賽角色摘要。可依姓名／Email 搜尋、依帳號狀態與競賽角色篩選，並可只顯示具有效評審角色者。點入任一使用者進入使用者詳細資料頁，內含分頁：

「帳號與安全」分頁的操作與影響：

• 停權使用者（Suspend）：立即撤銷該帳號所有進行中 session，帳號在恢復前無法登入。不會刪除任何投稿、評分、結果或稽核歷史（帳號停權 ≠ 個資刪除）。
• 恢復使用者（Reactivate）：帳號可再次登入。
• 撤銷所有工作階段（Revoke sessions）：立即撤銷此使用者目前所有 session，但不停權帳號本身，使用者仍可重新登入。
• 授予平台管理員（Grant super admin）：立即授予平台全站所有平台管理權限，於下一次請求生效。
• 撤銷平台管理員（Revoke super admin）：立即撤銷所有平台管理權限。若此帳號是平台最後一位啟用中的 Super Admin，伺服器會拒絕此操作（最後管理員保護）。

每一項高敏感動作都是一個確認對話框：顯示對象、範圍、預期影響，並要求填寫原因（必填）後才能送出；失敗時不會變更任何資料。

3.3. 競賽人員

先選擇一場競賽（可依名稱／代稱搜尋），再查看該競賽內所有持有角色的人員，並可依角色篩選。此頁是唯讀視圖，實際授予/撤銷角色請在使用者詳細資料頁（3.2）或該競賽自己的「成員與角色」頁（4.6）操作。

3.4. 評審

每一列代表一組「使用者 × 競賽」評審關係，同一人評審兩場競賽會出現兩列。可依姓名／Email 或單一競賽 ID 篩選。欄位包含檔案狀態（是否已設定評審檔案）、指派數、已提交分數、已鎖定分數、衝突數與完成度。

3.5. 平台管理員

列出目前持有平台級 super_admin 權限的所有帳號，含授予時間、授予者與近期稽核。可依姓名／Email 搜尋。若某帳號是「最後一位啟用中管理員」，其撤銷操作會被標示為不可執行。這是撤銷/授予 super_admin 的主要操作入口（等同於在使用者詳細資料頁的「帳號與安全」分頁操作）。

3.6. 稽核

跨所有競賽的平台治理操作紀錄，唯讀，沒有編輯或刪除功能。可依操作者使用者 ID、對象使用者 ID、競賽 ID、操作類型與時間區間篩選。每筆紀錄包含 actor、target、competition（如適用）、before/after、reason、timestamp 與 correlation ID，用於事後調查。

4.1. 建立競賽

在競賽清單頁點「新增競賽」，只需填寫名稱、網址代稱（小寫連字號、平台唯一）、年度、顯示時區與簡短介紹即可建立。競賽會以草稿狀態建立，在排程設定完成前參與者皆無法看見；其餘設定（排程、資格條件、類別、表單、評分規準…）都在建立後於「總覽」等分頁完成。

4.2. 總覽：基本資訊 / 排程 / 資格條件 / 狀態 / 準備清單

• 基本資訊：名稱、網址代稱、簡短介紹。
• 排程：報名開始/截止、作品繳交開始/截止、評審開始/結束、結果發布，以瀏覽器當地時區輸入，以 UTC 儲存；調整截止時間會記錄稽核。
• 資格條件：隊伍最小/最大人數、是否可含指導老師、是否須有指導老師、是否可多次繳交作品、是否啟用匿名評審。
• 狀態：競賽狀態預設由排程自動推算；管理員可「固定狀態」覆蓋自動結果（需填寫原因），直到取消固定為止，底層排程仍持續計算。
• 準備狀態清單：基本資訊、排程、資格條件、類別、動態表單、評分規準、評審設定、公開頁面、發布，逐項顯示「已就緒 / 尚未開始 / 平台尚未提供」，作為上線前檢查表。
• 設定：公開聯絡信箱、公開競賽頁面是否上線。

4.3. 類別

競賽下的分組（例如高中組、大專組），名稱僅需在同一競賽內不重複，可設定名額上限。類別只能封存而不能刪除，確保曾參照它的隊伍仍能正常顯示歷史資料。

4.4. 賽程輪次

競賽預設為單輪賽制；新增決賽輪次即可啟用「初賽書面審查 → 入圍 → 決賽」的雙階段賽制（一場競賽最多兩輪：preliminary 初賽、final 決賽，這是憲章層級的固定上限）。每輪可獨立設定名稱、狀態（草稿/開放中/評審中/已結束）、提交表單與預設評分表。

4.5. 表單

為每一輪建立動態欄位表單。重要：發布後再編輯表單會複製出新的草稿版本，不會變更目前上線中的內容，已綁定舊版本的繳交資料能永遠依當時的確切 schema 正確顯示。表單編輯器支援欄位排序、必填、驗證規則（最短/最長長度、格式、最小/最大值、允許副檔名）與條件顯示（依其他欄位的值顯示/隱藏）。

4.6. 成員與角色

角色僅適用於此競賽，同一帳號在不同競賽可有不同角色。以電子郵件授予角色（該帳號須至少登入過一次），可選角色為 competition_admin、staff、student、teacher、judge、observer。可撤銷既有角色。

4.7. 隊伍管理

查看此競賽所有隊伍與隊員，可移除隊員、轉移隊長（需填寫原因），或建立一次性邀請連結交給要加入的隊員（v1 為手動流程，沒有直接新增隊員的端點；連結可撤銷）。所有操作皆寫入稽核紀錄。

4.8. 作品繳交與檔案

作品繳交頁列出此競賽所有團隊的投稿紀錄，可依狀態、類別、團隊 ID 篩選；點入單筆可看填答內容與已提交版本，每次提交都是不可變快照，版本建立後內容永不變更。檔案頁列出所有上傳檔案，可依狀態或投稿 ID 篩選並產生短效下載連結；作品物件永遠是 private，瀏覽器只能透過範圍受限的簽章操作存取。

4.9. 評審邀請與指派

先在「成員與角色」（4.6）把某帳號設定為 judge 角色，或直接在此頁以 Email 邀請。此頁包含三個區塊：

• 邀請評審：輸入 Email 送出邀請。若該 Email 尚未有帳號，系統自動建立帳號並以 Email 寄送一次性臨時密碼；評審登入後會被強制立即設定新密碼，管理員全程不會看到密碼。邀請紀錄顯示狀態（待接受/已接受/已取消/已過期），可重新發送（會使舊臨時密碼立即失效）或取消邀請。詳見第 5 節安全規範。
• 手動指派評審：勾選作品（可複選）與評審（可複選）並指定評分標準版本，系統會建立每個「作品 × 評審」的組合；重複指派與利益衝突會自動略過並顯示原因。自動指派功能尚未實作。
• 目前的指派：此競賽所有評審與作品的指派關係列表，可編輯（僅限「進行中」狀態的指派）或取消。

4.10. 評分規準

建立評分項目（名稱、說明、權重、最小/最大分數）；所有項目權重總和須等於 100 才能儲存。已鎖定的分數不會因規準調整而原地變更，已鎖定 score 不得原地修改，管理員重新開放須附理由並建立 revision history。可為版本設定標籤方便辨識。

4.11. 結果與晉級

計算結果執行（result run）、檢視名次與獎項分級（AWARD_TIERS），必要時可覆寫（override）單一結果並附理由。若競賽有下一輪（決賽），可在此把某輪的最新結果轉為「晉級名單」勾選清單，可勾選特定隊伍或用「取前 N 名」快速選取，再送出建立晉級關係。晉級與獎項永遠由人員決定，系統不會自動判定（憲章範圍外規定）。

4.12. 競賽稽核紀錄

此競賽範圍內的稽核紀錄，僅供新增，無法在此或任何其他地方編輯或刪除。可依動作（如 role.grant）、對象（如 submission）與時間區間篩選，並可檢視每筆紀錄的變更內容細節。