maltese-knowledge-base

Maltese POS Dialog 系統完整知識庫。涵蓋 UICtrllerContext 架構、DialogContentName 型別定義、 dialogStack 生命週期（openDialog → closeDialog → clearDialog）， 以及 SaleConsole 四個子元件（item/Checkout、item/Management、salon/Checkout、salon/Management） 各自擁有的 Dialog 清單與 childProps 依賴分析。 以下情況必須參考此文件再動手： - 新增或修改 Maltese Dialog（包含 Task Dialog 與非 Task Dialog） - 修改 UICtrllerContext 的 dialogStack、openDialog、closeDialog、clearDialog 邏輯 - 需要知道某個 Dialog 屬於哪個 SaleConsole 子元件 - 需要判斷某個 Dialog 是否需要 childProps 才能開啟 - 修改 SaleConsole 的 tab 結構或 Dialog 觸發按鈕 - 實作與 Dialog 生命週期相關的 hook 或 side effect

在 Maltese POS 專案中工作時使用，用於了解功能應實作於何處、尋找既有程式碼，或理解各資料夾的用途

Maltese POS 專案 E2E 測試架構完整知識庫。涵蓋 Jest+Puppeteer 測試框架設定、4 個平行測試套件 （posMain / posETC / salon / workbench）的結構與執行順序、globalSetup 資料封存 HTTP server、 GraphQL 測試資料操作、共用 helpers（clickByText / selectMuiMenuItem / toast / scrollToBottom）、 Task-based 測試組織模式、Mock 資料結構，以及壓力測試架構。 以下情況必須參考此文件再動手： - 修改或新增 E2E 測試案例 - 修改測試基礎設施（globalSetup / globalTeardown / screenshotReporter） - 修改測試用 GraphQL helpers（insertUniAPI / archiveUniAPI / findBodyValueByLocators） - 修改共用 DOM helpers（clickByText / selectMuiMenuItem / getToastMessage / scrollToBottom） - 理解 4 個平行 browser 如何執行與隔離 - 理解 data archiver server 如何在 globalSetup 啟動、各 worker 如何註冊/清理資料 - 理解 Task function 如何組織為 Entry file 的執行順序 - 撰寫壓力測試或理解 cloneBrowser 機制 - 將 E2E 測試遷移至其他框架（如 Playwright）

Maltese POS 專案 `src/libs/` 函式庫完整知識庫。涵蓋 myFuncCompFactory（state/actions/view 三層分離的 Context Provider 工廠函式）、fcFactory（myFuncCompFactory 的型別延伸）、stashArrayFactory（操作 localStorage 的暫存陣列工具）、Warning 錯誤類別，以及底層 state-decorator 的整合細節。 以下情況必須參考此文件再動手： - 使用 myFuncCompFactory 建立新的 Context Provider - 修改現有 Context 的 state、actions、events、view 定義 - 需要了解 myFuncCompFactory 的 View Props 結構（state + actions 如何傳遞給 View） - 處理 abortableActions（可中斷的非同步行為）相關邏輯 - 修改 actionsImpl 中的非同步 action（getPromise / effects / sideEffects / errorSideEffects） - 需要了解 events 機制如何監聽 props/context 變化並更新 state 或觸發 action - 使用 stashArrayFactory 操作 localStorage 暫存資料 - 處理 state-decorator 的 clone 問題或 SSR useLayoutEffect 警告

用於回答 Maltese POS 系統終端使用者的操作問題，涵蓋一般商品結帳、美容商品結帳、美容工作臺三個入口的 UI 流程說明