快速入門

系統簡介

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

59 項主要功能

功能 說明
簽核作業 審核 ERP 工作流程
組織庫存查詢 跨倉庫查詢料號/批號庫存 + Production 保留量
工作請求 R_Request 工作票務管理（狀態追蹤 + 備註）
報表與處理程序 執行 ERP 報表/流程，支援 PDF/HTML/Excel/CSV 輸出，內嵌預覽，支援報表/處理程序類型篩選
會議室預約 週曆/日曆/時間軸（甘特圖）檢視會議室預約，支援資源類型篩選、重疊事件並排顯示、創立人名稱、新增/編輯/刪除
團隊出勤 查看團隊成員的請假與加班狀況
入庫作業 依移動路徑將藥品從來源倉庫轉入目的倉庫
出庫作業 依移動路徑從來源倉庫領料至目的儲位
庫存查詢 查詢路徑相關倉庫的藥品庫存（含低庫存警示）
資訊查詢 ERP 資訊視窗查詢，支援型別感知條件、欄位排序、收藏、分頁結果
掃碼查詢 掃描條碼/QR Code 快速查看產品資訊
QR 標籤 為庫存藥品產生 QR Code 標籤
批次作業 批次入庫/出庫，一次處理多筆移動
深色模式 支援明/暗主題切換
訊息 即時通訊：1-on-1、群組聊天、圖片/檔案傳送、已讀回條
狀態指標 首頁顯示 iDempiere 狀態列 KPI 卡片（營收、訂單數等即時數據）
數據圖表 首頁「數據分析」區塊顯示 iDempiere 圖表（長條圖/折線圖/圓餅圖）
公告欄 首頁顯示 iDempiere AD_Note 公告輪播，支援確認（Acknowledge）機制
ERP 動態選單 依登入角色自動載入 iDempiere 選單樹，分類顯示可存取的功能項目
角色權限控制 所有模組依角色權限過濾，顯示 R/W（可讀寫）或 R（唯讀）標示
自動續登 Token 過期時自動 Refresh Token 續登
生物辨識 支援 FaceID / TouchID 快速登入（可在設定中開關）
文件列印匯出 任何 ERP 記錄可匯出為 PDF/HTML/Excel/CSV，一鍵分享
請購單 請購單 CRUD（草稿→完成→作廢），含明細行、狀態篩選、搜尋
盤點作業 掃碼盤點：掃描條碼自動帶入產品/帳面數，輸入實際數量，差異標示
進貨收料 進貨收料（M_InOut），支援供應商選擇、採購單參照、條碼驗收
業務夥伴 C_BPartner 名錄（客戶/供應商/員工篩選），含聯絡資訊、地址
發票瀏覽 C_Invoice 瀏覽（應付/應收篩選），含明細行、付款狀態、PDF 匯出
品質管理 QM_Specification 品質規格管理，輸入檢測結果（實際值 + 合格/不合格）
請假申請 HR_LeaveRequest 請假單（建立→送簽→作廢），含假別、日期範圍、天數計算
伺服器管理 管理員儀表板：伺服器健康狀態、排程器啟停、快取統計與清除
背景作業 報表/處理程序支援背景執行，自動輪詢狀態，完成後可下載結果
API 可靠性 自動重試（指數退避）、斷路器（連續失敗快速失敗）、延長逾時
分塊上傳 大檔案分塊上傳，支援單塊重試、進度回報
批次 API 交易性批次操作（多筆 API 合併為單一交易），入庫/出庫已重構使用
研發成本分析 R&D 專案三維成本（材料/人工/設備）儀表板，材料成本來自 Fact_Acct 會計分錄
工時記錄 研究員工時 CRUD（專案、配方、日期、時數、時薪），支援分頁與刪除
設備使用記錄 實驗室設備使用時數 CRUD（固定資產、日期、時數、費率）
研究員生產力 長條圖 + 表格呈現研究員工時、配方數、批次數、平均工時/配方
生產計劃看板 甘特圖式生產排程看板，雙層展開（產線→工段），支援工單操作
八大循環文件畫面 依會計八大循環分類，11 個 ERP 文件畫面
報價邀請（RfQ） RfQ Topic / RfQ / RfQ Response 三畫面，支援多層子記錄
現金部位儀表板 跨組織現金餘額 + AR/AP 預測折線圖
阿米巴組織儀表板 依 Fact_Acct 會計分錄計算各組織營收/費用
研發實驗管理 實驗 CRUD、測試結果（合格/不合格/待定）、測試趨勢圖表
生產循環套件 15 個生產畫面（11 Config-Driven + 4 Custom）
OData 型別安全工具 ODataFilter/ODataExpand 建構器，防止篩選語法錯誤
文件畫面框架 Config-Driven 泛用框架，~50 行設定檔即可產生完整 CRUD 畫面
薪資明細 查看個人薪資明細（底薪、出勤、加班、津貼、扣除、實發金額）
假別餘額 各類假別剩餘天數總覽（18 種台灣法定假別），年度選擇
假別調整 假別額度調整記錄管理，支援完成/作廢文件動作
班別定義 公司班別資訊查詢（上下班時間、休息時間、輪班津貼）
輪班排程 員工輪班指派紀錄查詢（員工、班別、有效期間）
打卡紀錄 近三個月個人打卡（刷卡）紀錄查詢
投票系統 建立投票/匿名投票、選項管理、截止日、即時結果長條圖
成就徽章 徽章解鎖進度、稀有度分級（普通/稀有/史詩/傳說）
任務看板 志工任務發布與報名、難度星級/優先級/截止日管理
通知偏好 7 類推播通知個別開關（簽核/公告/投票/徽章/任務等）
我的頁面 個人化首頁：時段問候語、摘要卡片、公告/投票/任務速覽

白牌品牌設定（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.

59 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
🇯🇵 日本語版

システム概要

iDempiere Mobile は、iDempiere ERP と REST API で深く連携するモバイル向けエンタープライズリソースプランニングアプリです。Flutter で構築されており、iOS、Android、Web、Windows、macOS の 5 プラットフォームに対応しています。

59 の主要機能

承認ワークフロー、在庫管理、帳票出力、データ保守（CRUD）、インスタントメッセージ、会議室予約、チーム勤怠、品質管理、休暇申請、研究開発コスト分析など 59 機能を搭載し、すべてロールベースのアクセス制御で自動フィルタリングされます。

ホワイトラベル設定（AD_SysConfig）

iDempiere の AD_SysConfig を通じて、アプリ名、テーマカラー、機能の表示/非表示をカスタマイズできます。すべての機能はデフォルトで有効（オプトアウト方式 — N に設定して無効化）です。

AD_SysConfig キー デフォルト値 説明
MOBILE_APP_NAME iDempiere Mobile タイトルバーの表示名
MOBILE_SEED_COLOR #2196F3 テーマカラー（16 進数）
MOBILE_SHOW_QUOTE 有効 ホーム画面の名言セクション、N で非表示
MOBILE_FEATURE_CHAT 有効 チャットモジュール、N で非表示
MOBILE_FEATURE_BOOKING 有効 会議室予約モジュール、N で非表示
MOBILE_FEATURE_TRANSFER 有効 入出庫モジュール、N で非表示

プロジェクト構成

機能ベースのモジュラーアーキテクチャを採用。各機能は lib/features/{name}/ 内に data/、domain/、presentation/ の 3 レイヤーで自己完結しています。ルートは自動登録され、ダッシュボードモジュールは設定駆動です。

業務フロー

ユーザーは入庫/出庫の倉庫操作用に独自の移動ルート（Transfer Route）を定義できます。ハードコードされた倉庫割当ではなく、これらのルート設定に基づいて処理が行われます。

初回セットアップガイド

  1. お使いのデバイスにアプリをインストール
  2. iDempiere の認証情報でログイン
  3. 設定 → 移動ルート管理 → 入庫ルートと出庫ルートを最低 1 つずつ作成
  4. ダッシュボードに戻り、アプリの利用を開始

按 Enter 搜尋，ESC 關閉