📋 系統概述
核心功能
- 員工編號驗證（整合燦坤 TK API）
- 手機號碼綁定與驗證
- OTP 一次性密碼發送與驗證
- 首次登入個人資料補充
- 完整的錯誤處理與提示
安全特性
- 員工狀態即時驗證（在職/離職檢查）
- 手機號碼與員工編號雙重驗證
- OTP 驗證碼時效性控制
- JWT Token 雙層認證（Access + Refresh）
- 防止重複註冊機制
✅ 正常登入流程
步驟 1
登入頁面 - 初始狀態
screenshots/demo_20260122_184511/01_登入頁面_初始狀態.png
畫面說明
- 顯示 JOGEEK 品牌 Logo
- 「揪機客」標題醒目呈現
- 員工編號輸入欄位
- 手機號碼輸入欄位
- 「發送驗證碼」按鈕（初始狀態）
步驟 2
輸入員工編號
screenshots/demo_20260122_184511/02_輸入員工編號.png
操作說明
- 員工在「員工編號」欄位輸入公司配發的編號（例如：TEST001）
- 系統尚未啟用「發送驗證碼」按鈕
- 需要同時輸入手機號碼才能進行下一步
步驟 3
輸入手機號碼
screenshots/demo_20260122_184511/03_輸入手機號碼.png
操作說明
- 員工輸入已註冊的手機號碼（10 位數字，09 開頭）
- 系統自動驗證手機號碼格式
- 當員工編號和手機號碼都正確填寫後，「發送驗證碼」按鈕啟用
- 此時可以點擊發送 OTP 驗證碼
步驟 4
OTP 發送成功
screenshots/demo_20260122_184511/04_OTP發送成功.png
功能說明
- 系統向燦坤 API 驗證員工編號與手機號碼
- 驗證成功後發送 6 位數 OTP 驗證碼至手機
- 頁面展開顯示 OTP 輸入框（6 個數字格）
- 顯示倒數計時器（例如：60 秒後可重新發送）
- 「發送驗證碼」按鈕變更為「重新發送」（倒數中為禁用狀態）
- 新增「登入」按鈕（需完整輸入 OTP 後啟用）
步驟 5
輸入 OTP 驗證碼
screenshots/demo_20260122_184511/05_輸入OTP.png
操作說明
- 員工從手機簡訊中取得 6 位數 OTP 驗證碼
- 依序在 6 個輸入框中輸入數字
- 系統自動將焦點移動到下一個輸入框
- 輸入完成後「登入」按鈕自動啟用
- 點擊「登入」進行 OTP 驗證
步驟 6
首次登入 - 個人資料頁
screenshots/demo_20260122_184511/06_個人資料頁_初始.png
首次登入流程
- 當員工首次登入（尚未綁定手機號碼）時，系統自動導向個人資料頁面
- 顯示從燦坤系統取得的員工資訊（唯讀）：
- 員工編號
- 員工姓名
- 所屬門市編號
- 所屬門市名稱
- 提供手機號碼輸入欄位（必填，10 位數）
- 提供 Email 輸入欄位（選填）
- 「完成註冊」按鈕初始為禁用狀態
步驟 7
填寫個人資料完成
screenshots/demo_20260122_184511/07_個人資料頁_填寫完成.png
完成註冊
- 員工填寫手機號碼（必填）
- 可選填 Email 地址
- 系統驗證手機號碼格式（09 開頭，10 位數字）
- 「完成註冊」按鈕啟用
- 點擊後系統將手機號碼綁定至該員工帳號
- 綁定成功後返回登入頁面，可使用綁定的手機號碼登入
❌ 錯誤處理場景
錯誤處理機制
- 即時驗證員工編號是否存在於系統中
- 檢查員工在職狀態（避免離職員工登入）
- 驗證手機號碼與員工編號的對應關係
- 所有錯誤訊息清楚明確，提供解決建議
錯誤 1
員工編號不存在
screenshots/errors_20260122_182915/錯誤01_員工編號不存在.png
錯誤說明
- 觸發條件：輸入的員工編號在燦坤系統中不存在
- 錯誤訊息：「員工編號不存在，請確認輸入是否正確」
- 使用者操作：
- 檢查員工編號是否輸入正確
- 確認是否使用公司配發的正確編號
- 如持續無法登入，請聯繫系統管理員
- 系統行為：不發送 OTP，停留在登入頁面
錯誤 2
員工已離職
screenshots/errors_20260122_182915/錯誤02_員工已離職.png
錯誤說明
- 觸發條件：員工編號存在，但員工狀態為「已離職」
- 錯誤訊息：「您已離職，無法登入系統」
- 安全考量：
- 防止離職員工訪問公司系統
- 保護公司資料安全
- 即時同步燦坤 HR 系統員工狀態
- 系統行為：拒絕登入請求，不發送 OTP
錯誤 3
手機號碼與員工記錄不符
screenshots/errors_20260122_182915/錯誤03_手機號碼不符.png
錯誤說明
- 觸發條件：輸入的手機號碼與該員工編號綁定的手機不一致
- 錯誤訊息：「手機號碼與員工記錄不符（註冊手機：0912****78）」
- 安全提示：顯示已註冊手機的部分資訊（前 4 後 2 碼）
- 使用者操作：
- 確認輸入的手機號碼是否正確
- 檢查是否使用個人註冊時綁定的手機
- 如需更換手機號碼，請聯繫系統管理員
- 系統行為：拒絕發送 OTP，保護帳號安全
- 技術亮點：此功能為本次開發重點修復項目，確保雙重驗證機制正確運作