概覽
🛒
今日交易筆數
-
❤️
今日捐款總額
-
📝
今日捐款筆數
-
👤
今日新會員
-
📊 歡迎使用 GoodStore POS 管理後台
請從左側選單選擇功能模組。所有數據皆即時從 Admin API 取得。
會員管理
👥
總會員數
-
🆕
今日新增
-
💰
總消費額
-
❤️
總捐款額
-
| 電話號碼 | 姓名 | 狀態 | 總消費 | 總捐款 | 最近購買 | 註冊日期 | 操作 |
|---|
會員詳情
交易記錄
📈 近30日交易趨勢
🏪 門市交易對比
| 交易 ID | 機台 | 商品 | 捐款 | 總計 | 時間 |
|---|
捐款記錄
❤️ 捐款金額分布
🏆 捐款排行榜 Top 10
| 會員 | 金額 | 門市 | 時間 | 課稅年度 |
|---|
年度收據
⚠️ 為避免 WhatsApp 封號，每次最多發送 20 份。如超過 20 人，請分多批發送，每批之間間隔至少 1 分鐘。
📤 發送進度
0%
0
待發送
0
已發送
0
失敗
報告訂閱者
新增訂閱者
| 電話號碼 | 姓名 | 訂閱門市 | 操作 |
|---|
R2 備份管理
手動執行備份
點擊「執行備份」將 D1 全部數據匯出為 JSON 並上傳至 R2。系統自動保留最近 4 個備份。
備份記錄
| 檔案名稱 | 大小 | 上傳時間 |
|---|
機器管理
| 機器 ID | 店鋪編號 | 店鋪名稱 | 狀態 | API Key | 註冊時間 | 操作 |
|---|
新增機器
📖 系統指南與測試
🎯 系統運作邏輯（簡要版）
1
頭部：會員認證
顧客在 Kiosk 輸入電話 → 掃描 QR Code → WhatsApp 發送驗證訊息 → 系統比對電話 → 認證成功
2
中部：購物與捐款
顧客進入 POS / E-Shop 購物 → 結賬前彈出「❤️ 齊捐支持好餸傳愛」（默認 $5，可更改/取消）→ 完成支付
3
尾部：收據與記錄
POS 推送 Webhook → Worker 分離商品/捐款記錄 → 自動發送 WhatsApp 電子收據 → 更新會員統計
核心原則
• 所有交易必須經過 WhatsApp 認證（無匿名交易）
• 捐款為自願性質，顧客可選擇 $0（不捐款）
• 同一
• 年度免稅收據每年 3 月由管理員手動觸發發送
• 所有交易必須經過 WhatsApp 認證（無匿名交易）
• 捐款為自願性質，顧客可選擇 $0（不捐款）
• 同一
pos_txn_ref 重複推送視為同一筆交易（冪等保護）• 年度免稅收據每年 3 月由管理員手動觸發發送
🧪 即時測試工具
點擊下方按鈕即可測試系統各環節是否正常運作。測試結果將直接顯示於此頁面。
🔍 系統健康檢查
檢查 Public Worker、Admin Worker 與 D1 連線狀態。
📱 會員驗證測試
模擬 Kiosk 輸入電話，生成 QR Code 與 Deeplink，並輪詢驗證狀態。
🛒 交易推送測試
模擬 POS 推送一筆含捐款 $5 的交易，測試 Webhook 與收據發送。
📋 常用資訊速查
| Public Worker | https://goodstore-public-worker.jimsbond007.workers.dev |
| Admin Worker | https://goodstore-admin-worker.jimsbond007.workers.dev |
| Dashboard | https://fe2a4ec5.goodstore-dashboard.pages.dev |
| Webhook Endpoint | POST /api/v1/transaction |
| 驗證 Endpoint | GET /api/verify-session |
| SaleSmartly Webhook | /api/webhook/salesmartly |
| 每日報告時間 | HKT 20:00 (UTC 12:00) |
| 年度收據觸發 | 每年 3 月，Dashboard 手動觸發 |