系統說明書
敏惠智慧考試網之系統目的、架構、功能、資料與維護說明。
1. 系統概述
「敏惠智慧考試網」是一套以題庫為核心的學習與測驗平台，提供一般使用者進行練習與正式考試， 並讓平台管理者掌握學校、班級與學生的學習狀況；系統管理者則負責帳號、題庫及系統資料管理。
建置目的
集中管理考古題與題庫，提供可追蹤的學習、測驗、錯題複習及統計分析流程。
適用對象
學生或測試者、教師或學校管理者、系統與題庫維護人員。
練習模式
逐題送出後可立即查看答案與解析，適合學習、錯題及標記題複習。
正式考試模式
集中完成作答後送出，適合模擬測驗與成績評估。
2. 系統架構
| 層級 | 主要技術 | 用途 |
|---|---|---|
| 前端呈現 | Razor Views、Bootstrap、JavaScript | 頁面、響應式導覽、表單與互動 |
| 後端應用 | ASP.NET Core MVC／C# | 路由、流程控制、授權與驗證 |
| 身分驗證 | ASP.NET Core Identity | 登入、角色與帳號管理 |
| 資料存取 | Entity Framework Core | 查詢、交易及資料庫映射 |
| 資料庫 | SQL Server Express／SQL Server | 帳號、題庫、作答及統計資料 |
| 部署 | Windows／IIS | 正式網站託管與服務管理 |
3. 身分與權限
| 身分 | 主要功能 | 資料範圍 |
|---|---|---|
| User | 練習、正式考試、歷史紀錄、錯題、標記題、個人統計 | 只可查看自己的作答與分析 |
| PlatformAdmin | 平台總覽、班級、學生及題庫品質分析 | 限定其學校及授權管理範圍 |
| SystemAdmin | 帳號、角色、題庫匯入、批次、發布、下架及全系統題庫分析 | 系統管理範圍 |
4. 功能架構
帳號與權限
建立使用者、指派角色、啟用狀態與使用者資料維護。
題庫匯入
Excel 上傳、Staging 驗證、錯誤檢查、正式轉入與批次追蹤。
發布與下架
控制題目是否可供新練習或正式考試使用，並保留歷史資料。
一般練習
類別、年度、題數選擇，逐題作答、即時回饋及中途續作。
正式考試
集中作答、草稿保存、送出前確認、續考、放棄與結果查閱。
錯題與標記題
從歷史作答中整理錯誤與標記內容，建立複習流程。
個人統計
練習與正式考試趨勢、類別、年度、高頻錯題及題目明細。
平台統計
學校、班級、學生、弱項、高錯誤率與高標記題目分析。
題庫品質分析
實際難度、錯誤率、作答時間、選項分布及品質警示。
響應式介面
Desktop 與 Mobile 共用路由、權限及功能，依螢幕自動重排。
5. 主要資料架構
以下為主要資料表與用途，實際資料庫另包含 Identity、匯入驗證及其他輔助資料。
| 資料表 | 主要用途 |
|---|---|
AspNetUsers | 登入帳號、Email、顯示名稱、啟用狀態 |
AspNetRoles／AspNetUserRoles | 角色與使用者角色關聯 |
UserProfiles | 學校、科別、年級、班級、學號與身分註記 |
Questions | 題目、選項、正確答案、解析、年度、類別與發布狀態 |
QuestionImportBatches | 題庫匯入批次、處理結果、發布與下架紀錄 |
QuestionImportStaging | Excel 暫存、欄位驗證、錯誤與預覽資料 |
PracticeSessions | 練習或正式考試場次、狀態、時間與篩選條件 |
PracticeSessionItems | 各題答案、正確性、標記、作答時間與題目關聯 |
PracticeMode != "FormalExam"代表練習及各類複習模式PracticeMode == "FormalExam"代表正式考試6. 安全與資料規則
- 一般使用者只能查看自己的練習、考試、錯題、標記題與統計。
- 平台管理者查詢學生前，必須先套用學校與 User 角色範圍。
- 跨校、跨學生或不存在的明細查詢應回傳安全的找不到結果。
- 系統管理者才可建立帳號、匯入題庫、發布、下架與管理題庫。
- 題目下架後不再供新場次抽取，但既有歷史作答與統計仍保留。
- Completed 場次用於核心成績統計；InProgress 與 Abandoned 不列入完成成績。
- 刪除、清空、放棄、發布與下架等重要操作應有確認與權限檢查。
- 表單使用防偽權杖，並由 ASP.NET Core Identity 管理登入 Cookie。
7. 系統環境與維護
建議瀏覽器
最新版 Microsoft Edge、Google Chrome、Safari 或其他現代瀏覽器。
顯示裝置
支援 Desktop、Tablet 與 Mobile；建議手機採直向操作。
資料庫備份
正式環境應定期備份 SQL Server，並定期驗證還原程序。
題庫匯入
先在測試環境驗證 Excel 格式、選項 JSON、圖片與重複題號。
IIS 部署
發布前確認連線字串、環境變數、目錄權限、HTTPS 與應用程式集區。
錯誤追蹤
保留應用程式日誌，出錯時記錄時間、帳號、頁面、操作及錯誤內容。
正式上線前檢查
- 備份：備份資料庫、設定檔與題庫圖片。
- 權限：驗證 User、PlatformAdmin、SystemAdmin 各自可見範圍。
- 流程：完成練習、正式考試、續作、放棄、結果與統計測試。
- 題庫：驗證匯入、發布、下架、歷史紀錄與題庫品質分析。
- 裝置：驗證 Desktop 與 Mobile 導覽、表格、Modal 與操作按鈕。
8. 現況與後續擴充
目前核心功能已成形，後續可依實際使用需求逐步擴充：
- Schools、Classes、PlatformAdminScopes 等正式管理範圍資料結構。
- Excel／PDF 報表匯出與批次下載。
- 大量資料的伺服器端分頁、排序及查詢效能優化。
- 題庫品質門檻、及格分數與系統參數設定頁。
- 學習風險、班級異常與題庫品質通知機制。
- 知識點分類、學習地圖與更進階的題目鑑別度分析。