# intelliPOS — 首版提案 mockup

原創門市工作台，沿用固定版本 agentic 的模組基礎與 Next / React 技術棧。這是商品與庫存的薄切片，不是完整 M1/M2 或正式 POS。

## 本機執行

Node 20+（驗證環境 Node 24.19.0），不需要帳號、環境變數、資料庫或金鑰。

```bash
npm ci --ignore-scripts
npm run build
npm start
# http://localhost:3000
```

開發：`npm run dev`。全部檢查：`npm run check`。預設瀏覽器測試使用 Playwright Chromium；本環境設定 `PLAYWRIGHT_CHROMIUM_EXECUTABLE=/usr/bin/chromium`，其他環境先執行 `npx playwright install chromium`。

## 可體驗

- `/` 原創工作台、同源數據統計、低庫存提醒與模組入口。
- `/products` 品號／名稱／IMEI 搜尋、分類／倉別／狀態篩選、清除與空結果。
- `/products/1` 各倉庫存、成本可見性、IMEI 篩選；`/products/4` 非序號配件。
- `/products/1/imei/990000010000001` 序號對應、倉別及狀態。
- `/products/new` 管理者可模擬新增、編輯、停用；必填、重複品號、數值檢查與取消。**不增加或扣減庫存**。
- `/policy` 四角色提案政策。管理者可維護／看成本；財務唯讀成本；櫃台無成本；查詢僅啟用商品與門市倉。
- 「示範狀態」可觸發錯誤並重試；角色切換清除前角色元件狀態；「重置模擬資料」回復種子資料。
- 銷售、進貨／調撥、維修、財務為誠實的規劃入口，沒有假成功交易。

只有合成資料。每個瀏覽器分頁在記憶體中操作；重新整理重設商品及角色。沒有 localStorage、伺服器資料或真實登入。網址／返回可用；重新整理新建的臨時商品網址會顯示不存在。

## 基底、政策與限制

[來源與授權](docs/PROVENANCE.md) · [架構與接線邊界](docs/ARCHITECTURE.md) · [驗證紀錄](docs/VALIDATION.md)

`core-baseline/` 保留 command/module foundations 的完整 local import closure（480 JS、488 upstream-derived files），含可安裝 package/lock 與 fail-closed config；不是整個 Hire8d 系統或可啟動後端。詳見 [基底說明](core-baseline/README.md)。正式認證、API 授權、資料庫、audit、訂閱及排程未啟用。角色切換只是 UI 模擬，合成成本仍在客戶端程式內。Tenant 為公司，store / warehouse 為下層實體。

可用量公式、權限矩陣、安全存量提醒、IMEI 展示欄位都需客戶確認。未連接原站、Hire8d、真金流、發票或任何外部 API。


未儲存商品草稿可跨 sidebar／Back 保留，明確取消／儲存清除；角色切換／reset 清除全部草稿。儲存成功提示會保留至關閉或角色／reset。列表篩選跨頁仍重置。

CI 位於 `.github/workflows/mockup.yml`，以 pinned 官方 actions、唯讀 contents 權限執行兩份 lockfile install、core closure 檢查、mock aggregate 與 Chromium browser flows；無 secrets、部署或 artifact upload。

目前 cloud environment 沒有已驗證的 private preview／port forwarding URL。上述 localhost 是自行在本機 clone/執行後使用，**不是從 Windows/web 直接連進 cloud 的網址**；可先在私有 PR 查看 artifacts/ 截圖。沒有新增 hosting 或 sharing。