主畫面與導覽
登入成功後進入主畫面，底部提供三個導覽頁籤：
底部導覽列
| 圖示 | 頁籤 | 說明 |
|---|---|---|
| 📊 | 首頁 | 儀表板（功能快捷卡片 + 摘要資訊） |
| 📷 | 掃碼 | 條碼/QR Code 掃描查詢 |
| ⚙️ | 設定 | 主題切換、伺服器設定、登出 |
儀表板模組
首頁上方依序顯示以下區塊：
- 語錄 — 稻盛和夫名句（支援展開、複製、分享）
- 狀態指標列 — 水平滑動 KPI 卡片，顯示 iDempiere AD_StatusLine 即時數據（營收、訂單數等）
- 工作請求 TODO 面板 — 指派給自己的工作票務
- 公告欄 — AD_Note 自動輪播卡片，支援確認（Acknowledge）機制
- 最近活動
- 功能卡片網格 — 平板裝置自動切換三欄佈局
- 數據分析 — iDempiere 互動圖表
- ERP 選單 — 依角色權限自動載入
KPI 狀態指標卡片
首頁頂部的水平滑動卡片列，顯示 iDempiere AD_StatusLine 預計算訊息：
- 營收數據、待辦數量等即時 KPI
- 由 iDempiere 伺服器端設定，App 自動抓取
- 支援下拉刷新更新數據
互動圖表
「數據分析」區塊自動從 iDempiere AD_Chart 拉取資料並渲染為互動圖表：
- 支援圖表類型：長條圖（BarChart）、堆疊長條圖（StackedBarChart）、折線圖（LineChart）、圓餅圖（PieChart）、3D 圓餅圖、環形圖（RingChart）
- 使用 fl_chart 函式庫渲染
- 零設定 — 圖表由伺服器端設定，App 自動顯示
工作請求 TODO 面板
首頁上方的工作請求面板，讓您一進 App 就看到指派給自己的工作票務：
- 預設展開顯示 ChoiceChip 狀態標籤（待辦事項/處理中/待驗收/問題/已結案）
- 每個標籤顯示該狀態下的請求數量，例如「待辦事項 (8)」
- 只顯示指派給自己或自己提出的工作請求
- 預設顯示前 5 筆，點擊「顯示全部 (N)」展開完整列表
- 點擊標題列可收合/展開面板
- 點擊 [+] 可新增工作請求
看板拖放操作
進入完整 Tab 頁面後，卡片支援跨狀態拖放：
- 長按卡片開始拖曳（卡片浮起帶有陰影效果）
- 拖曳至目標狀態欄位 — 欄位邊框與背景高亮提示
- 放開卡片 — 系統自動呼叫 API 更新
R_Status_ID - 成功後顯示綠色提示訊息，所有欄位自動刷新
公告欄
- 自動從 iDempiere
AD_Note抓取未處理的通知，以 PageView 輪播卡片呈現 - 每 5 秒自動切換頁面，手動滑動後重設計時器
- 點擊卡片可查看完整內容並「確認」標記為已處理
- 無未處理公告時區塊自動隱藏
ERP 選單樹
首頁下方「ERP 選單」區塊，自動從 iDempiere 選單樹取得當前角色可存取的功能項目：
- 動態載入 — 登入時從
GET /menutree/{id}自動取得 - 角色權限 — 僅顯示當前角色有存取權的功能
- 分類顯示 — 依選單 Summary 節點自動分類，可獨立展開/收合
- 功能導航 — 點擊即可跳轉至對應的視窗、報表、資訊視窗或工作流程
- 快取機制 — 選單資料快取於裝置，切換角色時自動清除
小工具網格（Dashboard Widget Grid）
儀表板模組支援彈性元件配置：
三種尺寸
| 尺寸 | 格數 | 說明 |
|---|---|---|
| 小 (S) | 1×1 | 單一數值指標 |
| 中 (M) | 2×1 | 指標 + 迷你折線圖（近 12 個月趨勢） |
| 大 (L) | 2×2 | 完整圖表 + 趨勢分析 |
拖曳調整
- 長按進入編輯模式，可拖曳排序、調整元件大小
- 14 個業務分類（核心、庫存、銷售、採購、生產、薪資、財務等），可收合/展開
響應式佈局
| 裝置 | 欄數 |
|---|---|
| 手機 | 3 欄 |
| 平板（直向） | 4 欄 |
| 平板（橫向） | 6 欄 |
元件大小、位置、排序、隱藏狀態皆透過 SharedPreferences 持久保存。
功能卡片網格
| 顏色 | 功能 | 說明 |
|---|---|---|
| ● | 簽核作業 | 待審核流程（顯示待辦數量徽章） |
| ● | 組織庫存查詢 | 跨倉庫料號/批號查詢 |
| ● | 入庫作業 | 依入庫路徑移入物品 |
| ● | 出庫作業 | 依出庫路徑領取物品 |
| ● | 庫存查詢 | 查看路徑相關倉庫庫存 |
| ● | 掃碼查詢 | 掃條碼查產品資訊 |
| ● | 報表 | ERP 報表查詢與執行 |
| ● | 團隊出勤 | 查看團隊請假/加班狀況 |
提示：
- 若尚未建立任何移動路徑，首頁頂部會顯示黃色警示卡片
- 支援下拉刷新：在首頁往下拖曳可重新載入工作請求、設定和待辦數量
- 支援全域功能搜尋：在 AppBar 搜尋圖示可即時過濾任何模組功能
設定頁面
| 項目 | 說明 |
|---|---|
| 深色模式 | 開關切換明/暗主題，偏好設定自動儲存 |
| 生物辨識登入 | 開關啟用/停用 FaceID / TouchID 登入 |
| 語言 | 繁體中文 / English / 日本語 |
| 移動路徑管理 | 入庫/出庫移動路徑設定 |
| 登出 | 清除 Token，返回登入畫面 |
🌐 English Version
Main Screen & Navigation
After login, the main screen provides three bottom navigation tabs: Dashboard, Scanner, and Settings.
Dashboard Modules
The dashboard displays in order: Quote → KPI Status Indicators (scrollable cards) → Work Request TODO Panel → Bulletin Board (AD_Note carousel) → Recent Activity → Feature Card Grid → Data Analytics (interactive charts) → ERP Menu (role-filtered).
KPI Status Indicator Cards
Horizontally scrollable cards showing real-time KPI data from iDempiere AD_StatusLine (revenue, order counts, etc.). Configured server-side, displayed automatically.
Interactive Charts
Supports Bar, Stacked Bar, Line, Pie, 3D Pie, and Ring charts from iDempiere AD_Chart data, rendered with fl_chart.
Work Request TODO Panel
- Shows requests assigned to you with status chips (TODO / In Progress / Pending Review / Issue / Closed)
- Kanban drag-and-drop to change status directly
- Create new requests with the [+] button
ERP Menu Tree
Automatically loads the iDempiere menu tree for the current role. Items are categorized by summary nodes, each collapsible. Tap to navigate to windows, reports, info windows, or workflows.
Widget Grid
Three sizes: Small (1×1), Medium (2×1 with sparkline), Large (2×2 with full chart). Drag to reorder and resize. Responsive layout: 3 columns on phone, 4 on tablet portrait, 6 on tablet landscape.
Settings Page
| Item | Description |
|---|---|
| Dark Mode | Toggle light/dark theme |
| Biometric Login | Enable/disable Face ID / Touch ID |
| Language | Chinese / English / Japanese |
| Transfer Routes | Manage inbound/outbound routes |
| Logout | Clear tokens and return to login |