A-51 Trophy Room Exam Import
內容依原始規格呈現 · 查看 Markdown 來源 ↗需具備倉庫查看權限
智能獎杯導入中心
🎨 Figma: node-912-3209 (A-50/A-51 共用) 🔗
🎯 功能定位
使用者： Admin / Super Admin
- 智能預覽： 在正式寫入前進行「邏輯渲染預覽」。
- 強校驗： CSV 與 ZIP 媒體資源必須 100% 匹配。
- 自動拆分： 識別 Category 並自動生成 Listening & Reading 兩個 Challenge。
🧱 畫面結構
| 區域 | 說明 |
|---|---|
| Header | Nihao Admin Trophy Room > Import New Exam, [👤 Admin] |
| Basic Settings | Category, Total Score, Pass Score, Duration |
| Resource Upload | [📥 Download 19-Column CSV Template], CSV File, Audio ZIP, Image ZIP |
| Logic Preview & Validation | Auto-Split 結果, Duplicate Check, Validation Errors, Dual Preview |
| Actions | [Discard], [📥 Confirm Import] |
📄 CSV 格式規格 (19 Columns - 標準化)
為了確保 S-31 考試頁面能正確渲染（包含 6 選 1 等複雜題型），CSV 必須嚴格遵守以下結構：
| # | 欄位名稱 | Field Name | 說明 | 範例 |
|---|---|---|---|---|
| 1 | 檢定名稱 | Exam Name | 試卷大標題 | HSK-2 模擬考 |
| 2 | 檢定等級 | Exam Level | 級別標識 | 二級 |
| 3 | 回合 | Round | 版本次序 | 1 |
| 4 | 檢定類別 | Exam Category | 關鍵：拆分依據 | 聽力 / 閱讀 |
| 5 | 大題編號 | Section Number | Part 1, Part 2 | 第一部分 |
| 6 | 題目順序 | Question Sequence | 單題序號 | 1 |
| 7 | 題目編號 | Question Number | 考卷顯示的編號（會有例題，順序由上面的題目順序決定） | 1 |
| 8 | 題組 | Question Group | 用於 6 題一組的關聯 | 1 |
| 9 | 配分 | Points | 分數權重 | 10 |
| 10 | 題目形式 | Question Format | 展示媒體 | 圖片 / 文字 / 圖片 + 文字 |
| 11 | 題目文字 | Question Text | 題幹主體（\ 來進行拼音的分隔） | 男:\你\喜欢\什么\运动? |
| 12 | 題目拼音 | Question Spell | 題幹拼音（\ 來進行拼音的分隔） | Nan:\Nǐ\xǐhuan\shénme\yùndòng? |
| 13 | 題目圖片 | Question Image | 關聯圖檔名 | q1_main.png |
| 14 | 答案形式 | Answer Type | 渲染組件類型 | 單選 / 多選 / 是非 / 輸入 |
| 15 | 選項文字 | Option Text | 選項 A-F 文本（使用 | 來分隔不同選項） | A 红色|B 黑色|C 白色 |
| 16 | 選項拼音 | Option Pinyin | 選項 A-F 拼音（使用 | 來分隔不同選項） | A hóngsè|B hēisè|C báisè |
| 17 | 選項圖片 | Option Image | 選項 A-F 圖檔（使用 | 來分隔不同選項） | A man.png|B tea.png|...|F pileofpaper.png |
| 18 | 實際答案 | Correct Answer | 正解標籤 | A |
| 19 | 音頻檔案 | Audio File | 聽力題目音檔 | q1_audio.mp3 |
📦 核心邏輯細節
資源強一致性檢查 (Strict Validation)
系統在點擊導入前會自動遍歷 CSV 的圖片與音檔欄位：
- Missing Check: 若 CSV 填了檔案名但 ZIP 裡沒有，導入按鈕變灰，列表標紅報錯。
- Redundant Check: 提示 ZIP 中有哪些文件未被 CSV 引用（不影響導入，僅提示管理員）。
- Duplicate Round Check: Category + Round 必須唯一。
- Audio Check: 音頻只有 1 個。
⚠️ 獎杯樣式說明：學生獲得的獎盃樣式為隨機（高/中/低各 3 款，共 9 款）。導入時不需要設置獎杯樣式——系統在學生完成考試後，根據分數區間自動隨機分配。
Dual Preview (邏輯渲染預覽)
不同於學生端的正式 UI，此預覽旨在確認數據結構：
- 表格形式： 顯示 題號 | 題型 | 媒體資源狀態 (OK/X) | 正解代碼。
- 邏輯展示： 例如針對「6 選 1」，會顯示 6 個圖片佔位符，並在正確的那一個標註 [CORRECT]。
智能拆分確認 (Auto-Split)
當 CSV 包含「聽力」與「閱讀」兩種類別時，預覽區底部會顯示：
Challenge Splitting Result:
- Challenge 1: Listening (20 Questions / 100 Pts / 20 Mins)
- Challenge 2: Reading (20 Questions / 100 Pts / 25 Mins)
🔁 交互流程
- 管理員進入 A-51： 下載標準模板，準備 CSV 與兩個資源 ZIP。
- 設定與上傳： 設定及格線、總分、時長。
- 解析校驗： 系統自動解析。若發現檔案缺失或損壞，立即顯示報錯行號。
- 邏輯檢查： 管理員滾動預覽表格，確認聽力與閱讀的拆分點是否正確。
- 導入完成： 錯誤修正後，按鈕解鎖。導入成功後自動導向 A-50 列表。
🔎 邏輯自我檢查
- 防呆： 既然「不可編輯」，預覽畫面 (Logic Preview) 成為最重要的防錯關口。
- 權限： 僅 Admin/Super Admin 可見此頁面，Teacher 僅能使用推送 (T-41)。
- 靈活性： 透過 ZIP 導入圖片解決了以前單張上傳的低效率問題。