NAPAICP 主辦方操作手冊

0. 角色與權限

本手冊涵蓋兩種 Competition-scoped 角色：competition_admin（可管理自己負責的競賽的完整設定）與 staff（依授予的權限協助營運）。兩者的實際可執行範圍以畫面上顯示的可用操作為準，最終授權判斷一律在伺服器端執行；介面上看不到某個按鈕，不代表該操作真的被禁止，反過來，介面上看得到，也不保證一定成功，伺服器仍會重新驗證權限。

1. 建立競賽

• 建立競賽：建立新競賽並填寫基本資料（名稱、簡介、公開頁面內容）。
• 競賽狀態：競賽有多個狀態（例如尚未開始、報名開放、投稿階段、評審中、已結束），實際可用的狀態轉換以畫面顯示為準。
• 報名／投稿／評審／結果時程：設定各階段的起訖時間；每個 Round（初賽／決賽）可以有各自獨立的時程。
• Eligibility：設定參賽資格條件，公開頁面會顯示給潛在參賽者參考。
• Categories／組別：視需要建立競賽組別，供報名與後續評審、結果依組別區分。
• Rounds／初賽／決賽：視需要建立多輪賽制；只有明確晉級的隊伍才能進入下一輪。

2. 表單

• 報名表單：建立報名表單並命名；建立時必須輸入名稱，不會自動套用通用型別文字。
• 投稿表單：建立作品繳交表單，定義參賽者需要填寫與上傳的內容。
• 表單版本與發布：表單可版本化管理；已發布的版本不可再修改內容，需要調整時建立新版本並重新發布。既有表單可以重新命名。

3. 隊伍與人員

• Competition People / Roles：查看該競賽內所有具角色的使用者，並依角色篩選。
• Staff 管理：授予或調整 staff 的參與，依需要的權限範圍指派。
• 隊伍管理：查看與管理已建立的隊伍，必要時協助處理隊伍相關的個案問題。
• 投稿與檔案檢查：查看各隊伍的投稿狀態與已上傳檔案，掌握整體投稿進度。

4. 評審設定

• 建立評審：新增評審資料，準備發送邀請。
• 發送評審邀請：直接在管理介面輸入評審 Email 送出邀請，可查看邀請紀錄，對待接受的邀請重新發送或取消。
• 評審指派：將作品指派給評審，可支援批次勾選多件作品與多位評審、對同一評分標準版本一次建立所有組合；重複或有利益衝突的組合會被略過並回報原因，不會讓整批請求失敗。
• Conflict of Interest：查看與處理評審申報的利益衝突，有效衝突的指派不會產生有效的正式評分。
• Rubric／評分規準：建立評分規準與評分項目，每個評分項目可填寫定義說明；評分規準的個別版本可以命名（例如「初賽」「決賽」）。
• 評分進度：追蹤各評審的評分進度，掌握截止前是否有尚未完成的指派。

5. 成績與結果

• 評分鎖定 / 重開：評審正式送出的分數會鎖定；需要修改時由主辦方執行重開，重開會建立對應的修改紀錄，不是直接覆蓋。
• 成績計算：依 Round 與可選 Category 計算成績，建立成績運算結果（result run）。
• 人工覆核：計算結果建議在鎖定前人工覆核，確認無誤。
• 晉級：明確將符合資格的隊伍從初賽晉級決賽；晉級操作具冪等性，重複執行不會造成重複晉級。
• 獎項／名次：確認獎項標籤後即可準備公布。
• 公布結果：鎖定並公布結果後，該次結果即不可再變更；公布前的所有調整都應在鎖定前完成。

6. 營運操作

• Deadline 延長：若發生重大平台故障或其他正當理由，主辦方可延長截止時間，此操作會產生對應的稽核紀錄。
• Audit Log：查看該競賽的操作紀錄（成績、權限、重要狀態異動），稽核紀錄唯讀，不提供刪除或修改。
• 匯出／報表：將畫面上已載入的清單資料匯出為 TSV 或 Excel，方便另行分析或存檔。
• 賽後成果頁／Showcase：競賽結束後可視需要保留成果展示頁；是否收錄個別作品，應遵循該作品參賽者的授權意願（opt-in），詳見資料保存政策的「作品權利」章節。

• 介面上是否顯示某個按鈕，不是真正的權限依據；真正的授權判斷一律在伺服器端執行，即使直接呼叫 API 也一樣會被檢查。
• competition_admin 與 staff 的可執行範圍不同，實際差異以畫面顯示的可用操作為準；不確定時請以較保守的假設操作，避免誤觸高敏感功能。
• 涉及權限、成績、Deadline、結果公布、評分鎖定/重開的操作都會留下稽核紀錄，包含操作者、時間與原因；不要把這些操作當成可以無痕撤回的動作。
• 結果一旦鎖定並公布即不可變更，公布前務必完成所有覆核。
• 競賽管理僅限於自己被授權的競賽，無法管理或查看其他競賽的內部資料。

8. 常見問題與錯誤排除

批次指派評審時部分組合失敗？

系統會逐一略過重複或有利益衝突的組合並回報原因，不會因單一組合失敗而讓整批請求失敗；請依回報的原因個別處理。

已發布的表單版本無法修改？

已發布版本設計上不可修改，請建立新版本並重新發布；既有已提交的答案仍綁定原本的表單版本。

成績已鎖定/公布，還能修改嗎？

已公布的結果不可再變更；若真的需要修正，需視情況另外走具稽核紀錄的例外處理程序，不建議直接更動已公布資料。