登入與認證

伺服器連線設定與狀態指示

開啟 App 後，登入畫面頂部顯示伺服器 URL 設定欄位。URL 旁有連線狀態指示燈：

燈號顏色 狀態 說明
● 綠色 已連線 — 伺服器正常回應
● 紅色 無法連線 — 伺服器不可達或網路異常
● 灰色 檢測中 — 正在偵測伺服器狀態

確認指示燈為綠色後再進行登入操作，可避免不必要的錯誤提示。

帳號密碼登入

登入步驟

  1. 開啟 App，進入登入畫面
  2. 確認伺服器 URL 旁的連線指示燈為綠色
  3. 輸入 iDempiere ERP 帳號（必填）
  4. 輸入密碼（必填）
  5. 可點擊密碼欄位右側的眼睛圖示切換密碼顯示/隱藏
  6. 點擊「登入」按鈕
  7. 登入成功後自動進入主畫面

注意事項：

  • 必填欄位未填寫時會自動提示錯誤訊息
  • 若出現紅底錯誤卡片，請確認帳號密碼是否正確、網路連線是否正常、ERP 伺服器是否可存取

角色/組織選擇

登入成功後，若帳號擁有多個角色或組織，系統會顯示選擇畫面：

  • 選擇要登入的角色（Role）— 決定可存取的功能和資料範圍
  • 選擇組織（Organization）— 決定資料歸屬的組織單位
  • 所有模組的功能顯示和權限（R/W 或 R）均依所選角色自動過濾
  • 切換角色時自動清除選單快取，重新載入新角色權限

生物辨識登入（Face ID / Touch ID）

首次以帳號密碼成功登入後，系統會自動儲存加密的憑證。之後再次開啟 App 時：

生物辨識流程

  1. 系統自動偵測裝置是否支援 FaceID / TouchID
  2. 若支援且已啟用，自動彈出生物辨識驗證畫面
  3. 驗證通過後自動登入，無需重新輸入帳號密碼
  4. 也可以點擊登入畫面的指紋圖示手動觸發生物辨識

安全說明：

  • 憑證儲存於裝置的安全儲存空間（iOS Keychain / Android Keystore），不會以明文保存
  • 可在「設定」頁面停用生物辨識，停用時會清除已儲存的憑證
  • 裝置需先設定 FaceID 或 TouchID 才能使用此功能

調撥路線設定（首次登入必要）

首次登入後，需建立至少一條移動路徑（Transfer Route），定義入庫/出庫的來源與目的倉庫。

設定步驟

  1. 進入底部導覽列的「設定」頁面
  2. 點擊「移動路徑管理」
  3. 點擊右下角「+」新增路徑
  4. 填寫以下欄位：
    欄位 說明 範例
    路徑名稱 自訂名稱，方便辨識 主倉入庫路徑
    類型 入庫 (Inbound) 或出庫 (Outbound) 入庫
    來源倉庫 物品移出的倉庫 QC-Staging
    目的倉庫 物品移入的倉庫/儲位 LAB-Main
  5. 點擊「儲存」完成新增
  6. 建議入庫與出庫各至少建立一條路徑

注意事項：

  • 此設定儲存在裝置本地，更換裝置或清除 App 資料後需重新設定
  • 若先前已有舊版倉庫設定，系統會在首次啟動時自動移轉為兩條移動路徑
  • 若尚未建立任何移動路徑，首頁頂部會顯示黃色警示卡片提醒

密碼可見度切換

登入畫面的密碼輸入欄位右側提供眼睛圖示按鈕：

  • 點擊一次：顯示密碼（明文）
  • 再次點擊：隱藏密碼（圓點遮蔽）

此功能方便確認輸入的密碼是否正確，尤其適用於行動裝置觸控鍵盤輸入場景。

自動續登

App 採用 Token 機制維持登入狀態：

  • 登入成功後取得 Access Token 與 Refresh Token
  • Access Token 過期時，系統自動使用 Refresh Token 更新登入狀態
  • 若自動更新失敗，會自動跳轉至登入畫面重新登入
  • 整個過程對使用者透明，無需手動操作
🌐 English Version

Server Connection & Status Indicator

The login screen displays a server URL field with a connection indicator: green (connected), red (unreachable), gray (checking). Ensure the indicator is green before logging in.

Username & Password Login

  1. Open the app and navigate to the login screen
  2. Verify the server connection indicator is green
  3. Enter your iDempiere username and password
  4. Tap the eye icon to toggle password visibility
  5. Tap “Login”
  6. On success, the app navigates to the dashboard

Role / Organization Selection

If your account has multiple roles or organizations, a selection screen appears after login. The chosen role determines which features and data you can access. All modules are automatically filtered by role permissions.

Biometric Login (Face ID / Touch ID)

  1. After first successful login, credentials are encrypted and stored securely
  2. On next app launch, biometric authentication is triggered automatically
  3. You can also tap the fingerprint icon on the login screen to trigger manually
  4. Credentials are stored in iOS Keychain / Android Keystore (never in plaintext)

Transfer Route Setup (Required on First Login)

  1. Go to the “Settings” tab in the bottom navigation
  2. Tap “Transfer Route Management”
  3. Tap “+” to add a new route
  4. Fill in: Route Name, Type (Inbound/Outbound), Source Warehouse, Destination Warehouse
  5. Tap “Save” — create at least one inbound and one outbound route

Routes are stored locally on the device. If you switch devices or clear app data, you will need to reconfigure them.

Auto Token Renewal

The app uses Access Token + Refresh Token. When the access token expires, the refresh token is used automatically to renew the session. If renewal fails, the app redirects to the login screen.