LotteryDrawing 完整操作說明
目前系統分成活動準備操作台、專用抽獎畫面與投影畫面。後端會先檢查資格並保存結果，成功後才揭曉得獎者；畫面重新整理不會清除已保存的活動資料。
01 / START
啟動與登入
- 開啟專案資料夾，雙擊
start-lottery.cmd。 - 保留啟動後的命令視窗；只關閉瀏覽器不會停止服務。使用完畢可在命令視窗按 Ctrl+C。
- 在登入頁輸入活動金鑰。活動使用者只能操作綁定的活動；系統管理者可建立、選擇與管理所有活動。
服務啟動時只檢查環境與資料庫，不會自動建立資料表、變更帳號或匯入真實資料。若畫面提示資料庫升級，請先依專案 database 與 docs 中的指示處理。
02 / PREPARE
建立活動與準備資料
- 建立或選擇活動：系統管理者填寫活動名稱，可選填日期與地點。活動使用者登入後只會看到所屬活動。
- 匯入抽獎人：在「01 名單與獎項 → 1. 匯入名單與獎項」下載範本、選擇 CSV 與編碼，先預覽，再確認匯入。
- 匯入獎項：使用獎項範本匯入，或在「3. 獎項清單」逐筆新增與編輯。
- 抽獎前檢查：確認抽獎人數、獎項名額、資格規則與投影畫面。第一次抽獎後，活動資料與準備期設定會鎖定。
抽獎開始後不可重新批次匯入或修改獎項；現場臨時到場者仍可在「2. 抽獎人名單」逐筆補登。
抽獎人 CSV 格式
| 欄位 | 用途與限制 |
|---|---|
| 抽獎人編號 | 必填；同一活動不得重複，最多 64 字。請以文字格式保存前導零。 |
| 姓名 | 必填。 |
| 單位、職稱 | 可留白。 |
| QRcode碼 | 可留白；目前保存為識別文字，不會產生 QR 圖片或自動驗證領獎。 |
| 會員編號 | 可留白；請以文字格式保存前導零。 |
| 其他-可空白 | 可填報名／報到系統連結或其他備註，最多 2,048 字。 |
| 不在現場1棄權2普獎3跳過可再抽 | 可留白以沿用活動規則；填 1 表示棄權、2 表示改列普獎、3 表示本次跳過但之後仍可抽。 |
| 可不在現場理由 | 可留白；例如「值班」。有填寫時，該抽獎人可依此理由不在現場領獎。 |
| 限制只能抽的代碼-空隔區分 | 只允許參加指定獎項；多個獎項代號以半形空格分隔。 |
| 限制不能抽的代碼-空隔區分 | 排除指定獎項；多個獎項代號以半形空格分隔。同一代號不可同時出現在只能抽與不能抽兩欄。 |
系統仍接受舊四欄與先前版本欄位；建議新檔案一律使用最新版範本。檔案上限 2 MB、10,000 人。Excel 建議使用「資料 → 從文字／CSV」，並將編號欄設為文字。
獎項 CSV 格式
| 欄位 | 用途與限制 |
|---|---|
| 獎項代號 | 必填；供抽獎人資格限制欄引用，同一活動不得重複。 |
| 獎項名稱 | 必填；顯示於操作台、抽獎畫面與報表。 |
| 獎品內容 | 可填獎品品名、型號或補充說明。 |
| 名額 | 必填正整數，決定此獎項可保存的得獎人數。 |
| 獎項排列順序 | 控制獎項在清單與抽獎選單中的顯示先後；數字較小排在前面，不代表系統會自動依序抽獎。 |
舊欄名「順序」仍可匯入；下載的新檔案會使用「獎項排列順序」。
03 / RULES
活動規則與個人資格
- 活動規則：設定一般獎項是否要求本人在場，以及未到場時的處理方式。
- 個人規則：CSV 中的未到場方式、可不在場理由、只能抽與不能抽代號會套用到該抽獎人。
- 資格優先順序：個人可不在場理由與個人未到場設定會覆蓋一般活動處理；只能抽與不能抽條件會一起檢查。
- 一般獎項：原則上每人限得一獎；已中獎者不再進入其他一般獎項候選名單。
- 臨時加碼獎：可設為全體名單皆可參加，包含已中獎者；建立時須填獎項名稱、名額、原因／提供單位並確認。
04 / DRAW
現場抽獎
- 在操作台確認目前活動，按「進入抽獎畫面」。需要大螢幕時另外開啟投影頁並移至第二螢幕。
- 選擇獎項，確認剩餘名額與符合資格人數，再勾選核對確認。
- 按抽獎按鈕。系統會先在後端檢查、抽取及保存，成功後才於抽獎畫面與投影揭曉。
- 大量名額可依畫面提供的批次功能處理；每次結果仍會個別保存並更新進度。
「預覽動畫」只測試畫面與音效，不會新增得獎者。若送出後連線中斷，不要直接開始另一抽；先使用「查回／重試同一次抽獎」，系統會用同一請求識別碼避免重複保存。
05 / FOLLOW-UP
未到場、更正、下載與結案
- 未到場：依活動規則與個人設定執行棄權、改列普獎，或跳過後保留再次抽獎資格。
- 更正：可取消得獎或更正獎項；釋出的名額會回到獎項，可再補抽。所有操作均保留異動記錄。
- 下載：「04 下載得獎名單」會下載目前活動全部已保存結果，不受畫面搜尋條件影響。
- 列印：得獎報表可列印或另存 PDF；抽獎持續進行後，請在報表頁更新資料。
- 結案：確認各獎項進度後結案。結案活動仍可查詢、下載與封存；需要重新演練時可複製成沒有得獎紀錄的新場次。
完整 JSON 封存包含活動、名單、獎項與得獎紀錄；瀏覽器中的封存檔檢查只核對內容，不會上傳或自動還原資料。
06 / FAQ
常見問題
操作說明在哪裡？
登入後，操作說明是位於「管理工具」前方的獨立區塊，不屬於管理工具；活動使用者與系統管理者都能看到。頁首也可直接開啟本完整說明。
CSV 預覽成功，為什麼資料還沒加入？
預覽只做欄位與內容檢查，還要按「確認匯入」才會保存。若預覽有錯誤，請修正原檔後重新選檔。
抽獎按鈕不能按？
請確認已選活動與獎項、名單已保存、核對確認已勾選，且仍有名額及符合資格者。活動結案、資料尚未載入或獎項已抽滿時也會停用。
活動開始後發現資料填錯？
第一次抽獎前可修改活動、獎項與規則。開始抽獎後請使用補登、未到場與更正流程；若整批準備資料錯誤，建議另建或複製測試活動重新演練。
提示新版抽獎人 CSV 規則尚需升級？
代表資料庫尚未套用 database/010-participant-csv-rules.sql。請依維護文件先備份並執行指定升級；不要刪除資料庫或重跑初始化。
手機、QQ_Check 或 QRcode 領獎已經連動嗎？
目前是本機活動系統；手機遙控、QQ_Check 串接與 QRcode 領獎驗證尚未提供。CSV 的 QRcode碼與其他連結欄位現階段只保存資料。