在 Maltese POS 專案中工作時使用，用於了解功能應實作於何處、尋找既有程式碼，或理解各資料夾的用途
npx claudepluginhub peacepan/peace-agent-marketplaceThis skill uses the workspace's default tool permissions.
Maltese 是一套以 Next.js 14（Pages Router）、React 18、TypeScript、Apollo/GraphQL 及 MUI v5 建構的網頁版 POS（銷售時點）系統，支援零售 POS、美容 POS、電子發票、外送整合及離線模式。
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
Share bugs, ideas, or general feedback.
Maltese 是一套以 Next.js 14（Pages Router）、React 18、TypeScript、Apollo/GraphQL 及 MUI v5 建構的網頁版 POS（銷售時點）系統，支援零售 POS、美容 POS、電子發票、外送整合及離線模式。
| 路徑 | 用途 |
|---|---|
pages/ | Next.js 路由。正式環境中只有 .pub.tsx 檔案為公開路由。 |
pages/api/ | 伺服器端 API 路由（外部 API Proxy、版本端點、FoodPanda Webhook、PDF 產生） |
src/algorithm/ | 純促銷組合求解器，不含 React 與任何副作用 |
src/components/elements/ | 通用可複用 UI 原子元件（鍵盤、搜尋列、對話框等） |
src/components/mui/ | 依照專案慣例封裝的 MUI 元件 |
src/components/layouts/ | 整頁版面框架（bootUp、saleConsole、workbench、setting） |
src/components/tasks/pos/ | POS 功能對話框（30+ 個：優惠券、退款、換貨等） |
src/components/tasks/salonPos/ | 美容 POS 功能對話框 |
src/components/tasks/common/ | 共用對話框（銷售查詢、日報表、開收班結帳等） |
src/components/widgets/ | 領域複合元件（payForSale、itemList、subtotal、member） |
src/config/ | 集中式執行期、裝置、GraphQL、業務及列印設定 |
src/contexts/ | React Context = 跨元件狀態 + GQL 輸入輸出（posSale、posMember、item、uiCtrller 等） |
src/devices/creditCard/ | 信用卡終端機驅動程式（SKB、TSB） |
src/devices/invoice/ | 電子發票裝置整合 |
src/devices/offline/ | 離線 EGUI 編號同步 |
src/graphql/ | Apollo client、查詢／異動輔助函式、Schema 型別、請求簽章 |
src/hooks/ | 自訂 React Hooks（useScene、useMagentoAPI、useInvoiceDevice 等） |
src/libs/ | 框架工廠：myFuncCompFactory（StateDecorator 包裝器）、stashArrayFactory |
src/models/ | 對應後端資料庫資料表的 TypeScript 介面（header + lines 模式） |
src/server/ | 支援 SSL 的自訂 Next.js/Express 伺服器 |
src/styles/ | 全域 MUI 主題與 SCSS Mixin |
src/thirdParty/magento/ | Magento REST API 客戶端（MA 線上訂單） |
src/thirdParty/taishinPay/ | 台新 One Pay 信用卡處理器 |
src/thirdParty/edenred/ | Edenred 餐飲券支付整合 |
src/utils/general/ | 純粹輔助函式：格式化、日期／期間、正規化、列印、稅務、裝置 |
src/utils/contexts/ | Context 使用的業務邏輯輔助函式（結帳、促銷、退貨） |
src/utils/gql/ | GQL 篩選條件與 limit-set 建構器 |
src/utils/pdf/ | PDF 產生（pdfmake + pdf-lib） |
src/utils/tracking/ | GTM 事件追蹤與 Sentry 錯誤輔助 |
src/utils/mall-barcode/ | POS 商場條碼解析（購物中心跨店紅利點數） |
src/utils/sentry/ | Sentry 錯誤監控初始化 |
src/workers/sharedWorker/ | 跨分頁 SharedWorker，用於即時同步 |
src/workers/webWorker/ | Web Worker，用於大量促銷計算 |
tests/e2e/ | Puppeteer E2E 測試，子目錄：posMain、posETC、salon、workbench、common |
tests/unit/ | Jest 單元測試，目錄結構對應 src/ |
bin/ | 開發、建置、部署及測試 Shell 腳本 |
public/ | 靜態資源：圖片、通知音效、PWA Manifest |
docs/ | 專案文件（條碼規格、實作計畫） |
etc/ | Docker 設定、AWS CodeBuild 規格、離線 Excel 範本 |
新增 POS 功能對話框： src/components/tasks/pos/（新建資料夾 + index.tsx）
新增美容院對話框： src/components/tasks/salonPos/
新增 Workbench／POS 共用對話框： src/components/tasks/common/
新增頁面／路由： pages/，正式環境可見的頁面使用 .pub.tsx 副檔名
新增 Context（跨元件狀態）： src/contexts/，遵循 src/libs/ 中的 myFuncCompFactory 模式
新增後端資料模型： src/models/（header body 介面 + lines 介面 + 完整記錄型別）
新增 GQL 查詢或異動： src/graphql/query.ts 或 src/graphql/mutation.tsx
新增支付硬體驅動程式： src/devices/creditCard/（終端機驅動）、src/devices/invoice/（電子發票）、src/devices/offline/（離線同步）
新增第三方服務： src/thirdParty/
新增工具函式： src/utils/general/（純函式）或 src/utils/contexts/（與 Context 相關）
新增可複用 UI 原子元件： src/components/elements/
新增自訂 Hook： src/hooks/