docs: 更新系統設計說明文件與環境設定

.gitignore

@@ -24,3 +24,5 @@ Homestead.yaml
 Thumbs.db
 酒水客戶導入規劃.md
 智慧補貨系統分析報告.md
+
+/docs/pptx_build

FEATURES.md

@@ -0,0 +1,158 @@
+# Star ERP 功能選單詳細說明
+
+## 🌳 系統功能架構樹 (含 2.0 升級規劃)
+```text
+Star ERP
+├── 🏠 儀表板 (Dashboard)
+│   ├── 📊 數據看板 (原有)
+│   ├── 🔔 營運警示 (原有)
+│   ├── ✨ 銷售熱力圖 (新)
+│   ├── ✨ 庫存效期預警 (新)
+│   └── ✨ 待出貨監控 (新)
+├── ✨ 🤝 銷售與全通路 (Sales & CRM) 【New】
+│   ├── ✨ 全通路訂單整合
+│   ├── ✨ 客戶管理 (CRM)
+│   └── ✨ 促銷活動
+├── 📦 商品與庫存管理
+│   ├── 📄 商品資料 (原有)
+│   ├── 🏢 倉庫管理 (原有)
+│   ├── 🚚 內調撥 (原有)
+│   ├── ✨ 屬性管理 (過敏原/成分)
+│   ├── ✨ 效期監控 (FEFO)
+│   └── ✨ 智慧補貨建議 (AI)
+├── ✨ 🚚 智慧物流 (Logistics) 【New】
+│   ├── ✨ 路徑規劃
+│   └── ✨ 裝車單管理
+├── 🏭 生產與品質管理
+│   ├── 📝 生產工單 (原有)
+│   ├── 🧪 原料耗用 (原有)
+│   ├── ✨ 配方管理 (Recipe)
+│   ├── ✨ 品質檢驗 (QC)
+│   └── ✨ 雙向溯源 (原料<->成品)
+├── 🛒 採購與廠商
+│   ├── 👥 廠商資料 (原有)
+│   ├── 📝 採購單 (原有)
+│   └── ✨ 供應商評鑑 (新)
+├── 💰 財務管理
+│   ├── 🧾 公共事業費 (原有)
+│   ├── ✨ 應收/應付帳款 (AR/AP)
+│   └── ✨ 成本精算 (料工費)
+├── 📊 報表管理
+│   └── 📑 會計報表 (原有)
+└── ⚙️ 系統管理 (原有)
+    ├── 👤 使用者管理
+    ├── 🛡️ 角色與權限
+    └── 📜 操作紀錄
+```
+
+本文件詳細說明 Star ERP 各模組功能，並特別標註 **✨ 新增/強化** 之功能（針對 ERP 2.0 規劃）。
+
+---
+
+## 1. 🏠 儀表板 (Dashboard)
+系統的戰情中心，提供即時營運數據與警示。
+
+### 🔹 原有功能
+- **數據看板**：顯示商品總數、供應商數、活躍倉庫數等基礎營運指標。
+- **營運警示**：顯示低庫存商品與待辦事項（如待審核單據）。
+
+### ✨ 新增/強化功能
+- **銷售熱力圖 (零售用)**：視覺化呈現熱銷時段與區域，輔助行銷決策。
+- **庫存效期預警 (食品/化妝品用)**：針對即期品自動發出警示，協助優先促銷或處理，減少報廢。
+- **待出貨監控**：即時追蹤已接單但尚未指派物流或出貨的訂單，避免訂單延遲。
+
+---
+
+## 2. ✨ 🤝 銷售與全通路 (Sales & CRM) 【New】
+針對 B2B 與 B2C 混合模式設計，整合多來源訂單與客戶關係。
+
+### ✨ 核心功能
+- **全通路訂單**：統一整合來自 POS、品牌電商官網、智慧販賣機的訂單，集中處理。
+- **客戶管理 (CRM)**：建立完整的會員資料庫，記錄消費歷史與會員等級。
+- **促銷活動**：內建價格策略引擎，支援滿額折、買一送一、組合價等靈活折扣管理。
+
+---
+
+## 3. 📦 商品與庫存管理
+支援食品業與零售業特性的高階庫存系統。
+
+### 🔹 原有功能
+- **商品資料**：管理品名、規格、多單位換算。
+- **倉庫管理**：多站點（實體/虛擬）倉庫設定與庫存監控。
+- **內調撥**：倉庫間的庫存轉移功能。
+
+### ✨ 新增/強化功能
+- **屬性管理**：
+    - **食品業**：標註過敏原資訊。
+    - **化妝品**：標註全成分表與保存條件。
+- **效期監控 (FEFO)**：系統強制執行「先到期先出 (First Expired First Out)」邏輯，優於傳統 FIFO，確保出貨商品新鮮度。
+- **智慧補貨建議**：AI 依據歷史銷量趨勢，自動計算建議補貨量，避免斷貨或過量庫存。
+
+---
+
+## 4. ✨ 🚚 智慧物流 (Logistics) 【New/Split】
+針對冷鏈配送與多點補貨的最佳化工具。
+
+### ✨ 核心功能
+- **路徑規劃**：針對多點配送進行路線最佳化演算，節省油資與配送時間。
+- **裝車單管理**：自動產出物流車領貨總表，協助倉管與司機快速核對上車貨品。
+
+---
+
+## 5. 🏭 生產與品質管理 (升級)
+食品加工與製造的核心模組，重視配方精準度與食安溯源。
+
+### 🔹 原有功能
+- **生產工單**：排程管理、生產入庫。
+- **原料耗用**：記錄生產過程消耗的原物料扣量。
+
+### ✨ 新增/強化功能
+- **配方管理 (Recipe)**：
+    - 支援百分比配方設定。
+    - 設定各製程階段的預期損耗率。
+    - 完整的配方版本控制 (Version Control)。
+- **品質檢驗 (QC)**：
+    - 涵蓋進料檢驗 (IQC)、製程檢驗 (IPQC)、成品檢驗 (FQC)。
+    - 自動產出 COA (Certificate of Analysis) 品質分析報告。
+- **雙向溯源**：
+    - **正向**：原料批號 -> 用於哪些成品。
+    - **逆向**：成品批號 -> 來自哪些原料 -> 供應商是誰。
+
+---
+
+## 6. 🛒 採購與廠商
+掌握供應鏈源頭與進貨管理。
+
+### 🔹 原有功能
+- **廠商資料**：基本聯絡資訊與付款條件設定。
+- **採購單**：完整的詢價、下單、收貨與驗收流程。
+
+### ✨ 新增/強化功能
+- **供應商評鑑**：系統自動分析廠商績效，包含「交期準時率」與「原料合格率」，作為管理依據。
+
+---
+
+## 7. 💰 財務管理 (升級)
+從費用記錄升級為經營分析與成本精算中心。
+
+### 🔹 原有功能
+- **公共事業費**：記錄水電氣網等非商品類別之固定支出。
+
+### ✨ 新增/強化功能
+- **應收/應付帳款 (AR/AP)**：
+    - 管理客戶與廠商的帳期 (Credit Terms)。
+    - 自動化對帳單與未結帳款提醒。
+- **成本精算**：
+    - 實作分攤邏輯，將「料（原料）、工（工時）、費（製造費用）」精確分攤至單一商品成本。
+    - 提供即時毛利分析報表 (Gross Margin Analysis)。
+
+---
+
+## 8. 📊 報表管理
+- **會計報表**：支出總表、採購分析。
+- **資料匯出**：支援 CSV/Excel 格式匯出。
+
+## 9. ⚙️ 系統管理
+- **使用者管理**：帳號維護。
+- **角色與權限 (RBAC)**：細緻的功能權限控管。
+- **操作紀錄 (Audit Log)**：全系統關鍵行為軌跡留存。

README.md

@@ -23,8 +23,12 @@ Star ERP 是一個基於 **Laravel 12**、**Inertia.js (React)** 與 **Tailwind
   - 👥 **廠商資料管理** (`/vendors`) - `vendors.view`
 - 🛒 **採購管理**
   - 📝 **採購單管理** (`/purchase-orders`) - `purchase_orders.view`
+- 🏭 **生產管理**
+  - 📦 **生產工單** (`/production-orders`) - `production_orders.view`
 - 💰 **財務管理**
   - 🧾 **公共事業費** (`/utility-fees`) - `utility_fees.view`
+- 📊 **報表管理**
+  - 📑 **會計報表** (`/accounting-report`) - `accounting.view`
 - ⚙️ **系統管理**
   - 👤 **使用者管理** (`/admin/users`) - `users.view`
   - 🛡️ **角色與權限** (`/admin/roles`) - `roles.view`

docs/AI 導向組裝式 ERP 產業佈局與趨勢分析.md

@@ -0,0 +1,55 @@
+這是一個非常有商業價值的提問。根據現有的市場數據與技術趨勢報告，您的專案所鎖定的四大產業（零售、物流、食品、化妝品），不僅覆蓋了 ERP 市場的主流需求，且您目前採用的「智慧販賣機（IoT）+ 實體店（POS/配方）」切入點，正完全符合未來 ERP 發展的 **「組裝式（Composable）」** 與 **「智慧化（Intelligent）」** 兩大趨勢。
+
+以下根據最新的行業報告為您分析市場佔比與未來適用性：
+
+## 1. 市場覆蓋率分析：您鎖定的四大產業佔比多少？
+
+您的四大產業（零售、物流、食品、化妝品）實際上涵蓋了 ERP 市場中 **超過 60% 至 70%** 的核心需求領域。
+
+根據 SelectHub 與 Grand View Research 的數據顯示，ERP 的應用產業分佈如下：
+
+*   **製造業（Manufacturing）**：約佔 47%。
+    *   *重點分析*： 這裡的製造業分為「離散製造（如組裝汽車）」與「流程製造（如攪拌原料）」。您的 **食品業** 與 **化妝品業** 正屬於 「流程製造（Process Manufacturing）」 與 「消費包裝商品（CPG）」 領域。這意味著您已經切入了製造業中與民生消費最相關的半壁江山。
+*   **分銷與物流（Distribution/Logistics）**：約佔 18%。
+    *   *重點分析*： 這是您的 **物流業** 與 **智慧販賣機（補貨配送）** 的核心領域。
+*   **零售與服務業（Retail & Services）**：合計約佔 15% 以上。
+    *   *重點分析*： 這是您的 **小小冰室** 與 **販賣機銷售端** 的領域。
+
+**結論**： 如果您將「食品與化妝品（流程製造）」、「物流配送」與「零售銷售」加總，您的 ERP 系統架構幾乎覆蓋了除重工業（如造船、營建）以外的所有高頻消費市場。這是一個規模數千億美元的龐大市場。
+
+---
+
+## 2. 在 AI 趨勢下，這個專案還能適用嗎？
+
+答案是肯定的，而且您的「販賣機 + 冰室」模式比傳統 ERP 更具 AI 優勢。
+
+傳統 ERP 往往只是「記錄數據的工具」（System of Record），但未來的 ERP 必須是**「智慧決策的平台」（System of Intelligence）**。您的專案因為天生帶有 **IoT（販賣機）** 和 **直接面對消費者（冰室）** 的基因，正好能發揮以下 AI 關鍵趨勢：
+
+### A. 您的「智慧販賣機」是 AI 的最佳載體 (IoT + Edge Computing)
+*   **趨勢**： 2025 年後的 ERP 強調 **物聯網（IoT）** 與 **邊緣運算** 的整合。
+*   **您的優勢**： 您的販賣機本身就是一個 IoT 設備。
+    *   *應用場景*： 透過 AI 分析感測器數據，系統可以實現 **「預測性維護」**（在販賣機故障前自動通知維修），以及即時監控庫存溫度（這對食品/化妝品至關重要）。傳統 ERP 很難做到這一點，但您的系統天生具備此能力。
+
+### B. 食品與化妝品業極度依賴 AI 進行「效期與配方優化」
+*   **趨勢**： 流程製造業正在利用 AI 進行 **配方管理** 與 **效期預測**。
+*   **您的優勢**： 您的「小小冰室」需要管理食材效期（FEFO）。
+    *   *應用場景*： 未來的 AI 模組可以根據天氣、季節和歷史銷量，自動預測「下週草莓會用多少」，並建議最佳採購量，減少報廢。這直接解決了食品與化妝品業最頭痛的庫存過期問題。
+
+### C. 物流配送的 AI 路徑規劃
+*   **趨勢**： 物流 ERP 正在結合 AI 進行 **供應鏈優化**。
+*   **您的優勢**： 您的販賣機需要補貨。
+    *   *應用場景*： AI 可以計算出「哪幾台販賣機快缺貨了」以及「卡車怎麼走最省油」。這種 **智慧補貨（Intelligent Replenishment）** 功能是物流業的高階需求。
+
+---
+
+## 3. 未來架構建議：邁向「組裝式 ERP (Composable ERP)」
+
+為了確保您的系統在 2025-2030 年仍然領先，請不要將它做成一個巨大的單體軟體，而應該採用 **「組裝式 ERP」** 架構。
+
+*   **定義**： 將「財務」、「庫存」、「POS」、「配方」做成獨立的積木（模組），透過 API 連接。
+*   **為什麼適合您？**
+    *   對於 **甜點店**：他們只需要「POS + 配方 + 財務」模組。
+    *   對於 **販賣機營運商**：他們只需要「IoT 監控 + 物流 + 財務」模組。
+    *   對於 **化妝品品牌**：他們需要「配方 + 批號追蹤 + 全通路銷售」模組。
+
+**總結來說**，您的專案方向精準地切中了市場上「高周轉、重品質、需配送」的核心產業群。只要您在開發初期就將 **數據結構標準化**（為了 AI）並採用 **API 優先** 的設計（為了組裝式架構），這套系統不僅不會過時，反而在 AI 時代會因為擁有「即時末端數據（販賣機）」而比傳統 ERP 更具競爭力。

docs/四大產業ERP系統擴充藍圖.md

@@ -0,0 +1,184 @@
+針對您鎖定的四大產業方向：零售業 (Retail)、物流業 (Logistics)、食品業 (Food & Beverage) 與 化妝品業 (Cosmetics)，目前的系統功能架構在「基礎建設」上已經具備雛形，但在「產業深度」與「銷售循環」上需要顯著擴充。
+
+食品與化妝品業屬於**「流程製造」(Process Manufacturing)，極度重視配方、效期與品質合規。零售與物流業則強烈依賴全通路銷售 (Omnichannel)**、CRM 與 運輸管理。
+
+以下為您整合的擴充功能建議，以及包含現有功能與新功能的完整樹狀圖。
+
+## 🚀 針對四大產業的關鍵擴充功能整合
+
+### 1. 銷售與客戶關係管理 (針對零售業)
+您目前的系統有「採購」(買進)，但缺少「銷售」(賣出)。對於零售業，必須建立「訂單到現金 (Order-to-Cash, O2C)」的完整流程。
+*   **全通路訂單管理 (Omnichannel Order Management)**： 整合來自實體店 (POS)、電商平台 (Shopify/Amazon) 與批發通路的訂單。
+*   **CRM (客戶關係管理)**： 紀錄客戶購買歷史、偏好，支援會員制度與行銷活動，這對提升零售回購率至關重要。
+*   **POS 整合介面**： 支援前台收銀數據即時回傳扣庫存。
+
+### 2. 品質與合規管理 (針對食品/化妝品業)
+食品與化妝品不同於一般組裝業，若發生食安問題需要能立即追溯。
+*   **批號與效期追蹤 (Lot & Expiry Tracking)**： 這是食品/化妝品業的核心。需支援「先進先出 (FIFO)」或「先過期先出 (FEFO)」的庫存邏輯，並具備過期預警。
+*   **品質檢驗 (QC/QA)**： 在「收貨」、「生產中」與「出貨前」設置檢驗關關卡，記錄檢測數據 (如 pH 值、微生物檢測)。
+*   **配方管理 (Formula/Recipe Management)**： 取代傳統 BOM，管理成分比例、過敏原資訊與替代原料。
+
+### 3. 智慧物流與倉儲 (針對物流業)
+現有的倉庫管理需從「靜態存放」升級為「動態流動」。
+*   **運輸管理 (TMS) 整合**： 規劃配送路徑、車隊管理、運費計算及貨物追蹤。
+*   **條碼/QR Code 掃描作業**： 透過手持裝置進行入庫、揀貨 (Picking) 與盤點，減少人為錯誤並提升速度。
+
+### 4. 完整財務管理 (通用核心)
+目前的「公共事業費」僅是財務的一小部分。
+*   **應收/應付帳款 (AR/AP)**： 管理對客戶的收款 (AR) 與對廠商的付款 (AP)，這是現金流管理的基礎。
+*   **總帳 (General Ledger)**： 自動將採購、銷售、庫存異動拋轉為會計分錄，產出資產負債表與損益表。
+
+---
+
+## 🌳 整合後的功能樹狀圖 (現有功能 + 🌟擴充建議)
+
+以下結構將您的現有功能（黑色字體）與針對產業特性建議擴充的功能（標示為 🌟）進行了整合：
+
+### 🏠 儀表板 (Dashboard)
+*   數據看板：商品總數、廠商數、採購單量、倉庫數
+*   營運警示：待處理單據、低庫存、🌟 效期預警 (食品/化妝品)、🌟 逾期應收帳款
+*   操作捷徑：快速導航
+*   🌟 BI 智慧分析：銷售趨勢預測、熱銷品排行
+
+### 🛍️ 銷售與 CRM 管理 (🌟 新增模組 - 零售核心)
+*   訂單管理 (Order Management)
+    *   🌟 銷售訂單 (SO) 建立與追蹤
+    *   🌟 電商/POS 訂單同步
+    *   🌟 出貨通知與物流單號串接
+*   CRM 客戶管理
+    *   🌟 客戶基本資料與信用額度
+    *   🌟 購買歷史與會員等級
+    *   🌟 客服紀錄與客訴處理
+
+### 📦 商品與庫存管理
+*   商品資料管理
+    *   資料維護：代碼、名稱、分類、品牌
+    *   多單位換算：個/箱/棧板
+    *   標籤與分類
+    *   🌟 屬性管理：顏色、尺寸、成分/過敏原 (食品)
+*   庫存控制
+    *   現值監控：批號、數量
+    *   🌟 效期管理 (FEFO/FIFO)：控管化妝品/食品保鮮期
+    *   內調撥補單
+    *   🌟 庫存盤點：支援盲盤、循環盤點
+    *   🌟 條碼/QR Code 掃描：支援 PDA/手機作業
+
+### 🏢 倉庫與物流管理 (擴充現有倉庫模組)
+*   站點維護
+    *   倉庫地點、負責人
+    *   🌟 儲位管理 (Bin Management)：精確到貨架位置
+*   運輸配送 (TMS)
+    *   🌟 運費估算與承運商管理
+    *   🌟 配送路徑規劃與司機指派
+
+### 🚚 供應商與採購管理
+*   廠商資料管理
+    *   基本資料：聯絡資訊
+    *   供供貨連結
+    *   🌟 供應商評鑑：交期準確率、品質合格率
+*   採購單管理
+    *   進度追蹤 (草稿~結案)
+    *   入庫連動
+    *   🌟 採購建議：依據安全庫存與銷售預測自動建議
+
+### 🏭 生產與品質管理 (深化製造模組)
+*   生產工單
+    *   產量記錄
+    *   批次管理 (生產批號)
+    *   原料耗用
+    *   🌟 配方/BOM 管理：食品/化妝品專用配方表
+*   品質管理 (QC) (🌟 新增模組)
+    *   🌟 進料檢驗 (IQC)：原料收貨檢驗
+    *   🌟 製程檢驗 (IPQC) & 成品檢驗 (FQC)
+    *   🌟 檢驗報告與證書 (COA) 生成
+
+### 💰 財務會計管理 (擴充現有財務模組)
+*   費用管理
+    *   公共事業費 (水電租金)
+    *   憑證勾稽
+*   核心會計 (🌟 重點擴充)
+    *   🌟 應收帳款 (AR)：開立發票、收款沖帳
+    *   🌟 應付帳款 (AP)：廠商請款、付款排程
+    *   🌟 總帳 (GL)：自動生成傳票、會計科目管理
+    *   🌟 成本核算：計算商品落地成本與生產成本
+
+### 📊 報表與決策支援
+*   營運報表
+    *   支出彙整
+    *   資料導出 (CSV/Excel)
+    *   🌟 銷售分析報表：按產品/客戶/通路
+    *   🌟 庫存週轉率報表
+    *   🌟 毛利分析報表
+
+### ⚙️ 系統管理
+*   使用者與權限
+    *   帳號管控
+    *   RBAC 角色權限
+*   安全與稽核
+    *   操作紀錄 (行為審計)
+    *   🌟 資料備份與還原
+    *   🌟 API 整合管理 (對接電商/物流商)
+
+---
+
+這個架構將使您的系統從一個「記錄工具」轉變為一個能夠支援零售銷售、確保食品合規、並優化物流效率的「全方位 ERP 平台」。建議您優先開發 **「銷售與 CRM」** 及 **「應收/應付帳款」** 模組，這能最快為零售與貿易型客戶帶來價值。
+
+
+---
+
+## 🌳 全球產業佈局功能樹狀圖 (Text Tree)
+
+```text
+├── 🏠 儀表板 (Dashboard)
+│   ├── 📊 數據看板 (原有)
+│   ├── 🔔 營運警示 (原有)
+│   ├── ✨ 銷售趨勢預測 (新)
+│   └── ✨ 熱銷品排行 (新)
+├── ✨ 🛍️ 銷售與 CRM 管理 (Sales & CRM) 【New】
+│   ├── ✨ 銷售訂單 (SO) 建立與追蹤
+│   ├── ✨ 電商/POS 訂單同步
+│   ├── ✨ 出貨通知與物流單號串接
+│   ├── ✨ 客戶基本資料與信用額度
+│   ├── ✨ 購買歷史與會員等級
+│   └── ✨ 客服紀錄與客訴處理
+├── 📦 商品與庫存管理 (Product & Inventory)
+│   ├── 🏷️ 資料維護 (原有)
+│   ├── 🏷️ 多單位換算 (原有)
+│   ├── ✨ 屬性管理 (顏色/尺寸/成分) (新)
+│   ├── 🔎 現值監控 (原有)
+│   ├── ✨ 效期管理 (FEFO/FIFO) (新)
+│   ├── ✨ 庫存盤點 (盲盤/循環) (新)
+│   └── ✨ 條碼/QR Code 掃描作業 (新)
+├── 🏢 倉庫與物流管理 (Warehouse & Logistics)
+│   ├── 🏭 站點維護 (原有)
+│   ├── ✨ 儲位管理 (Bin Management) (新)
+│   ├── ✨ 運費估算與承運商管理 (新)
+│   └── ✨ 配送路徑規劃與司機指派 (新)
+├── 🚚 供應商與採購管理 (Supplier & Purchasing)
+│   ├── 🤝 廠商資料管理 (原有)
+│   ├── ✨ 供應商評鑑 (新)
+│   ├── 📝 採購單管理 (原有)
+│   └── ✨ 智慧採購建議 (新)
+├── 🏭 生產與品質管理 (Production & QC)
+│   ├── 🔨 生產工單 (原有)
+│   ├── ✨ 配方/BOM 管理 (新)
+│   ├── ✨ 進料檢驗 (IQC) (新)
+│   ├── ✨ 製程檢驗 (IPQC) & 成品檢驗 (FQC) (新)
+│   └── ✨ 檢驗報告與證書 (COA) 生成 (新)
+├── 💰 財務會計管理 (Finance)
+│   ├── 💵 費用管理 (原有)
+│   ├── ✨ 應收帳款 (AR) (新)
+│   ├── ✨ 應付帳款 (AP) (新)
+│   ├── ✨ 總帳 (GL) (新)
+│   └── ✨ 成本核算 (新)
+├── 📊 報表與決策支援 (Reports)
+│   ├── 📉 營運報表 (原有)
+│   ├── ✨ 銷售分析報表 (新)
+│   ├── ✨ 庫存週轉率報表 (新)
+│   └── ✨ 毛利分析報表 (新)
+└── ⚙️ 系統管理 (System)
+    ├── 👤 使用者與權限 (原有)
+    ├── 🔒 操作紀錄 (原有)
+    ├── ✨ 資料備份與還原 (新)
+    └── ✨ API 整合管理 (新)
+```

docs/星科技 ERP：餐飲與物聯網雙軌管理系統設計.md

@@ -0,0 +1,80 @@
+這是一個非常獨特的切入點。雖然您的「小小冰室」客戶（甜點店）與您的主業（智能販賣機）目前在業務上是獨立的，但從系統架構 (System Architecture) 的角度來看，將這兩者的需求納入考量，可以讓您開發出一套極具競爭力的「新零售 ERP」。
+
+這意味著您正在構建的是一個**「混合型零售平台」(Hybrid Retail Platform)：它既能處理實體店面的「人工作業」（如甜點製作、櫃台收銀），也能處理智能販賣機的「自動化作業」**（如物聯網監控、遠端庫存）。
+
+根據您的背景與客戶需求，我建議採用 **「組裝式 ERP (Composable ERP)」** 的概念，將系統核心模組化。這樣既能滿足甜點店的配方與效期管理，又能保留您主業需要的物聯網 (IoT) 監控能力。
+
+以下是針對這種「雙軌並行」需求的深度功能規劃建議與樹狀圖：
+
+## 🚀 核心策略：F&B (餐飲) + IoT (物聯網) 的雙重基因
+
+1.  **甜點店客戶的需求核心 (F&B)**： 重點在於**「效期」與「配方」**。甜點保存期限短，需要嚴格的先進先出 (FIFO) 或先過期先出 (FEFO)。且甜點是「做」出來的，不是單純「買」進來的，所以需要配方管理 (BOM)。
+2.  **智能販賣機的技術優勢 (IoT)**： 重點在於**「即時性」與「遠端管理」**。販賣機就是一個微型倉庫，需要透過 IoT 感測器即時回傳庫存，並自動計算補貨路徑。
+
+將這兩者結合，您的系統將具備市面上傳統 POS 或傳統販賣機系統所沒有的彈性。
+
+---
+
+## 🌳 整合功能樹狀圖 (F&B 實體店 + 智能販賣機架構)
+
+此架構在滿足甜點店的同時，也預留了您主業所需的擴充接口。
+
+### 🏠 智慧戰情室 (Dashboard)
+*   **門店/機台總覽**：同時顯示實體店營收與（未來）販賣機狀態。
+*   **效期預警雷達**：
+    *   甜點店：顯示即將過期的原料（如鮮奶油、水果）。
+    *   販賣機：(預留) 顯示機台內即將過期的商品。
+*   **異常監控**：
+    *   甜點店：庫存過低警示。
+    *   販賣機：(預留) IoT 設備離線/故障警示。
+
+### 🍰 產品與生產管理 (針對甜點店核心)
+*   **商品資料庫**
+    *   基本屬性：品名、價格、條碼。
+    *   多屬性管理：冷熱、甜度、配料 (針對手搖/甜點特性)。
+*   **配方管理 (BOM & Recipe)**
+    *   動態 BOM：定義一個「草莓蛋糕」消耗多少克麵粉、幾顆草莓。
+    *   成本試算：根據原料進價自動計算單個甜點的理論成本。
+*   **生產工單 (輕量版)**
+    *   每日生產計畫：記錄當天廚房預計製作數量（如：布丁 50 個）。
+    *   原料倒扣：生產完成後，自動扣除對應原料庫存。
+
+### 📦 智慧庫存與效期管理 (通用核心)
+*   **批號與效期追蹤 (Lot & Expiry)**
+    *   FEFO 邏輯：系統強制建議優先使用快過期的原料。
+    *   批次溯源：若發生食安問題，可追溯該批甜點使用了哪一批進貨的雞蛋。
+*   **多型態倉庫定義**
+    *   實體倉：甜點店後場、中央廚房。
+    *   移動倉 (預留)：將每一台販賣機視為一個微型倉庫 (Micro-Warehouse)。
+*   **庫存盤點**
+    *   店面：支援手機掃碼盤點。
+    *   販賣機：支援 IoT 自動庫存回報 (與販賣機主板對接)。
+
+### 🤖 銷售與通路管理 (雙模式)
+*   **實體店 POS 介面**
+    *   觸控收銀、會員集點、桌號管理。
+*   **無人零售接口 (API) (針對主業考量)**
+    *   機台通訊協定：預留 MQTT/HTTP 接口，接收販賣機的銷售訊號。
+    *   遠端售價調整：一鍵更新所有販賣機的商品價格。
+
+### 🚚 補貨與物流管理
+*   **智慧補貨建議**
+    *   店面：根據歷史銷量建議明日備料量。
+    *   販賣機：根據即時庫存水位，自動生成補貨單。
+*   **路線規劃 (Route Planning) (針對主業)**
+    *   若未來甜點店要配送至販賣機，系統可計算最佳補貨路徑。
+
+### 💰 財務與結算
+*   **應收/應付 (AR/AP)**
+*   **通路損益分析**：比較「實體店」與「販賣機」(如有) 的利潤率。
+
+---
+
+## 💡 給您的特別建議 (針對甜點店客戶 + 販賣機主業)
+
+1.  **將「販賣機」視為一種特殊的「門市」**： 在資料庫設計時，不要把販賣機當作設備，而是把它當作一個**「Type = Vending Machine」的倉庫或門市**。這樣您的 ERP 邏輯（庫存扣減、銷售報表、補貨單）就可以同時套用在甜點店（有人）和販賣機（無人）上，無需開發兩套系統。
+2.  **強化「配方」與「成品」的轉換**： 甜點店最痛的點是**「原料」變「成品」**的過程很難記帳。您的系統若能透過簡單的「每日生產產量輸入」，自動幫他們扣掉麵粉、糖的庫存，這對甜點店客戶來說價值巨大，也能展示您系統在細節處理上的專業度。
+3.  **預留 IoT 接口 (API First)**： 雖然甜點店現在不用販賣機，但您的主業是販賣機。在開發時，請採用 API 優先 (API-First) 的架構。這樣未來如果甜點店想把他們的招牌餅乾放到您的販賣機去賣，您的系統只需要「打開開關」，讓販賣機透過 API 回傳銷售數據即可，完全不用重寫系統。
+4.  **手機端管理 (Mobile ERP)**： 甜點店老闆通常很忙，要在廚房和櫃檯間跑。開發一個手機版管理介面（或響應式網頁），讓他們能隨時查看營收、進行盤點或批准採購單。這對販賣機巡補貨人員來說也是必備功能。
+
+這個架構能讓您用一套系統核心，同時滿足現有的服務型客戶（甜點店）和您自己的技術型業務（販賣機），實現研發效益最大化。

docs/組裝式 ERP：邁向四大產業的開發藍圖.md

@@ -0,0 +1,119 @@
+您的判斷完全正確。「小小冰室」（甜點店）是「智慧販賣機」的微型縮影與最佳驗證場域（MVP）。
+
+*   **小小冰室**：涵蓋了 「食品業」（配方製作、效期管理）與 「零售業」（門店銷售、POS）。
+*   **智慧販賣機**：涵蓋了 「零售業」（無人銷售、全通路）與 「物流業」（補貨路徑規劃、庫存調度）。
+
+如果您最終目標是打造一個適用於四大產業的 ERP，那麼從這兩個具體業務切入是極佳的策略。您實際上是在構建一個 **「組裝式 ERP (Composable ERP)」**，先從核心模組做起，再針對這兩個場景開發特定功能，未來這些功能就能直接擴充給大型客戶使用。
+
+以下是針對您目前情況（冰室+販賣機），以「邁向四大產業 ERP」為終極目標的建議製作流程與功能架構：
+
+---
+
+## 🚀 階段一：打造通用核心 (Common Core)
+**目標**： 建立所有產業都需要的地基。無論是開冰店還是管販賣機，這些資料結構必須共用，這是未來擴充的關鍵。
+
+1.  **商品主檔 (Product Master Data)**：
+    *   功能： 建立統一的 SKU 編碼規則。
+    *   關鍵設計： 需支援「多屬性」（如甜點的口味、大小）與「多單位轉換」（採購用箱、製作克、販售用個）。這為未來食品業與化妝品業奠定基礎。
+2.  **核心財務 (Core Finance)**：
+    *   功能： 總帳 (GL)、應收帳款 (AR)、應付帳款 (AP)。
+    *   關鍵設計： 冰室的營收（現金/信用卡）與販賣機的金流（電子支付）最終都要匯入這裡。
+3.  **基礎庫存 (Basic Inventory)**：
+    *   功能： 記錄即時庫存數量、倉庫地點（將每台販賣機視為一個移動倉庫）。
+
+---
+
+## 🍰 階段二：針對「小小冰室」開發 (食品製造與門市零售)
+**目標**： 驗證 「食品業」 與 「實體零售」 的深度功能。
+
+1.  **配方與生產管理 (BOM & Production) —— 對應食品業核心**
+    *   功能： 建立「動態配方」（如：1個草莓蛋糕 = 200g 麵粉 + 50g 糖 + 3 顆草莓）。
+    *   邏輯： 當冰室賣出一個蛋糕（或廚房完成製作），系統自動扣減原物料庫存（倒扣料）。
+    *   未來擴充價值： 這套邏輯未來可直接賣給化妝品工廠（配方管理）或大型食品加工廠。
+2.  **效期與批號追蹤 (Lot & Expiry Tracking) —— 對應食品/化妝品業**
+    *   功能： 強制先進先出 (FIFO) 或先過期先出 (FEFO)。
+    *   關鍵設計： 原料入庫時記錄效期，過期自動預警。這是食品安規的關鍵。
+3.  **門市 POS 整合 (Retail POS) —— 對應零售業**
+    *   功能： 前台點單直接串接後台庫存扣減。
+
+---
+
+## 🤖 階段三：針對「智慧販賣機」開發 (無人零售與智慧物流)
+**目標**： 驗證 「物聯網 (IoT)」 與 「物流配送」 的能力。
+
+1.  **IoT 設備整合 (IoT Integration) —— 對應智慧製造/零售**
+    *   功能： 透過 API 即時接收販賣機的回傳數據（銷量、故障訊號、溫度監控）。
+    *   未來擴充價值： 這套 IoT 接口未來可用於冷鏈物流（監控車廂溫度）或工廠設備監控。
+2.  **智慧補貨與路徑規劃 (Replenishment & Route Planning) —— 對應物流業**
+    *   功能： 系統根據販賣機剩餘庫存，自動計算需補貨數量，並規劃補貨員的最佳路徑。
+    *   關鍵設計： 這是物流管理系統 (TMS) 的雛形，未來可擴充為車隊管理。
+3.  **多點庫存分佈 (Multi-location Inventory) —— 對應物流/零售**
+    *   功能： 處理數十台甚至數百台販賣機（微型倉）的庫存調撥。
+
+---
+
+## 📊 階段四：數據決策與全通路整合 (ERP 的大腦)
+**目標**： 將兩個業務的數據匯流，實現 「商業智慧 (BI)」。
+
+1.  **需求預測 (Demand Forecasting)**：
+    *   功能： 利用 AI 分析歷史銷量，預測下週冰室需要備多少草莓，販賣機需要補多少飲料。
+2.  **全通路訂單管理 (Omnichannel Order Management)**：
+    *   功能： 統一查看實體店與販賣機的營收報表，分析哪個通路利潤更高。
+
+---
+
+## 🌳 建議製作功能樹狀圖 (依優先順序排列)
+
+這個樹狀圖展示了從核心到特定業務的開發路徑：
+
+### 🟢 第一階段：通用核心 (所有產業基礎)
+*   系統管理 (使用者權限、資安)
+*   主檔資料 (商品 SKU、多單位換算、供應商資料)
+*   財務模組 (總帳、應收/應付、稅務)
+*   採購管理 (採購單 PO、進貨驗收)
+
+### 🟠 第二階段：小小冰室專用 (食品/實體零售)
+*   生產/製造模組 (輕量版)
+    *   配方管理 (Recipe/BOM)
+    *   生產工單 (製作紀錄)
+    *   原料耗用與倒扣
+*   庫存與品質
+    *   效期管理 (Expiry Date)
+    *   批號追蹤 (Traceability)
+*   銷售端
+    *   POS 銷售數據串接
+
+### 🔵 第三階段：智慧販賣機專用 (物流/IoT/無人零售)
+*   IoT 連接層
+    *   設備狀態監控 (溫度/故障)
+    *   即時銷售回傳
+*   物流與補貨
+    *   補貨建議演算 (基於安全庫存)
+    *   補貨單生成 (Pick list)
+    *   移動倉儲管理 (將機台視為倉庫)
+*   行動端 App
+    *   補貨員作業 App (掃碼補貨)
+
+### 🟣 第四階段：高階智慧化 (邁向四大產業 ERP)
+*   BI 戰情室
+    *   全通路營收分析
+    *   AI 銷量預測
+*   CRM 客戶管理
+    *   會員系統 (跨店/機台集點)
+
+---
+
+## 💡 給您的建議
+
+不要將「冰室」和「販賣機」視為兩個完全不同的專案。請將它們視為您 ERP 系統中的兩種不同**「訂單來源」**與兩種不同**「庫存扣減模式」**。
+
+*   冰室是「原料組合成成品」後扣減（BOM 邏輯）。
+*   販賣機是「成品直接扣減」且涉及「遠端補貨」（物流邏輯）。
+
+先做好這兩個模組，您就等於完成了：
+1. 食品業最難的配方與效期。
+2. 零售業最煩瑣的 POS 串接。
+3. 物流業最核心的補貨調度。
+4. 化妝品業需要的批號追溯（與食品業邏輯相通）。
+
+這樣開發，您現在做的每一行程式碼，都是在為未來四大產業 ERP 鋪路。