123 lines
4.1 KiB
Markdown
123 lines
4.1 KiB
Markdown
# 評分管理功能
|
||
|
||
## 功能概述
|
||
|
||
後台評分管理系統提供了完整的評分管理功能，包括：
|
||
|
||
- 查看已完成和未完成的評分內容
|
||
- 手動輸入和編輯評分
|
||
- 評分進度追蹤
|
||
- 篩選和搜尋功能
|
||
|
||
## 主要功能
|
||
|
||
### 1. 競賽選擇
|
||
- 從下拉選單中選擇要管理的競賽
|
||
- 顯示競賽基本資訊（名稱、類型、時間等）
|
||
|
||
### 2. 評分概覽
|
||
- **已完成評分**：顯示已完成的評分數量
|
||
- **待評分**：顯示待評分的數量
|
||
- **完成度**：顯示評分進度的百分比
|
||
- **總評分項目**：顯示總評分項目數量
|
||
- 進度條：視覺化顯示評分進度
|
||
|
||
### 3. 評分記錄管理
|
||
- **評審**：顯示評審姓名和頭像
|
||
- **參賽者**：顯示參賽者名稱和類型（個人/團隊）
|
||
- **類型**：標示參賽者類型
|
||
- **總分**：顯示評分總分
|
||
- **狀態**：顯示評分狀態（已完成/待評分）
|
||
- **提交時間**：顯示評分提交時間
|
||
- **操作**：編輯或新增評分
|
||
|
||
### 4. 篩選和搜尋
|
||
- **狀態篩選**：按評分狀態篩選（全部/已完成/待評分）
|
||
- **搜尋功能**：搜尋評審或參賽者名稱
|
||
- **分頁功能**：支援大量數據的分頁顯示
|
||
|
||
### 5. 動態評分功能
|
||
- **評審選擇**：從評審列表中選擇評審
|
||
- **參賽者選擇**：從參賽者列表中選擇參賽者
|
||
- **動態評分項目**：根據競賽建立時設定的評比規則動態生成評分項目
|
||
- **權重計算**：支援不同評分項目的權重設定
|
||
- **評分驗證**：確保所有評分項目都已評分
|
||
- **總分計算**：根據權重自動計算總分
|
||
- **評審意見**：填寫評審意見和建議
|
||
- **評分提交**：提交或更新評分
|
||
|
||
## 使用方式
|
||
|
||
### 訪問評分管理
|
||
1. 進入後台管理系統
|
||
2. 點擊「評分管理」標籤
|
||
3. 選擇要管理的競賽
|
||
|
||
### 查看評分記錄
|
||
1. 選擇競賽後，系統會自動載入該競賽的所有評分記錄
|
||
2. 使用篩選功能查看特定狀態的評分
|
||
3. 使用搜尋功能快速找到特定評審或參賽者的評分
|
||
|
||
### 動態評分輸入
|
||
1. 點擊「手動輸入評分」按鈕
|
||
2. 選擇評審和參賽者
|
||
3. 根據競賽設定的評比項目進行評分
|
||
4. 為每個評分項目選擇分數（1-10分）
|
||
5. 系統會根據權重自動計算總分
|
||
6. 填寫評審意見
|
||
7. 點擊「提交評分」完成評分
|
||
|
||
### 編輯現有評分
|
||
1. 在評分記錄表格中點擊編輯按鈕
|
||
2. 修改評審意見
|
||
3. 點擊「更新評分」保存修改
|
||
|
||
## 技術實現
|
||
|
||
### 組件結構
|
||
- `ScoringManagement`：主要評分管理組件
|
||
- 整合到現有的 `CompetitionManagement` 組件中
|
||
|
||
### 動態評分系統
|
||
- **評比規則讀取**：從競賽的 `rules` 屬性讀取評比項目
|
||
- **動態評分項目生成**：根據競賽規則動態生成評分表單
|
||
- **權重計算**：支援不同評分項目的權重設定
|
||
- **評分驗證**：確保所有評分項目都已評分
|
||
- **總分計算**：根據權重自動計算總分
|
||
|
||
### 數據流
|
||
1. 從 `useCompetition` 上下文獲取競賽和評分數據
|
||
2. 根據選擇的競賽載入相關的評審和參賽者
|
||
3. 讀取競賽的評比規則並動態生成評分項目
|
||
4. 生成評分記錄列表
|
||
5. 支援篩選、搜尋和分頁功能
|
||
|
||
### 狀態管理
|
||
- 使用 React hooks 管理組件狀態
|
||
- 整合現有的競賽上下文
|
||
- 支援即時數據更新
|
||
- 動態評分項目的狀態管理
|
||
|
||
## 文件結構
|
||
|
||
```
|
||
components/admin/
|
||
├── scoring-management.tsx # 評分管理組件
|
||
└── competition-management.tsx # 競賽管理組件（已整合）
|
||
|
||
app/admin/
|
||
└── scoring/
|
||
└── page.tsx # 評分管理頁面
|
||
```
|
||
|
||
## 注意事項
|
||
|
||
1. 評分記錄會根據競賽的評審和參賽者自動生成
|
||
2. 已完成的評分可以編輯，未完成的評分可以新增
|
||
3. 評分提交後會即時更新列表
|
||
4. 支援個人賽和團隊賽的評分管理
|
||
5. 評分數據與現有的競賽管理系統完全整合
|
||
6. 評分項目會根據競賽建立時設定的評比規則動態生成
|
||
7. 如果競賽沒有設定評比規則，會使用預設的評分項目
|
||
8. 總分會根據各評分項目的權重自動計算
|
||
9. 系統會驗證所有評分項目都已評分才能提交 |