快速入門

系統簡介

iDempiere Mobile 為行動端企業資源規劃 App，與 iDempiere ERP 系統深度整合，透過 REST API 提供完整的行動辦公能力。本系統採用 Flutter 跨平台框架開發，支援 iOS、Android、Web、Windows 及 macOS 五大平台。

49 項主要功能

功能 說明
簽核作業 審核 ERP 工作流程
組織庫存查詢 跨倉庫查詢料號/批號庫存 + Production 保留量
工作請求 R_Request 工作票務管理（狀態追蹤 + 備註）
報表與處理程序 執行 ERP 報表/流程，PDF/HTML/Excel/CSV 輸出，內嵌預覽
會議室預約 週曆/日曆/時間軸檢視，資源篩選、新增/編輯/刪除
團隊出勤 查看團隊成員的請假與加班狀況
入庫作業 依移動路徑將藥品從來源倉庫轉入目的倉庫
出庫作業 依移動路徑從來源倉庫領料至目的儲位
庫存查詢 查詢路徑相關倉庫的藥品庫存（含低庫存警示）
資訊查詢 ERP 資訊視窗查詢，型別感知條件、排序、收藏、分頁
掃碼查詢 掃描條碼/QR Code 快速查看產品資訊
QR 標籤 為庫存藥品產生 QR Code 標籤
批次作業 批次入庫/出庫，一次處理多筆移動
深色模式 支援明/暗主題切換
訊息 即時通訊：1-on-1、群組聊天、圖片/檔案傳送、已讀回條
狀態指標 首頁 KPI 卡片（營收、訂單數等即時數據）
數據圖表 長條圖/折線圖/圓餅圖互動圖表
公告欄 AD_Note 自動輪播卡片，支援確認機制
ERP 動態選單 依角色自動載入 iDempiere 選單樹
角色權限控制 所有模組依角色權限過濾，R/W 或 R 標示
自動續登 Token 過期時自動 Refresh Token 續登
生物辨識 FaceID / TouchID 快速登入
文件列印匯出 任何 ERP 記錄匯出為 PDF/HTML/Excel/CSV
請購單 請購單 CRUD（草稿→完成→作廢）
盤點作業 掃碼盤點，差異標示
進貨收料 供應商選擇、採購單參照、條碼驗收
業務夥伴 C_BPartner 名錄（客戶/供應商/員工篩選）
發票瀏覽 C_Invoice 瀏覽（應付/應收篩選）
品質管理 QM_Specification 品質規格，檢測結果輸入
請假申請 HR_LeaveRequest 請假單（建立→送簽→作廢）
伺服器管理 管理員儀表板：健康狀態、排程器、快取
背景作業 報表/處理程序背景執行，自動輪詢狀態
API 可靠性 自動重試（指數退避）、斷路器
分塊上傳 大檔案分塊上傳，單塊重試
批次 API 交易性批次操作（多筆 API 單一交易）
資料維護 iDempiere 視窗 CRUD，權限標示，子標籤
研發成本分析 三維成本儀表板（材料/人工/設備）
工時記錄 研究員工時 CRUD
設備使用記錄 實驗室設備使用時數 CRUD
研究員生產力 長條圖 + 表格呈現生產力數據
多國語言 繁體中文 / English / 日本語
離線模式 橘色指示器，30 分鐘快取有效期

白牌品牌設定（AD_SysConfig）

App 支援透過 iDempiere AD_SysConfig 進行白標品牌與功能開關設定。所有設定預設為開啟，採用 opt-out 模式（設為 N 關閉）。

AD_SysConfig Key 預設值 說明
MOBILE_APP_NAME iDempiere Mobile App 標題列顯示名稱
MOBILE_SEED_COLOR #2196F3 (藍) 主題色（Hex 色碼）
MOBILE_SHOW_QUOTE 開啟 首頁名句區塊，設 N 隱藏
MOBILE_SHOW_SPONSOR 開啟 標題列贊助商 Logo，設 N 隱藏
MOBILE_FEATURE_CHAT 開啟 即時通訊模組，設 N 隱藏
MOBILE_FEATURE_BOOKING 開啟 會議室預約模組，設 N 隱藏
MOBILE_FEATURE_ATTENDANCE 開啟 團隊出勤模組，設 N 隱藏
MOBILE_FEATURE_SCANNER 開啟 掃碼查詢模組，設 N 隱藏
MOBILE_FEATURE_TRANSFER 開啟 入庫/出庫模組，設 N 隱藏
FLUTTER_SCREEN_ALIASES （空） 畫面 ID 別名對應 JSON

若伺服器未設定上述 Key，所有功能預設顯示，無需額外配置。

畫面 ID 別名（FLUTTER_SCREEN_ALIASES）

不同 iDempiere 伺服器可能因自訂視窗而使同一邏輯畫面擁有不同的 AD_Window_ID。透過 FLUTTER_SCREEN_ALIASES SysConfig，可將伺服器特有的 ID 對應到 App 已註冊的標準 ID。

Value 格式（JSON）：

{
  "W:1000555": "W:143",
  "W:1000888": "W:322",
  "X:2000001": "X:1000018"
}
  • Key：伺服器特有的 action:targetId
  • Value：App 已註冊的標準 action:targetId
  • 支援所有 action 類型：W（視窗）、P/R（處理程序/報表）、X（表單）、I（資訊視窗）、F（工作流程）
  • 登入時自動從伺服器取得並快取；若 SysConfig 不存在，不影響現有功能

專案架構

採用 Feature-based 模組化架構，每個功能獨立於 lib/features/{name}/ 目錄，包含 data/（API）、domain/（邏輯）、presentation/（UI）三層。

  • 路由自動注冊 — 每個 feature 匯出自己的 routes，app_router.dart 以 spread 語法組裝
  • 儀表板模組注冊 — DashboardModule 配置驅動，新功能加一行即上首頁
  • 共用服務層 — WarehouseService（庫存/儲位）、MovementService（移動單）、SecureNetworkImage（安全圖片載入）

業務流程

使用者可自訂移動路徑（Transfer Route），定義入庫與出庫的來源/目的倉庫。系統不再綁定固定的三倉模式，而是依據使用者設定的路徑進行藥品移動。

來源倉庫 ──── 入庫路徑 ────► 目的倉庫 ──── 出庫路徑 ────► 目的儲位
（依路徑設定）             （依路徑設定）             （依路徑設定）

首次使用指南

步驟一：安裝 App

從 App Store (iOS)、Google Play (Android) 下載安裝，或透過瀏覽器開啟 Web 版本。

步驟二：登入系統

  1. 開啟 App，確認伺服器 URL 旁的連線指示燈（綠色＝已連線）
  2. 輸入 iDempiere ERP 帳號及密碼
  3. 點擊「登入」按鈕

步驟三：設定移動路徑

  1. 進入底部導覽列的「設定」頁面
  2. 點擊「移動路徑管理」
  3. 點擊「+」新增至少一條入庫路徑和一條出庫路徑
  4. 設定來源倉庫與目的倉庫

步驟四：開始使用

回到首頁儀表板，即可開始使用各項功能。功能卡片依角色權限自動顯示。

🌐 English Version

System Overview

iDempiere Mobile is a cross-platform ERP mobile app deeply integrated with iDempiere ERP via REST API. Built with Flutter, it supports iOS, Android, Web, Windows, and macOS.

49 Key Features

The app covers approval workflows, inventory management, report generation, data maintenance (CRUD), instant messaging, meeting room booking, team attendance, quality management, leave requests, R&D cost analysis, and more — all filtered by role-based access control.

White-Label Branding (AD_SysConfig)

Customize app name, theme color, and feature visibility through iDempiere AD_SysConfig. All features are enabled by default (opt-out model — set to N to disable).

AD_SysConfig Key Default Description
MOBILE_APP_NAME iDempiere Mobile App title bar display name
MOBILE_SEED_COLOR #2196F3 Theme seed color (hex)
MOBILE_SHOW_QUOTE On Home quote section, set N to hide
MOBILE_FEATURE_CHAT On Chat module, set N to hide
MOBILE_FEATURE_BOOKING On Room booking module, set N to hide
MOBILE_FEATURE_TRANSFER On Transfer module, set N to hide

Project Architecture

Feature-based modular architecture. Each feature is self-contained in lib/features/{name}/ with data/, domain/, and presentation/ layers. Routes auto-register, dashboard modules are config-driven.

Business Process

Users define custom Transfer Routes for inbound/outbound warehouse operations. The system uses these routes instead of hardcoded warehouse assignments.

First-Time Setup Guide

  1. Install the app on your device
  2. Log in with your iDempiere credentials
  3. Go to Settings → Transfer Route Management → create at least one inbound and one outbound route
  4. Return to the dashboard and start using the app