花蓮縣運動空手道協會 數位平台使用說明手冊
涵蓋公眾服務、學員數位卡、教練相機 QR 掃描打卡、錦標賽計分台、行政審核與理事長管理安全防護的全方位圖文操作指南。
系統導覽與通用操作
涵蓋平台入口首頁、公眾百科、會員註冊登入、2FA 安全認證與深淺色主題切換
1.1 平台首頁與公眾功能導覽
公眾開放平台首頁提供即時公告跑馬燈、型圖解百科、道館課表、師資陣容與公益贊助徵信。
📋標準操作步驟 (Step-by-Step)
- 1前往首頁 (/) 查看頂部即時公告橫幅，點擊「立即前往詳情」可直達指定公文或賽事。
- 2點擊導覽列「型圖解百科 (/kata)」瀏覽平安初段至五段等招式分解圖譜與步法重點。
- 3點擊「道館課表 (/schedule)」查詢幼兒、兒童、青年與選手梯次每週常規上課時間。
- 4點擊「師資陣容 (/coaches)」了解國家級教練與黑帶師資經歷與專業專長。
1.2 會員帳號註冊、登入與登出
會員基礎完成帳號註冊與安全登入，享受數位學員證與個人化功能。
📋標準操作步驟 (Step-by-Step)
- 1尚未加入請至「註冊帳號 (/register)」，填寫信箱、密碼（需含英數混合）、姓名與電話。
- 2已註冊者前往「會員登入 (/login)」輸入信箱密碼，若有 2FA 請接著輸入 6 位數認證碼。
- 3忘記密碼時可點擊「忘記密碼 (/forgot-password)」，至註冊信箱收信並重設新密碼。
- 4點擊右上角「會員帳戶 ▾」選擇「🚪 登出目前帳號」即可安全結束本次操作連線。
1.3 雙層安全認證 (2FA TOTP) 與備用碼
高資安防護使用 Google Authenticator 或相關 App 綁定 2FA，確保個人個資不受未授權存取。
📋標準操作步驟 (Step-by-Step)
- 1登入會員中心後進入安全設定，開啟「雙層認證 2FA (TOTP)」開關。
- 2使用手機 Authenticator App 掃描專屬 QR Code，並輸入當前 6 碼數字進行校驗。
- 3啟用後請務必抄寫或截圖保存系統派發的 10 組「一次性備用碼 (Backup Codes)」。
- 4日後若手機遺失，可於登入頁點選「使用備用碼登入」緊急登入並重新綁定新裝置。
學員與家長專區
提供個人數位電子學員證、考段歷程、線上繳費、體驗預約與監護人同意書簽署
2.1 數位電子學員證與打卡 QR Code
學員必備隨身攜帶的數位電子學員證，到館上課即時出示進行快速打卡點名。
📋標準操作步驟 (Step-by-Step)
- 1點擊右上角「會員帳戶 ▾」選擇「📱 數位電子學員證」。
- 2卡片完整載明學員姓名、大頭照、學員編號與當前段位色帶標章。
- 3到館上課時，將中央動態打卡 QR Code 對準道館櫃檯相機或教練手機即可完成點名。
2.2 考段晉級歷程與防偽證書查驗
段位晉升透明記錄學員每次測驗晉段紀錄，並提供公眾數位防偽證書查驗碼。
📋標準操作步驟 (Step-by-Step)
- 1於學員儀表板向下滾動至「段位晉升紀錄」，查看各階段色帶考核日期與教練評語。
- 2點擊證書圖示可檢視官方電子證書，每張證書右下角皆有唯一防偽驗證 QR Code。
- 3公眾人士亦可前往 /verify/cert/[certId] 查驗證書真偽與發證字號。
2.3 線上體驗課預約與課程梯次查詢
新學員體驗未入會學員可線上預約道館免費體驗課程，並由教練聯繫安排道服。
📋標準操作步驟 (Step-by-Step)
- 1進入「預約免費體驗 (/experience)」，挑選欲上課的道館分部與梯次時段。
- 2輸入體驗學員姓名、年齡、家長聯絡手機與基本備註。
- 3點擊提交後將收到確認信，協會教練將於 24 小時內電話聯繫確認上課時間。
2.4 線上繳費中心與電子繳費收據
金流繳費整合線上信用卡、ATM 虛擬帳號與超商代碼繳納常態學費與賽事報名費。
📋標準操作步驟 (Step-by-Step)
- 1進入「我的繳費與帳單 (/dashboard/payments)」，點擊「立即前往繳款」。
- 2在藍新金流安全收銀台選擇「信用卡」、「ATM 轉帳」或「超商代碼」完成付款。
- 3付款成功後金流即刻入帳，系統自動開立具備防偽校驗章之電子收據供下載報帳。
2.5 家長監護人線上同意書簽署與授權管理
法規保障未成年學員依法規需簽署常態訓練安全規範與賽事肖像授權書。
📋標準操作步驟 (Step-by-Step)
- 1家長登入後點擊「👨👩👧 子女與監護權管理」，點選未簽署的學員姓名。
- 2詳閱《未成年學員安全規範同意書》與《活動肖像權報導使用同意書》。
- 3於線上勾選並簽署確認，系統將建立時間戳記與防竄改雜湊保存在帳戶內。
- 4若日後有特殊隱私需求，家長隨時可於同意書管理介面線上發起授權撤回申請。
教練與裁判工作專區
涵蓋手機 QR 掃描點名、單堂補簽補假、課表排定、學員評語與賽事大螢幕計分台
3.1 教練手機/平板相機 QR 即時點名
教練核心拿起手機開啟鏡頭，對準學員手機 QR Code 即可一秒完成出席打卡。
📋標準操作步驟 (Step-by-Step)
- 1進入「📷 教練相機 QR 點名」，瀏覽器提示時點選「允許相機存取」。
- 2將鏡頭框對準學員出示的電子學員證 QR 碼。
- 3系統瞬間發出清脆提示音，並在大螢幕顯示綠色勾勾與學員大名，即完成點名。
3.2 單堂課堂名冊補簽、請假與備註
名冊維護學員若未帶手機，教練可手動點名名冊，補登請假原因與當日表現。
📋標準操作步驟 (Step-by-Step)
- 1由課表或排程點入該堂上課名冊 (/cms/attendance/[sessionId])。
- 2名冊清晰列出應到學員，點擊學員右側之「出席」、「請假」或「曠缺」標籤即時切換。
- 3點擊「備註」可輸入請假緣由（如段考週請假）或本日對打優異進步表現。
3.3 常態排課與單堂代課教練調配
調課排課遇教練出差帶隊裁判公差時，快速指派合格代課教練接手。
📋標準操作步驟 (Step-by-Step)
- 1於「排課週期與課表管理 (/cms/schedule)」找到當日課表卡片。
- 2點擊卡片上的「代課指派」按鈕，從師資清單選取接手之代課教練。
- 3儲存後系統即刻更新當日公開課表，並寄送通知予代課教練。
3.4 錦標賽單敗淘汰籤表與電子裁決計分大螢幕
競賽裁判賽事單敗淘汰對戰樹狀圖自動排籤，以及紅藍雙方即時計分與現場大螢幕投影。
📋標準操作步驟 (Step-by-Step)
- 1在賽事管理點選「自動排定樹狀籤表」，系統將依年齡量級隨機公平抽籤。
- 2裁判於賽事現場進入計分台 (/cms/tournaments/matches/[matchId]/controller)。
- 3點擊藍方 (AO) 或紅方 (AKA) 之 Yuko (+1)、Waza-ari (+2) 或 Ippon (+3) 按鈕。
- 4右下角支援倒數碼表暫停/繼續，倒數歸零自動發出響鈴並將分數投影至大螢幕。
協會幹事與行政專區
公文公告發布、賽事梯次報名審核、體驗課轉正、段位發證與財務對帳核銷
4.1 最新消息發布與電子公文置頂
官網發布發布協會活動訊息、公文公告，並可設定首頁置頂與重要前綴。
📋標準操作步驟 (Step-by-Step)
- 1點擊「➕ 發布新消息」，輸入標題並選擇分類（最新消息/重要公告/賽事榮譽）。
- 2利用富文本編輯器編寫內容，支援插入照片、表格與官方 PDF 公文下載連結。
- 3勾選「首頁置頂」可讓重要文件始終固定於最新消息清單頂部。
4.2 賽事活動報名管理與名額候補遞補
活動賽事設定報名梯次、名額上限、參賽費用與滿額候補遞補名單。
📋標準操作步驟 (Step-by-Step)
- 1點擊「➕ 建立賽事活動」，設定報名時間、競賽規程與名額限制。
- 2名額額滿時，後續報名選手將自動落入「候補名單」。
- 3若正取選手逾期未繳費取消，幹事可一鍵將候補選手遞補轉為正取。
4.3 體驗課預約審核與一鍵轉為正式學員
招生利器體驗完畢確定入會時，一鍵自動建立正式學員資料，免除人工重複謄寫。
📋標準操作步驟 (Step-by-Step)
- 1於「體驗課線上預約」檢視近期登記名單，可手動登記現場報名之民眾。
- 2當學員完成體驗決定入會時，點擊右側操作列「⭐ 一鍵轉為正式學員」。
- 3系統自動帶入其姓名、手機電話與備註，並指派學員編號完成建檔。
4.4 官方段位證書發行與 A4 橫式套印 PDF
發證檢定發行中華民國空手道協會官方格式證書，支援一鍵列印與公眾防偽 QR 查驗。
📋標準操作步驟 (Step-by-Step)
- 1於「段位證書管理」點選「發行新證書」，選擇考試合格學員與通過段位。
- 2確認審查長與協會理事長簽署字號後點擊儲存。
- 3點擊「🖨️ A4 橫式列印」，瀏覽器將自動排版符合標準格式的燙金證書 PDF 檔案。
4.5 財務繳費對帳、電子收據與公益芳名錄
財務合規學費對帳、開立電子繳費證明，以及贊助款轉帳後五碼核銷與公開徵信。
📋標準操作步驟 (Step-by-Step)
- 1於「財務收費與入帳審核」查詢各筆訂單，現場繳費者可執行「手動核銷入帳」。
- 2於「贊助與財務核銷 (/cms/donations)」比對善心捐款人匯款帳號末五碼。
- 3勾選「公開芳名錄」後，捐款芳名與款項將同步公開於前台徵信專頁。
理事長與系統管理員專區
協會基本資料維護、首頁跑馬燈連動、會員帳號安全、RBAC 角色矩陣、備份還原與資源回收筒
5.1 協會基本資訊與首頁即時公告橫幅連動
核心設定維護協會官方名稱、Logo 壓縮、道館地址電話，並以分組下拉選單動態發布首頁跑馬燈。
📋標準操作步驟 (Step-by-Step)
- 1進入「🏛️ 協會資訊與聯絡設定 (/cms/association)」。
- 2可維護官方聯絡電話、公務信箱、總部會址與上傳高畫質 Logo（內建自動壓圖）。
- 3在「📢 首頁即時公告橫幅」區域，點擊下拉選單可從「📑 最新消息與公文」或「🏆 賽事活動」快速挑選。
- 4選取後系統自動填入標準前綴（如【重要公告】、【錦標賽事】）與跳轉超連結。
- 5點擊「儲存協會設定」後，官網首頁頂部跑馬燈即刻動態更新連動！
5.2 會員帳號管理、解鎖與 RBAC 角色權限矩陣
權限核心管理全站會員帳號狀態、錯誤鎖定解除、2FA 重設與細粒度角色權限分配。
📋標準操作步驟 (Step-by-Step)
- 1於「會員與帳號權限管理 (/cms/users)」可搜尋會員、查看鎖定狀態與手動解鎖。
- 2於「角色與權限分配設定 (/cms/roles)」可調整各角色（教練、幹事、家長等）權限權責。
- 3支援細粒度權限顆粒（如 cms:association:write、course:manage），落實權限最小化原則。
5.3 系統每日全自動排程備份與一鍵還原
災難復原每日凌晨自動備份資料庫快照，並支援手動即時備份與一鍵安全復原。
📋標準操作步驟 (Step-by-Step)
- 1進入「💾 系統安全備份與還原 (/cms/backups)」。
- 2進行重大業務異動前，點擊「➕ 立即建立備份快照」，系統將打包資料庫。
- 3若遭遇不可抗力之誤操作，點擊歷史備份快照旁的「還原」按鈕即可復原至該時間點。
5.4 資源回收筒 (Recycle Bin) 30 天安全期與物理粉碎
防誤刪安全網全站 8 大核心業務全面禁止直接物理刪除，誤刪項目可一鍵無損還原。
📋標準操作步驟 (Step-by-Step)
- 1當任何管理人員於學員、課程、賽事等模組執行刪除時，系統自動將完整快照移入回收筒。
- 2進入「🗑️ 資源回收筒 (/cms/recycle-bin)」可檢視 30 天內之刪除快照。
- 3點擊「還原」即可將該資料（含所有關聯子項）無損復原回原模組。
- 4僅最高管理員 (super_admin) 具備「物理粉碎銷毀」權限，並永久記載稽核軌跡。
5.5 敏感個資調閱軌跡與稽核日誌調閱中心
個資合規完整記載敏感個資存取、修改、刪除、角色權限異動與備份操作。
📋標準操作步驟 (Step-by-Step)
- 1進入「📜 稽核日誌調閱中心 (/cms/audit-logs)」。
- 2提供依操作者帳號、IP 位址、業務模組與時間區間進行條件篩選。
- 3可比對資料異動前與異動後之差異 (Diff)，嚴密防範內部弊端並符合個資法規。
常見問題 FAQ 與障礙排除
整理最常遇到的操作疑難、相機授權、帳號鎖定解鎖與快取刷新指引
6.1 核心障礙排除速查手冊
即時除錯彙整系統各功能最常見之異常狀況與標準排解流程。
📋標準操作步驟 (Step-by-Step)
- 1若遇登入切換身分畫面未更新，請按鍵盤 Ctrl + F5 (Windows) 或 Cmd + Shift + R (Mac) 強制刷新快取。
- 2連續 5 次密碼錯誤將鎖定 30 分鐘，請靜候鎖定解除或由管理員於後台會員管理專區手動解鎖。
- 3點名鏡頭黑畫面請於手機設定中檢查「相機使用權限」是否設為「允許」。
- 4若遺失 2FA 手機，請使用當初保存的 10 組一次性備用碼進行緊急登入。
常見問題與故障排除 (Troubleshooting)
當遇到登入鎖定、相機黑畫面、2FA 遺失或快取未更新時的標準解決指引。
Q: 為什麼登入時系統提示「密碼錯誤過多，帳號已被暫時鎖定」？▼
本系統為保障會員隱私與防範暴力破解攻擊，當連續輸入錯誤密碼達 5 次時，帳號將自動啟動安全防護鎖定 30 分鐘；達 10 次將鎖定 24 小時。請於鎖定時間屆滿後重新嘗試，或請協會管理人員登入後台「會員管理」為您手動解除鎖定。
Q: 更換了新手機，無法開啟 Google Authenticator 取得 2FA 認證碼怎麼辦？▼
請於登入畫面點擊「使用備用碼登入」，輸入當初開通 2FA 時系統提供給您的 10 組備用碼（Backup Code）其中任一組，即可順利登入會員中心。登入後請立即前往安全設定重新綁定新手機。若備用碼亦不慎遺失，請聯絡協會系統管理員核對身分後協助重置 2FA。
Q: 教練使用手機點名時，鏡頭一直是一片黑畫面無法掃描 QR Code？▼
這是因為行動瀏覽器尚未取得裝置的相機存取授權所致。請於 iPhone/iPad 前往「設定 > Safari > 相機」確認設定為「允許」；安卓裝置請點選網址列左側的「鎖頭 🔒」圖示，進入權限設定將相機授權開啟並重新載入網頁即可正常掃描。
Q: 登入切換不同身分或在後台修改協會設定後，前台畫面似乎沒有立刻變化？▼
系統現已支援全自動身分派發與 Cookie 同步跳轉。若因本機瀏覽器留有舊版靜態快取，請直接按下鍵盤的「Ctrl + F5」（Windows 系統）或「Cmd + Shift + R」（Mac 系統）進行硬性強制重新整理，即可立即取得最新頁面狀態。
Q: 如果教練或行政人員不小心按到刪除，誤刪了學員資料或賽事該如何復原？▼
完全無須擔心！系統全站 8 大模組全面導入「資源回收筒 (Recycle Bin)」保護機制，所有刪除項目都會完整備份快照並保留 30 天安全冷卻期。請具備管理權限之幹事進入「後台 > 資源回收筒 (/cms/recycle-bin)」，找到該筆項目點擊「還原」，所有關聯資料即可瞬間完好如初。