設定頁面
從底部導覽列的「設定」頁籤進入設定頁面，可管理以下項目：
| 項目 | 說明 |
|---|---|
| 深色模式 | 開關切換明/暗主題，偏好設定會自動儲存 |
| 生物辨識登入 | 開關啟用/停用 FaceID / TouchID 登入，停用時會清除已儲存的憑證 |
| 語言 | 繁體中文 / English / 日本語，可即時切換 |
| 移動路徑管理 | 入庫/出庫移動路徑設定（新增、編輯、刪除路徑） |
| 首頁模式 | 選擇首頁顯示「標準儀表板」或「個人首頁」 |
| 儀表板編輯 | 自訂模組排列、大小、隱藏 |
| 通知設定 | 各類推播通知個別開關 |
| 登出 | 清除 Token，返回登入畫面 |
調撥路線管理
管理入庫/出庫的移動路徑設定：
- 點擊「移動路徑管理」進入路徑列表
- 點擊右下角「+」新增路徑
- 每條路徑設定：路徑名稱、類型（入庫/出庫）、來源倉庫、目的倉庫
- 可左滑刪除不需要的路徑
- 路徑資料儲存於裝置本地
Gemini API 金鑰設定教學
APP 的「AI 服務」功能使用 Google Gemini API 進行發票/收據影像辨識（拍照自動擷取供應商、金額、明細等欄位）。使用此功能前，需要先取得 API 金鑰。
步驟一：前往 Google AI Studio
- 在瀏覽器開啟 Google AI Studio
- 使用 Google 帳號登入
步驟二：取得 API 金鑰
- 點擊左側選單的「Get API key」（取得 API 金鑰）
- 點擊「Create API key」（建立 API 金鑰）
- 選擇一個 Google Cloud 專案（若無專案，系統會自動建立）
- 金鑰建立後會顯示在畫面上，點擊複製圖示
請妥善保管 API 金鑰，不要分享給他人。
步驟三：在 APP 中設定
- 開啟 APP → 進入設定頁面
- 捲動到「AI 服務」區塊
- 點擊「Gemini API 金鑰」
- 貼上剛才複製的金鑰
- 點擊儲存
費用說明
| 方案 | 說明 |
|---|---|
| 免費方案 | 每分鐘 15 次請求、每日 1,500 次請求，適合一般使用 |
| 付費方案 | 需綁定 Google Cloud 帳單，按用量計費 |
一般使用情境下，免費方案已足夠。詳細定價請參考 Google AI 定價頁面。
團隊出勤儀表板
用途：供主管查看團隊成員的出勤狀況（請假、加班）。
功能特色
- 行事曆視圖：以週或月為單位檢視團隊出勤
- 假單/加班單整合：自動抓取 ERP 中的請假單與加班單
- 顏色區分：
- ■ 藍色：請假 (Leave)
- ■ 綠色：加班 (Overtime)
- 統計摘要：下方表格顯示每位成員的時數統計
操作方式
- 在首頁儀表板找到「團隊出勤」卡片（需有對應權限）
- 點擊進入後，預設顯示目前月份/週次
- 可切換 Week（週） 或 Month（月） 視圖
- 點擊左右箭頭切換日期區間，或點 Today 回到今天
- 點擊右上角重新整理圖示可手動更新資料
成員篩選與詳情
- 成員篩選：使用工具列下方的下拉選單，可檢視特定成員的出勤狀況
- 查看詳情：點擊行事曆上的顏色區塊，可彈出查看詳細資訊（假別、時數、備註）
深色模式
App 支援完整的深色模式，所有頁面和元件均適配：
切換步驟
- 前往底部導覽列的「設定」頁面
- 開啟「深色模式」開關
- 整個 App（含所有頁面）立即切換為深色主題
- 關閉 App 後重新開啟，偏好設定會自動保留
多語言支援
App 支援繁體中文、英文及日文介面：
切換步驟
- 前往「設定」頁面
- 點擊「語言」選項
- 選擇 繁體中文、English 或 日本語
- 介面立即切換，設定會自動保留
動態名言切換：首頁及登入畫面的稻盛和夫語錄也會隨語系動態切換，支援繁中、英文、日文三種語言版本。
離線模式
當裝置網路中斷時，App 自動進入離線模式：
- 畫面頂部顯示橘色離線提示橫幅
- 已快取的資料（庫存等）仍可檢視
- 快取有效期限為 30 分鐘
- 網路恢復後自動隱藏橫幅，建議下拉刷新取得最新資料
常見問題 FAQ
Q: 出現「登入已過期，請重新登入」？
A: 這表示 Token 已過期。系統會自動嘗試 Refresh Token 更新；若失敗，會自動跳轉至登入畫面。重新登入即可正常使用。
Q: 登入時出現連線錯誤？
A: 請確認：
- 手機/電腦的網路連線正常
- 能否在瀏覽器中開啟 ERP 系統網址
- 若使用 VPN 才能連線 ERP，請確認 VPN 已連接
Q: 入庫/出庫下拉選單是空的？
A: 可能原因：
- 尚未建立移動路徑（請先至設定 → 移動路徑管理新增路徑）
- 路徑設定的來源倉庫確實沒有庫存（請至 iDempiere 確認）
- iDempiere 帳號沒有該倉庫的存取權限
Q: 入庫/出庫送出後失敗？
A: 可能原因：
- iDempiere 帳號權限不足以建立移動單
- 所選產品/儲位有 iDempiere 業務規則限制
- 網路斷線或伺服器無回應
Q: 更換手機後需要重新設定？
A: 是的，移動路徑設定儲存在裝置本地。更換裝置後需重新登入並重新建立移動路徑。
Q: 生物辨識無法使用？
A: 請確認：
- 裝置已設定 FaceID 或 TouchID
- App 有生物辨識存取權限
- 至少成功以帳號密碼登入一次（系統需記錄憑證）
Q: 掃碼功能無法使用？
A: 請確認：
- App 有相機存取權限
- Web 版本需在 HTTPS 環境下才能使用相機
- 產品容器上的條碼是否清晰可讀
術語對照
| 系統用語 | iDempiere 對應 | 說明 |
|---|---|---|
| 移動路徑 | Transfer Route | 使用者定義的入庫/出庫倉庫路徑 |
| 倉庫 | M_Warehouse | 物品存放的倉庫 |
| 儲位 | M_Locator | 倉庫中的具體存放位置 |
| 入庫 | M_Movement (依路徑設定) | 移動單：從路徑來源倉庫移入目的倉庫 |
| 出庫 | M_Movement (依路徑設定) | 移動單：從路徑來源倉庫移出至目的儲位 |
| 批號 | M_AttributeSetInstance | 物料批次追蹤編號 |
| 單據編號 | DocumentNo | iDempiere 自動產生的移動單號 |
| 簽核 | AD_WF_Activity | 工作流程待辦活動 |
| 工作請求 | R_Request | 工作票務/狀態追蹤 |
| 報表/處理程序 | AD_Process | ERP 報表/流程（透過選單樹角色權限控制，與桌面端一致） |
| 資訊視窗 | AD_InfoWindow | 資訊查詢視窗（透過 AD_InfoWindow_Access 控制權限） |
| 工作流程 | AD_Workflow | 工作流程定義（透過 AD_Workflow_Access 控制權限） |
| ERP 選單 | AD_Menu / AD_Tree | 角色可存取的選單樹（依角色自動過濾） |
| 請求狀態 | R_Status | 請求的處理階段 |
| 請求備註 | R_RequestUpdate | 請求的更新紀錄/留言 |
| 請購單 | M_Requisition | 物料請購申請（含明細行 M_RequisitionLine） |
| 盤點單 | M_Inventory | 實盤作業（含明細行 M_InventoryLine） |
| 進貨收料 | M_InOut (IsSOTrx=N) | 供應商進貨收料單（含明細行 M_InOutLine） |
| 業務夥伴 | C_BPartner | 客戶/供應商/員工名錄 |
| 發票 | C_Invoice | 應付/應收發票（含明細行 C_InvoiceLine） |
| 品質規格 | QM_Specification | 品質管理規格（含檢測項 QM_SpecificationLine） |
| 請假單 | HR_LeaveRequest | 員工請假申請（含假別 HR_LeaveType） |
🌐 English Version
Settings Page
| Item | Description |
|---|---|
| Dark Mode | Toggle light/dark theme, preference auto-saved |
| Biometric Login | Enable/disable Face ID / Touch ID |
| Language | Chinese / English / Japanese |
| Transfer Route Management | Configure inbound/outbound transfer routes |
| Logout | Clear tokens, return to login |
Team Attendance Dashboard
View team members’ leave and overtime status in a calendar view (week or month). Color-coded: blue for leave, green for overtime. Includes per-member hour statistics and detail popup.
Dark Mode
Full dark mode support across all pages. Toggle in Settings → Dark Mode. Preference persists across app restarts.
Multi-Language Support
Supports Traditional Chinese, English, and Japanese. Switch in Settings → Language. The Inamori quotes on the home screen also switch dynamically with the language.
Offline Mode
- Orange banner appears at the top when network is disconnected
- Cached data (inventory, etc.) remains viewable
- Cache validity: 30 minutes
- Banner auto-hides when network recovers; pull-to-refresh recommended
FAQ
Q: “Login expired, please re-login” message?
A: The access token has expired. The system will attempt auto-renewal with the refresh token. If that fails, you will be redirected to the login screen. Simply log in again.
Q: Connection error during login?
A: Check your network connection, verify the ERP server URL is accessible in a browser, and ensure VPN is connected if required.
Q: Empty dropdown in transfer screens?
A: Ensure transfer routes are configured (Settings → Transfer Route Management), the source warehouse has inventory, and your account has warehouse access permissions.
Q: Transfer submission failed?
A: Possible causes: insufficient iDempiere permissions, business rule restrictions on the selected product/locator, or network issues.
Q: Need to reconfigure after changing devices?
A: Yes, transfer routes are stored locally. After switching devices, log in again and reconfigure your routes.
Q: Biometric login not working?
A: Ensure your device has Face ID / Touch ID configured, the app has biometric permissions, and you have logged in with credentials at least once.
🇯🇵 日本語版
設定ページ
| 項目 | 説明 |
|---|---|
| ダークモード | 明暗テーマの切替、設定は自動保存 |
| 生体認証ログイン | Face ID / Touch ID の有効/無効切替 |
| 言語 | 繁体字中国語 / English / 日本語 |
| 移動ルート管理 | 入庫/出庫の移動ルートを設定 |
| ログアウト | トークンをクリアしてログイン画面に戻る |
チーム勤怠ダッシュボード
カレンダービュー（週または月）でチームメンバーの休暇・残業状況を確認できます。色分け表示：青は休暇、緑は残業。メンバーごとの時間集計と詳細ポップアップ付きです。
ダークモード
すべてのページで完全なダークモードに対応しています。設定 → ダークモードで切替可能です。アプリの再起動後も設定は保持されます。
多言語対応
繁体字中国語、英語、日本語に対応しています。設定 → 言語で切替できます。ホーム画面の稲盛和夫の名言も言語に合わせて動的に切り替わります。
オフラインモード
- ネットワーク切断時に画面上部にオレンジ色のバナーが表示
- キャッシュ済みデータ（在庫など）は引き続き閲覧可能
- キャッシュ有効期間：30 分
- ネットワーク復帰時にバナーは自動非表示、プルトゥリフレッシュ推奨
よくある質問（FAQ）
Q:「ログインの有効期限が切れました。再ログインしてください」と表示されます。
A: アクセストークンの有効期限が切れています。リフレッシュトークンによる自動更新が試みられます。失敗した場合はログイン画面にリダイレクトされますので、再度ログインしてください。
Q: ログイン時に接続エラーが発生します。
A: ネットワーク接続を確認し、ブラウザで ERP サーバーの URL にアクセスできるか確認してください。VPN が必要な場合は、VPN が接続されていることを確認してください。
Q: 入出庫画面のドロップダウンが空です。
A: 移動ルートが設定されているか確認してください（設定 → 移動ルート管理）。また、出庫元倉庫に在庫があること、アカウントに倉庫へのアクセス権限があることを確認してください。
Q: 入出庫の送信に失敗しました。
A: 考えられる原因：iDempiere の権限不足、選択した製品/ロケーターに対するビジネスルールの制限、またはネットワークの問題。
Q: デバイスを変更した後、再設定が必要ですか？
A: はい、移動ルートはローカルに保存されています。デバイスを変更した場合は、再度ログインしてルートを再設定してください。
Q: 生体認証ログインが使えません。
A: デバイスで Face ID / Touch ID が設定済みであること、アプリに生体認証のアクセス権限があること、少なくとも 1 回はユーザー名・パスワードでログイン済みであることを確認してください。