概覽
🛒
今日交易筆數
-
❤️
今日捐款總額
-
📝
今日捐款筆數
-
👤
今日新會員
-
📊 歡迎使用 GoodStore POS 管理後台
請從左側選單選擇功能模組。所有數據皆即時從 Admin API 取得。
會員管理
| 電話號碼 | 姓名 | 註冊日期 |
|---|
交易記錄
| ID | 機台 | 金額 | 時間 |
|---|
捐款記錄
| 會員 | 金額 | 日期 | 年度 |
|---|
年度收據
報告訂閱者
新增訂閱者
| 電話號碼 | 姓名 | 操作 |
|---|
R2 備份管理
手動執行備份
點擊「執行備份」將 D1 全部數據匯出為 JSON 並上傳至 R2。系統自動保留最近 4 個備份。
備份記錄
| 檔案名稱 | 大小 | 上傳時間 |
|---|
📖 系統指南與測試
🎯 系統運作邏輯（簡要版）
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 手動觸發 |