# POS Pro 商店工具：技能書與協作來源

在自己的裝置，練習小店收銀、庫存與報表。

## 工坊收錄說明

供貨與商店

小店店主、門市夥伴與零售工具開發者。

一份測試銷售、退款與庫存紀錄。

可在銷售或對帳公會討論門市流程；不會自動同步工坊商品或帳務。

先建測試商品，練習一筆銷售與退款，再核對庫存變化。

## 封面與來源署名

封面插畫：/art/skills/pos-pro.webp

原作者 GitHub：https://github.com/Hao0321/pos-pro

登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。

原作數據：/api/v1/github/books/pos-pro/metrics

Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。

## 讀者與格式

離線零售 POS

- 小型零售店主

- 門市營運人員

- 零售工具開發者

## 功能與使用範圍

收錄 v2.5.0，桌面 SQLite／瀏覽器 localStorage；Supabase 同步是選配，尚未自動連自由工坊商品與帳務。

- 收銀、退貨與庫存變動

- 會員、點數、儲值與進貨

- 複式記帳與營運報表

## 開始前準備

- 先用測試資料試用；首次登入修改預設員工密碼

- 自行啟動需 Node.js／npm；公開同步需另行檢查資料權限

## 第一個練習

1. 用三個虛構商品建立庫存，完成一筆測試銷售。

2. 再退回其中一項，檢查庫存、付款與報表是否一致。

3. 記下適合自己店裡的流程；連真資料或雲端同步前先完成帳號與權限設定。

## 練習成果

一份測試銷售與退款的操作紀錄，能說明庫存與帳務的對應。

## 原始專案的起步指令

在自己的專案副本根目錄執行；指令已對照收錄版本的說明，這次介紹核對沒有代為安裝或執行。

```sh
npm install
npm run dev
```

## 專案與授權

原作 Repo：https://github.com/Hao0321/pos-pro
從原作建立自己的版本：https://github.com/Hao0321/pos-pro/fork
工坊整合參考：https://github.com/FreeTWAI/pos-pro
記錄的授權：MIT

## 一起改這本技能書

提供去識別的門市流程案例，改善測試、收銀體驗或資料權限。

原作 Repo：https://github.com/Hao0321/pos-pro
預設 PR 目標：Hao0321/pos-pro:main
從原作建立自己的版本：https://github.com/Hao0321/pos-pro/fork
原作 PR：https://github.com/Hao0321/pos-pro/pulls

工坊整合參考：https://github.com/FreeTWAI/pos-pro
工坊整合任務專用 Fork：https://github.com/FreeTWAI/pos-pro/fork
工坊任務：https://github.com/FreeTWAI/pos-pro/issues
工坊 PR：https://github.com/FreeTWAI/pos-pro/pulls
GitHub Milestones：https://github.com/FreeTWAI/pos-pro/milestones

先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。

以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。

- 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。

### 補銷售到退款的庫存回歸 · 建議任務

在既有測試使用虛構門市商品和付款。

- 驗收：退貨後庫存和報表一致，不連真金流、不放顧客資料。

Agent Skill：/development/skills/pos-pro/SKILL.md
協作 JSON：/api/v1/skills/pos-pro/collaboration

## 參與開發

提供去識別的門市流程案例，改善測試、收銀體驗或資料權限。

工坊 Issue／PR 協調入口：https://github.com/FreeTWAI/pos-pro/issues

先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。

要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues

## 閱讀與來源

閱讀原始專案：https://github.com/Hao0321/pos-pro/blob/2656945463e95d155fffca19de18014f5f0d75db/README.md
核對日期：2026-09-23
核對版本：2656945463e95d155fffca19de18014f5f0d75db

- README.md：https://github.com/Hao0321/pos-pro/blob/2656945463e95d155fffca19de18014f5f0d75db/README.md

- package.json：https://github.com/Hao0321/pos-pro/blob/2656945463e95d155fffca19de18014f5f0d75db/package.json

## 共創原則

GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。

完整結構化目錄：/api/v1/development-map