Compare commits
6 Commits
ea460cf6d9
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
86b0cdb1e1 | ||
|
|
0a4872e6c9 | ||
|
|
c4978a389f | ||
|
|
c4807e23f2 | ||
|
|
fb7d0078c6 | ||
| 4bf4898e6a |
222
.agent/rules/api-rules.md
Normal file
222
.agent/rules/api-rules.md
Normal file
@@ -0,0 +1,222 @@
|
|||||||
|
---
|
||||||
|
trigger: always_on
|
||||||
|
---
|
||||||
|
|
||||||
|
# Backend API Specification (backend.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 目標範圍
|
||||||
|
|
||||||
|
* 使用 Laravel (RESTful API)
|
||||||
|
* 資料庫：MySQL（migration + seeder）
|
||||||
|
* 提供給現有 Android 團隊的完整 API 規格（JSON 格式）
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 認證與安全
|
||||||
|
|
||||||
|
* 採用 JWT 或 Laravel Sanctum
|
||||||
|
* 所有需要授權的 API 回傳 401/403 規範
|
||||||
|
* Error 格式：
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"success": false,
|
||||||
|
"code": 401,
|
||||||
|
"message": "Unauthorized",
|
||||||
|
"errors": null
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一般回應格式
|
||||||
|
|
||||||
|
成功：
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"success": true,
|
||||||
|
"code": 200,
|
||||||
|
"message": "OK",
|
||||||
|
"data": { }
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
錯誤：同上 Error 範例
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## API 清單（建議先開發順序）
|
||||||
|
|
||||||
|
1. Auth (登入/登出/註冊/權杖)
|
||||||
|
2. User / Profile
|
||||||
|
3. Device / Machine (機台管理、狀態回傳、日誌)
|
||||||
|
4. Order / ShoppingCart（若需）
|
||||||
|
5. Notification / Push 訊息
|
||||||
|
6. Activity / Campaign
|
||||||
|
7. Report / Analytics
|
||||||
|
8. Admin CRUD for resources
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 主要 Endpoints 範例
|
||||||
|
|
||||||
|
### 1) Auth
|
||||||
|
|
||||||
|
* POST /api/v1/auth/login
|
||||||
|
|
||||||
|
* request:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{"email":"user@example.com","password":"pa55"}
|
||||||
|
```
|
||||||
|
|
||||||
|
* response:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{"success":true,"code":200,"data":{"token":"...","user":{"id":1,"name":"..."}}}
|
||||||
|
```
|
||||||
|
|
||||||
|
* POST /api/v1/auth/logout
|
||||||
|
|
||||||
|
* header: Authorization: Bearer <token>
|
||||||
|
* response: 200
|
||||||
|
|
||||||
|
* POST /api/v1/auth/refresh
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2) User / Profile
|
||||||
|
|
||||||
|
* GET /api/v1/users/{id}
|
||||||
|
* PUT /api/v1/users/{id}
|
||||||
|
* GET /api/v1/users (admin)
|
||||||
|
|
||||||
|
Request / Response 均採 JSON，個資欄位請遵守最小授權原則。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 3) Machine (機台)
|
||||||
|
|
||||||
|
* GET /api/v1/machines
|
||||||
|
|
||||||
|
* Params: page, per_page, status
|
||||||
|
|
||||||
|
* GET /api/v1/machines/{id}
|
||||||
|
|
||||||
|
* POST /api/v1/machines
|
||||||
|
|
||||||
|
* PUT /api/v1/machines/{id}
|
||||||
|
|
||||||
|
* DELETE /api/v1/machines/{id}
|
||||||
|
|
||||||
|
* POST /api/v1/machines/{id}/status
|
||||||
|
|
||||||
|
* 用於下位機或 APP 回傳機台狀態
|
||||||
|
* request example:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"temperature": 23.4,
|
||||||
|
"status_code": "OK",
|
||||||
|
"firmware_version": "1.2.3",
|
||||||
|
"timestamp": "2025-11-20T15:00:00Z"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
* GET /api/v1/machines/{id}/logs
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 4) Orders / ShoppingCart
|
||||||
|
|
||||||
|
* POST /api/v1/cart/add
|
||||||
|
* GET /api/v1/cart
|
||||||
|
* POST /api/v1/orders
|
||||||
|
* GET /api/v1/orders/{id}
|
||||||
|
|
||||||
|
支付與第三方串接請另行設計 callback endpoint。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 5) Notification
|
||||||
|
|
||||||
|
* POST /api/v1/notifications/send (admin)
|
||||||
|
* GET /api/v1/notifications (user)
|
||||||
|
|
||||||
|
Payload for push could include: title, body, target_user_ids, data
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 6) Activity / Campaign
|
||||||
|
|
||||||
|
* GET /api/v1/campaigns
|
||||||
|
* POST /api/v1/campaigns
|
||||||
|
* PUT /api/v1/campaigns/{id}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 7) Report / Analytics
|
||||||
|
|
||||||
|
* GET /api/v1/reports/machines/summary?from=YYYY-MM-DD&to=YYYY-MM-DD
|
||||||
|
* GET /api/v1/reports/sales/summary
|
||||||
|
|
||||||
|
Response should include aggregated numbers and paginated lists when needed.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Database 基本表（初步）
|
||||||
|
|
||||||
|
* users
|
||||||
|
* roles
|
||||||
|
* machines
|
||||||
|
* machine_logs
|
||||||
|
* orders
|
||||||
|
* order_items
|
||||||
|
* carts
|
||||||
|
* notifications
|
||||||
|
* campaigns
|
||||||
|
* activity_logs
|
||||||
|
* translations (i18n)
|
||||||
|
|
||||||
|
（每張表建議 migration 欄位、index、外鍵，請於開發前定稿）
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## API 規格輸出
|
||||||
|
|
||||||
|
* 建議產出 Swagger (OpenAPI 3.0) 與 Postman Collection
|
||||||
|
* 每個 endpoint 必要欄位、範例、error code、rate limit
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 測試建議
|
||||||
|
|
||||||
|
* Unit tests：Laravel Feature tests for API
|
||||||
|
* Contract tests：與 Android 團隊一同建立 contract tests（或使用 Postman tests）
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 部署與運營
|
||||||
|
|
||||||
|
* 建議使用 queue 與 cache（Redis）處理非同步任務
|
||||||
|
* Logging: Sentry or similar
|
||||||
|
* 定期備份 MySQL
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 交付項目清單
|
||||||
|
|
||||||
|
1. 完整 Laravel 專案（註冊、登入、ACL）
|
||||||
|
2. MySQL migration + seeders
|
||||||
|
3. Swagger/OpenAPI 文件
|
||||||
|
4. Postman Collection
|
||||||
|
5. 後台管理系統（Star Cloud）
|
||||||
|
6. 測試報告
|
||||||
|
7. 部署腳本與上線說明
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*註：本檔為初版 backend.md，若要我把 Excel 的每一列功能自動轉成對應的 API endpoint（含 request/response 範例），我可以直接在此檔案中展開更詳細的 endpoint 清單。*
|
||||||
528
.agent/rules/backend-rules.md
Normal file
528
.agent/rules/backend-rules.md
Normal file
@@ -0,0 +1,528 @@
|
|||||||
|
---
|
||||||
|
trigger: always_on
|
||||||
|
---
|
||||||
|
|
||||||
|
STAR CLOUD 後台管理系統 - 智能販賣機管理平台
|
||||||
|
|
||||||
|
一、儀錶板模組 (Dashboard)
|
||||||
|
1.1 主頁面
|
||||||
|
|
||||||
|
功能描述: 系統總覽與關鍵數據展示
|
||||||
|
主要內容:
|
||||||
|
|
||||||
|
即時銷售數據
|
||||||
|
機台運行狀態
|
||||||
|
庫存警示
|
||||||
|
營收統計圖表
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
二、應用程式管理 (Application Management)
|
||||||
|
2.1 個人檔案
|
||||||
|
|
||||||
|
功能描述: 使用者個人資訊管理
|
||||||
|
包含功能:
|
||||||
|
|
||||||
|
基本資料編輯
|
||||||
|
密碼修改
|
||||||
|
通知設定
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
三、機台管理模組 (Machine Management)
|
||||||
|
3.1 機台日誌
|
||||||
|
|
||||||
|
功能描述: 機台操作歷史紀錄回溯
|
||||||
|
資料內容:
|
||||||
|
|
||||||
|
操作時間戳記
|
||||||
|
事件類型
|
||||||
|
操作人員
|
||||||
|
詳細描述
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
3.2 機台列表
|
||||||
|
|
||||||
|
功能描述: 所有機台資訊總覽
|
||||||
|
顯示資訊:
|
||||||
|
|
||||||
|
溫度監控
|
||||||
|
下位機狀態
|
||||||
|
刷卡機連線
|
||||||
|
掃碼機狀態
|
||||||
|
機台回傳訊息
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
3.3 機台權限
|
||||||
|
|
||||||
|
功能描述: 機台存取權限控管
|
||||||
|
設定項目:
|
||||||
|
|
||||||
|
人員權限分配
|
||||||
|
操作級別設定
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
3.4 機台稼動率
|
||||||
|
|
||||||
|
功能描述: 機台運行效率分析
|
||||||
|
統計數據:
|
||||||
|
|
||||||
|
運行時間
|
||||||
|
停機時間
|
||||||
|
稼動率百分比
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
3.5 效期管理
|
||||||
|
|
||||||
|
功能描述: 商品效期與貨道出貨控制
|
||||||
|
管理項目:
|
||||||
|
|
||||||
|
設定貨道是否可出貨
|
||||||
|
效期到期提醒
|
||||||
|
商品下架設定
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
3.6 維修管理單
|
||||||
|
|
||||||
|
功能描述: 機台維修工單系統
|
||||||
|
包含功能:
|
||||||
|
|
||||||
|
報修單建立
|
||||||
|
維修進度追蹤
|
||||||
|
維修歷史紀錄
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
3.7 機台管理擴充欄位
|
||||||
|
|
||||||
|
新增欄位:
|
||||||
|
|
||||||
|
保固區間
|
||||||
|
交機日期
|
||||||
|
租賃區間
|
||||||
|
保內/保外狀態顯示
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
3.8 機台設定參數
|
||||||
|
|
||||||
|
刷卡機秒數: 刷卡逾時設定
|
||||||
|
卡機結帳時間: 結帳流程時間限制
|
||||||
|
卡機結帳時間2: 備用結帳時間設定
|
||||||
|
金流緩衝時間: 金流處理緩衝時間
|
||||||
|
刷卡機編號: 刷卡機裝置識別
|
||||||
|
發票狀態碼: 發票開立狀態管理
|
||||||
|
|
||||||
|
3.9 APP到期提醒
|
||||||
|
|
||||||
|
功能描述: APP授權到期通知系統
|
||||||
|
|
||||||
|
|
||||||
|
四、APP管理模組 (APP Management)
|
||||||
|
4.1 UI元素設定
|
||||||
|
|
||||||
|
功能描述: APP版面配置設定
|
||||||
|
注意事項: 與新版差異較大，需特別處理
|
||||||
|
|
||||||
|
4.2 小幫手設定
|
||||||
|
|
||||||
|
功能描述: APP內建輔助功能設定
|
||||||
|
|
||||||
|
4.3 問卷設定
|
||||||
|
|
||||||
|
功能描述: 互動問卷建立與管理
|
||||||
|
|
||||||
|
4.4 互動遊戲設定
|
||||||
|
|
||||||
|
功能描述: APP互動遊戲配置
|
||||||
|
|
||||||
|
4.5 計時器
|
||||||
|
|
||||||
|
功能描述: 時間相關功能設定
|
||||||
|
|
||||||
|
|
||||||
|
五、倉庫管理模組 (Warehouse Management)
|
||||||
|
5.1 倉庫列表
|
||||||
|
|
||||||
|
5.1.1 倉庫列表(全部): 顯示所有倉庫
|
||||||
|
5.1.2 倉庫列表(個人): 顯示個人負責倉庫
|
||||||
|
|
||||||
|
5.2 庫存管理單
|
||||||
|
|
||||||
|
功能描述: 倉庫庫存異動管理
|
||||||
|
|
||||||
|
5.3 調撥單
|
||||||
|
|
||||||
|
功能描述: 倉庫間商品調撥作業
|
||||||
|
|
||||||
|
5.4 採購單
|
||||||
|
|
||||||
|
功能描述: 商品採購申請與管理
|
||||||
|
|
||||||
|
5.5 機台補貨管理
|
||||||
|
|
||||||
|
5.5.1 機台補貨單: 補貨工單建立
|
||||||
|
5.5.2 機台補貨紀錄: 個別補貨歷史
|
||||||
|
5.5.3 機台補貨紀錄(總): 所有補貨總覽
|
||||||
|
|
||||||
|
5.6 庫存查詢
|
||||||
|
|
||||||
|
5.6.1 機台庫存: 各機台即時庫存
|
||||||
|
5.6.2 人員庫存: 人員持有庫存
|
||||||
|
|
||||||
|
5.7 回庫單
|
||||||
|
|
||||||
|
功能描述: 商品退回倉庫管理
|
||||||
|
|
||||||
|
|
||||||
|
六、銷售管理模組 (Sales Management)
|
||||||
|
6.1 銷售&金流紀錄
|
||||||
|
|
||||||
|
功能描述: 銷售交易與金流明細
|
||||||
|
包含項目:
|
||||||
|
|
||||||
|
現金出貨 API
|
||||||
|
發票系統整合
|
||||||
|
各種出貨方式整理
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
6.2 取貨碼設定
|
||||||
|
|
||||||
|
功能描述: 取貨驗證碼管理
|
||||||
|
|
||||||
|
6.3 購買單
|
||||||
|
|
||||||
|
功能描述: 購買訂單管理
|
||||||
|
|
||||||
|
6.4 促銷時段設定
|
||||||
|
|
||||||
|
功能描述: 促銷活動時間設定
|
||||||
|
重要功能: (W) 重啟掃描商品 API
|
||||||
|
|
||||||
|
6.5 通行碼設定
|
||||||
|
|
||||||
|
功能描述: 特殊通行碼權限管理
|
||||||
|
|
||||||
|
6.6 來店禮設定
|
||||||
|
|
||||||
|
功能描述: 來店優惠活動設定
|
||||||
|
包含: 來店禮開關控制
|
||||||
|
|
||||||
|
|
||||||
|
七、分析管理模組 (Analysis Management)
|
||||||
|
7.1 零錢庫存分析
|
||||||
|
|
||||||
|
功能描述: 機台零錢數量監測與分析
|
||||||
|
|
||||||
|
7.2 機台報表分析
|
||||||
|
|
||||||
|
功能描述: 機台運營數據分析報表
|
||||||
|
|
||||||
|
7.3 商品報表分析
|
||||||
|
|
||||||
|
功能描述: 商品銷售數據分析
|
||||||
|
|
||||||
|
7.4 互動問卷分析
|
||||||
|
|
||||||
|
功能描述: 問卷結果統計與分析
|
||||||
|
|
||||||
|
|
||||||
|
八、稽核管理模組 (Audit Management)
|
||||||
|
8.1 採購單稽核
|
||||||
|
|
||||||
|
功能描述: 採購單審核流程
|
||||||
|
|
||||||
|
8.2 調撥單稽核
|
||||||
|
|
||||||
|
功能描述: 調撥單審核流程
|
||||||
|
|
||||||
|
8.3 補貨單稽核
|
||||||
|
|
||||||
|
功能描述: 補貨單審核流程
|
||||||
|
|
||||||
|
|
||||||
|
九、資料設定模組 (Data Configuration)
|
||||||
|
9.1 機台管理
|
||||||
|
|
||||||
|
功能描述: 機台基本資料設定
|
||||||
|
|
||||||
|
9.2 商品管理
|
||||||
|
|
||||||
|
功能描述: 商品資料維護
|
||||||
|
|
||||||
|
9.3 廣告管理
|
||||||
|
|
||||||
|
功能描述: 機台廣告影片管理
|
||||||
|
用途: 機台可讀取後台廣告影片
|
||||||
|
|
||||||
|
9.4 管理者可賣商品
|
||||||
|
|
||||||
|
功能描述: 管理者商品銷售權限
|
||||||
|
|
||||||
|
9.5 帳號管理
|
||||||
|
|
||||||
|
功能描述: 主帳號管理
|
||||||
|
|
||||||
|
9.6 子帳號管理
|
||||||
|
|
||||||
|
功能描述: 子帳號建立與管理
|
||||||
|
|
||||||
|
9.7 子帳號角色管理
|
||||||
|
|
||||||
|
功能描述: 子帳號權限角色設定
|
||||||
|
|
||||||
|
9.8 點數設定
|
||||||
|
|
||||||
|
功能描述: 客戶點數系統設定
|
||||||
|
特殊功能: 支援客戶自行新增點數
|
||||||
|
|
||||||
|
9.9 識別證管理
|
||||||
|
|
||||||
|
功能描述: 識別證資料管理
|
||||||
|
用途: 安霸系統使用
|
||||||
|
|
||||||
|
|
||||||
|
十、遠端管理模組 (Remote Management)
|
||||||
|
10.1 機台庫存
|
||||||
|
|
||||||
|
功能描述: 遠端修改機台庫存
|
||||||
|
|
||||||
|
10.2 機台重啟
|
||||||
|
|
||||||
|
功能描述: 遠端重啟機台系統
|
||||||
|
|
||||||
|
10.3 卡機重啟
|
||||||
|
|
||||||
|
功能描述: 遠端重啟刷卡機
|
||||||
|
|
||||||
|
10.4 遠端結帳
|
||||||
|
|
||||||
|
功能描述: 遠端執行結帳流程
|
||||||
|
|
||||||
|
10.5 遠端鎖定頁
|
||||||
|
|
||||||
|
功能描述: 遠端鎖定機台頁面
|
||||||
|
|
||||||
|
10.6 遠端找零
|
||||||
|
|
||||||
|
功能描述: 遠端執行找零功能
|
||||||
|
|
||||||
|
10.7 遠端出貨
|
||||||
|
|
||||||
|
功能描述: 遠端控制商品出貨
|
||||||
|
|
||||||
|
|
||||||
|
十一、Line管理模組 (Line Integration)
|
||||||
|
11.1 Line會員管理
|
||||||
|
|
||||||
|
功能描述: Line會員資料管理
|
||||||
|
|
||||||
|
11.2 Line機台管理
|
||||||
|
|
||||||
|
功能描述: Line綁定機台管理
|
||||||
|
|
||||||
|
11.3 Line商品管理
|
||||||
|
|
||||||
|
功能描述: Line商城商品設定
|
||||||
|
|
||||||
|
11.4 Line生活圈
|
||||||
|
|
||||||
|
功能描述: Line官方帳號整合
|
||||||
|
|
||||||
|
11.5 Line商城訂單
|
||||||
|
|
||||||
|
功能描述: Line商城訂單管理
|
||||||
|
|
||||||
|
11.6 Line優惠券
|
||||||
|
|
||||||
|
功能描述: Line優惠券發放與管理
|
||||||
|
|
||||||
|
|
||||||
|
十二、預約系統模組 (Reservation System)
|
||||||
|
12.1 Line會員管理
|
||||||
|
|
||||||
|
功能描述: 預約系統會員管理
|
||||||
|
|
||||||
|
12.2 Line店家管理
|
||||||
|
|
||||||
|
功能描述: 店家資訊設定
|
||||||
|
|
||||||
|
12.3 Line時段組合
|
||||||
|
|
||||||
|
功能描述: 預約時段設定
|
||||||
|
|
||||||
|
12.4 Line場地管理
|
||||||
|
|
||||||
|
功能描述: 場地資源管理
|
||||||
|
|
||||||
|
12.5 Line優惠券管理
|
||||||
|
|
||||||
|
功能描述: 預約優惠券管理
|
||||||
|
|
||||||
|
12.6 Line預約管理
|
||||||
|
|
||||||
|
功能描述: 預約單管理
|
||||||
|
|
||||||
|
12.7 Line訂單管理
|
||||||
|
|
||||||
|
功能描述: 預約訂單處理
|
||||||
|
|
||||||
|
|
||||||
|
十三、特殊權限管理模組 (Special Permissions)
|
||||||
|
13.1 庫存清空
|
||||||
|
|
||||||
|
功能描述: 特殊權限庫存清空功能
|
||||||
|
|
||||||
|
13.2 APK版本管理
|
||||||
|
|
||||||
|
功能描述: APP版本控制與更新
|
||||||
|
|
||||||
|
13.3 Discord通知設定
|
||||||
|
|
||||||
|
功能描述: Discord通知整合設定
|
||||||
|
|
||||||
|
|
||||||
|
十四、權限設定模組 (Permission Management)
|
||||||
|
14.1 功能權限設定
|
||||||
|
|
||||||
|
14.1.1 APP功能管理: APP功能權限
|
||||||
|
14.1.2 資料設定: 資料設定權限
|
||||||
|
14.1.3 銷售管理: 銷售管理權限
|
||||||
|
14.1.4 機台管理: 機台管理權限
|
||||||
|
14.1.5 倉庫管理: 倉庫管理權限
|
||||||
|
14.1.6 分析管理: 分析管理權限
|
||||||
|
14.1.7 稽核管理: 稽核管理權限
|
||||||
|
14.1.8 遠端管理: 遠端管理權限
|
||||||
|
14.1.9 Line管理: Line管理權限
|
||||||
|
|
||||||
|
14.2 權限角色設定
|
||||||
|
|
||||||
|
功能描述: 角色權限組合設定
|
||||||
|
|
||||||
|
14.3 其他功能管理
|
||||||
|
|
||||||
|
功能描述: 其他特殊功能權限
|
||||||
|
|
||||||
|
14.4 AI智能預測
|
||||||
|
|
||||||
|
功能描述: AI功能權限設定
|
||||||
|
|
||||||
|
|
||||||
|
資料庫設計建議
|
||||||
|
主要資料表規劃
|
||||||
|
machines # 機台資料表
|
||||||
|
├── warehouses # 倉庫資料表
|
||||||
|
├── products # 商品資料表
|
||||||
|
├── machine_stocks # 機台庫存表
|
||||||
|
├── warehouse_stocks # 倉庫庫存表
|
||||||
|
├── sales_records # 銷售紀錄表
|
||||||
|
├── purchase_orders # 採購單表
|
||||||
|
├── transfer_orders # 調撥單表
|
||||||
|
├── replenishment_orders # 補貨單表
|
||||||
|
├── maintenance_orders # 維修單表
|
||||||
|
├── machine_logs # 機台日誌表
|
||||||
|
├── users # 使用者表
|
||||||
|
├── roles # 角色表
|
||||||
|
├── permissions # 權限表
|
||||||
|
├── line_members # Line會員表
|
||||||
|
├── reservations # 預約表
|
||||||
|
└── advertisements # 廣告表
|
||||||
|
|
||||||
|
API 端點規劃
|
||||||
|
機台管理 API
|
||||||
|
|
||||||
|
GET /api/machines - 取得機台列表
|
||||||
|
POST /api/machines - 新增機台
|
||||||
|
PUT /api/machines/{id} - 更新機台
|
||||||
|
DELETE /api/machines/{id} - 刪除機台
|
||||||
|
GET /api/machines/{id}/logs - 取得機台日誌
|
||||||
|
POST /api/machines/{id}/restart - 遠端重啟
|
||||||
|
|
||||||
|
倉庫管理 API
|
||||||
|
|
||||||
|
GET /api/warehouses - 取得倉庫列表
|
||||||
|
GET /api/warehouses/{id}/stocks - 取得倉庫庫存
|
||||||
|
POST /api/transfer-orders - 建立調撥單
|
||||||
|
POST /api/purchase-orders - 建立採購單
|
||||||
|
POST /api/replenishment-orders - 建立補貨單
|
||||||
|
|
||||||
|
銷售管理 API
|
||||||
|
|
||||||
|
GET /api/sales - 取得銷售紀錄
|
||||||
|
POST /api/sales/cash - 現金出貨
|
||||||
|
GET /api/sales/invoice - 發票查詢
|
||||||
|
POST /api/pickup-codes - 建立取貨碼
|
||||||
|
|
||||||
|
遠端控制 API
|
||||||
|
|
||||||
|
POST /api/remote/checkout - 遠端結帳
|
||||||
|
POST /api/remote/dispense - 遠端出貨
|
||||||
|
POST /api/remote/change - 遠端找零
|
||||||
|
POST /api/remote/lock - 遠端鎖定
|
||||||
|
|
||||||
|
|
||||||
|
技術架構建議
|
||||||
|
後端技術
|
||||||
|
|
||||||
|
框架: Laravel 10+
|
||||||
|
資料庫: MySQL 8.0+
|
||||||
|
快取: Redis
|
||||||
|
佇列: Laravel Queue (Redis Driver)
|
||||||
|
API文件: Swagger/OpenAPI
|
||||||
|
|
||||||
|
前端技術
|
||||||
|
|
||||||
|
模板引擎: Blade
|
||||||
|
CSS框架: Tailwind CSS
|
||||||
|
JavaScript: Alpine.js / Vue.js
|
||||||
|
圖表庫: Chart.js / ApexCharts
|
||||||
|
|
||||||
|
第三方整合
|
||||||
|
|
||||||
|
Line API: Line Messaging API
|
||||||
|
Discord: Discord Webhook
|
||||||
|
金流: 藍新、綠界等
|
||||||
|
發票: 電子發票整合
|
||||||
|
|
||||||
|
|
||||||
|
開發優先順序建議
|
||||||
|
Phase 1 - 核心功能 (1-2個月)
|
||||||
|
|
||||||
|
使用者認證與權限系統
|
||||||
|
機台管理基本功能
|
||||||
|
倉庫管理基本功能
|
||||||
|
銷售紀錄查詢
|
||||||
|
|
||||||
|
Phase 2 - 進階功能 (2-3個月)
|
||||||
|
|
||||||
|
遠端控制功能
|
||||||
|
報表分析功能
|
||||||
|
稽核流程
|
||||||
|
APP管理功能
|
||||||
|
|
||||||
|
Phase 3 - 整合功能 (1-2個月)
|
||||||
|
|
||||||
|
Line整合
|
||||||
|
預約系統
|
||||||
|
AI智能預測
|
||||||
|
Discord通知
|
||||||
|
|
||||||
|
|
||||||
|
注意事項
|
||||||
|
|
||||||
|
安全性: 所有遠端控制功能需要雙重驗證
|
||||||
|
權限控管: 嚴格的角色權限分離
|
||||||
|
日誌記錄: 所有重要操作需記錄日誌
|
||||||
|
API限流: 防止API濫用
|
||||||
|
資料備份: 定期自動備份機制
|
||||||
|
錯誤處理: 完善的異常處理機制
|
||||||
|
測試: 重要功能需撰寫測試案例
|
||||||
|
RetryClaude can make mistakes. Please double-check responses.
|
||||||
@@ -1,83 +0,0 @@
|
|||||||
---
|
|
||||||
trigger: always_on
|
|
||||||
---
|
|
||||||
|
|
||||||
# Backend API Specification (api-rules.md)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 1. 目標範圍與分類
|
|
||||||
|
|
||||||
本系統 API 分為兩大類，遵循不同的設計慣例：
|
|
||||||
|
|
||||||
* **Admin/Web API (`/api/v1/...`)**: 供後台管理介面、APP UI 使用。遵循標準 RESTful 與 JSON 結構。
|
|
||||||
* **Machine IoT API (`/api/app/...`)**: 供販賣機、計時器等硬體端點使用。需相容既有 PDF 規格（如 B010, B600），欄位命名多為 `req1`, `req2` 或特定縮寫。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔐 2. 認證與安全性
|
|
||||||
|
|
||||||
* **Admin API**: 採用 **Laravel Sanctum (Session/Token)** 認證。
|
|
||||||
* **Machine IoT API**:
|
|
||||||
* **核心機制**: 必須在 Header 帶入 `Authorization: Bearer <api_token>` 進行身份驗證。
|
|
||||||
* **Phase 1 (兼容模式)**: 若為相容既有機動硬體，可暫時接受 Request 包含 `key` 欄位，但後端應過渡至 Bearer 驗證。
|
|
||||||
* **安全性強化**: 改用每台機台專屬的 `api_token` (透過 B010 初始化或派發)，並配合 `serial_no` (即 `workid`) 進行資料歸屬權驗證。
|
|
||||||
* **傳輸安全**: 必須強制使用 **HTTPS**。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📦 3. 回應格式規範
|
|
||||||
|
|
||||||
### 3.1 標準回應 (Admin/Web API)
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"success": true,
|
|
||||||
"code": 200,
|
|
||||||
"message": "OK",
|
|
||||||
"data": { ... }
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 3.2 IoT 指令回應 (B010/B055 等)
|
|
||||||
機台端通常透過 response 的 `status` 欄位或特定的 `message` 字串來執行動作：
|
|
||||||
* **成功但有指令**: `{"status": "49", "message": "reload B017"}`
|
|
||||||
* **純資料回傳**: 直接返回對象陣列或 PDF 定義的欄位。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🛠️ 4. 主要 Endpoints 與命名慣例
|
|
||||||
|
|
||||||
### 4.1 管理類 (Admin UI)
|
|
||||||
* `GET /api/v1/users`: 管理員清單
|
|
||||||
* `GET /api/v1/machines`: 機台清單
|
|
||||||
* `PUT /api/v1/machines/{id}`: 更新機台參數
|
|
||||||
* 遵循 **kebab-case** 路由與 **snake_case** JSON 欄位。
|
|
||||||
|
|
||||||
### 4.2 終端類 (IoT / Machine) — 須嚴格遵守 PDF 規格
|
|
||||||
* **API 識別碼 (workid)**: URL 中的 `{workid}` 參數固定為該 API 的功能代碼 (如 `B010`, `B017`, `B600`)，不隨機台改變。
|
|
||||||
* **機台識別方式**:
|
|
||||||
1. **Header**: 透過 `Authorization: Bearer <api_token>` 識別。
|
|
||||||
2. **Request Body**: 透過 `machine` 或 `serial_no` 等欄位識別具體機台。
|
|
||||||
* **主要 Endpoint 範例**:
|
|
||||||
* **心跳上報 (B010)**: `POST /api/app/machine/status/B010`
|
|
||||||
* **交易回傳 (B600)**: `POST /api/app/B600` (Body 欄位 `req2` 為機台編號)
|
|
||||||
* **貨道庫存 (B017)**: `POST /api/app/machine/reload_msg/B017`
|
|
||||||
* **遠端出貨 (B055)**: `POST /api/app/machine/dispense/B055`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ⚡ 5. 高併發處理與隊列
|
|
||||||
|
|
||||||
為了系統穩定性，以下 API **嚴禁直寫資料庫**，必須進入 **Redis Queue** 異步處理：
|
|
||||||
1. **B010**: 心跳上傳（每 5-10 秒一次）。
|
|
||||||
2. **B600 / B602**: 交易與出貨紀錄。
|
|
||||||
3. **B220**: 零錢機庫存變動。
|
|
||||||
4. **B710**: 計時器狀態同步。
|
|
||||||
|
|
||||||
後端應立即回傳 `202 Accepted` 或業務定義的成功碼，由 Job 背景完成數據持久化。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📄 6. 交付與文件
|
|
||||||
* **OpenAPI**: 應區分 `admin.yaml` 與 `iot.yaml`。
|
|
||||||
* **Postman**: 提供帶有環境變數（機台金鑰、Base URL）的 Collection。
|
|
||||||
@@ -1,95 +0,0 @@
|
|||||||
---
|
|
||||||
trigger: always_on
|
|
||||||
---
|
|
||||||
|
|
||||||
# 開發框架規範說明書：Cloud 後台管理系統 (star-cloud)
|
|
||||||
|
|
||||||
## 1. 專案概述
|
|
||||||
* **目標**：打造一個強大且穩定的智能販賣機後台管理系統（Cloud 平台），負責管理機台、商品、銷售數據以及提供給端點機台串接的 API。
|
|
||||||
* **核心架構**：採用 **傳統單體式架構 (Monolithic Architecture)** 配 Laravel Blade 模板引擎進行伺服器端渲染 (SSR)。
|
|
||||||
* **工作流程**：後端處理業務邏輯與資料庫存取，並透過 Blade 引擎渲染包含 Tailwind CSS 類別的 HTML。前端互動行為由輕量級 Alpine.js 負責，UI 元件以 Preline UI 為主體。
|
|
||||||
|
|
||||||
## 2. 技術棧 (Tech Stack)
|
|
||||||
* **後端框架**：PHP 8.5 / Laravel 12
|
|
||||||
* **核心組件**：Redis (用於高併發 IoT 隊列與快取，為系統穩定之必要條件)
|
|
||||||
* **前端視圖 (View)**：Laravel Blade
|
|
||||||
* **前端互動 (JS)**：Alpine.js (專注於行為，不負責渲染)
|
|
||||||
* **介面與樣式 (CSS)**：Tailwind CSS + Preline UI (直接寫作於 Blade 模板中)
|
|
||||||
* **前端建置工具**：Vite
|
|
||||||
* **資料庫**：MySQL 8.0
|
|
||||||
* **開發環境**：Laravel Sail (Docker / WSL2)
|
|
||||||
|
|
||||||
## 3. 目錄結構與慣例
|
|
||||||
|
|
||||||
### 3.1 後端 (Laravel)
|
|
||||||
與標準 Laravel 結構保持一致，無過度拆分的模組化（與 ERP 的 Modular Monolith 區別）：
|
|
||||||
* **Controllers**：`app/Http/Controllers/`，負責接收請求並回傳 `view()` 或 JSON。
|
|
||||||
* **Models**：`app/Models/{Domain}/`，按領域分群 (例如 `Machine`, `Member`, `System`)。
|
|
||||||
* **Routes**：`routes/web.php` 用於後台管理介面；`routes/api.php` 提供外部或機台調用介面 (需 V1 版本化)。
|
|
||||||
* **Services** (建議)：`app/Services/{Domain}/`，將商業邏輯與資料異動封裝於 Service 中。
|
|
||||||
* **Traits**：`app/Traits/ApiResponse.php` 用於統一 API JSON 回傳格式。
|
|
||||||
* **Jobs**：`app/Jobs/{Domain}/`，**高併發 IoT 場景之必要實作**。所有日誌、心跳上報必須進入 Redis Queue 進行背景異步處理，嚴禁在 API 直連 DB 寫入日誌。
|
|
||||||
|
|
||||||
### 3.2 前端 (Blade / Tailwind / Alpine)
|
|
||||||
* **Views (頁面)**：位於 `resources/views/`。通常依功能建立資料夾（如 `resources/views/admin/machines/index.blade.php`）。
|
|
||||||
* **Layouts (版面)**：位於 `resources/views/layouts/`。定義全站的共用版面結構（如 header, sidebar, footer）。
|
|
||||||
* **Components (組件)**：位於 `resources/views/components/`。封裝可重用的 Blade 元件（如 Button, Modal, Table），支援透過 `<x-button>` 語法呼叫。
|
|
||||||
|
|
||||||
## 4. 開發標準 (Coding Standards)
|
|
||||||
* **命名規範**：
|
|
||||||
* Controllers: `PascalCaseController.php` (例如 `MachineController.php`)
|
|
||||||
* Models: `PascalCase.php` (例如 `Machine.php`)
|
|
||||||
* Blade Views: `kebab-case.blade.php` 或按資源名稱 (例如 `index.blade.php`, `create.blade.php`)
|
|
||||||
* Routes uri: `kebab-case` (例如 `/machine-logs`)
|
|
||||||
* **回傳格式**：
|
|
||||||
* Web 路由：回傳 `view()`，表單驗證失敗時直接使用 Laravel 內建的 redirect with errors。
|
|
||||||
* API 路由：回傳標準 JSON 格式的 `JsonResponse`。
|
|
||||||
|
|
||||||
## 5. UI 與前端開發指南
|
|
||||||
* **樣式撰寫**：全面使用 Tailwind CSS utility classes，**避免撰寫自訂 CSS**（除非少數特定動畫或覆寫）。
|
|
||||||
* **UI 元件庫**：遵循 **Preline UI** 的類別與 HTML 結構進行開發。
|
|
||||||
* **前端腳本**：
|
|
||||||
* 優先使用 **Alpine.js** (`x-data`, `x-show`, `@click` 等) 在 HTML 標籤內完成簡單的 DOM 狀態切換與互動邏輯。
|
|
||||||
* 避免在 Blade 內撰寫冗長的 `<script>` Vanilla JS；若邏輯過於複雜，可將 Alpine state 獨立成 js 檔案再於 Vite 引入，但原則上保持輕量。
|
|
||||||
|
|
||||||
## 6. 多語系 I18n 規範 (Multi-language Standards)
|
|
||||||
* **視圖開發**：所有使用者可見的文字、按鈕、提示訊息，必須使用 Laravel 的 `@lang('key')` 或 `__('key')` 函式包裹。
|
|
||||||
* **語系 Key 命名**：語系 Key 必須採用 **英文原始詞彙 (English phrases)** 作為 Key 名稱為原則，以提高代碼可讀性並作為預設回退（除非該字串過長，才建議使用點號分隔的 key）。
|
|
||||||
* 範例：使用 `__('Account Settings')`。
|
|
||||||
* **翻譯檔維護**：
|
|
||||||
* 主語系檔案位於 `lang/` 目錄。
|
|
||||||
* 開發新功能時，必須同步更新以下三個 JSON 翻譯檔：`zh_TW.json` (主要)、`en.json` (預設)、`ja.json` (日文)。
|
|
||||||
|
|
||||||
## 7. AI 協作規則 (給 Antigravity AI)
|
|
||||||
* **角色設定**：你是一位專業的全端開發工程師助手。
|
|
||||||
* **代碼生成指令**：
|
|
||||||
* 所有的解釋說明請使用 **繁體中文**。
|
|
||||||
* **【警告】** 此專案前端禁用 React / Vue / Inertia.js。所有的前端頁面生成必須使用 **Blade 模板** 結合 **Tailwind CSS** 與 **Alpine.js**。
|
|
||||||
* **【多語系強制要求】** 任何新增的 Blade UI 區塊，禁止硬編碼 (Hard-coded) 中文或英文。必須使用 `__('...')` 並同步在 `lang/*.json` 補上翻譯。
|
|
||||||
* 生成 UI 區塊時，必須優先參考與產生 **Preline UI** 風格與結構的標記語法。
|
|
||||||
* 開發新功能時，請建立標準的 Controller 搭配對應的 `resources/views/.../` 目錄。
|
|
||||||
|
|
||||||
## 8. 運行機制 (Docker / Sail)
|
|
||||||
由於專案運行在 Docker 容器環境中，請勿直接在宿主機 (Host) 執行 php 或 composer 指令。請使用專案內建的 `sail` 指令：
|
|
||||||
|
|
||||||
* **啟動環境**：`./vendor/bin/sail up -d`
|
|
||||||
* **執行 PHP 指令**：`./vendor/bin/sail php -v`
|
|
||||||
* **執行 Artisan 指令**：`./vendor/bin/sail artisan route:list`
|
|
||||||
* **執行 Composer**：`./vendor/bin/sail composer install`
|
|
||||||
* **執行 Node/NPM**：`./vendor/bin/sail npm run dev`
|
|
||||||
|
|
||||||
## 8. 部署與查修環境 (CI/CD)
|
|
||||||
* **自動化部署**：專案具備基於 Gitea Actions 的 CI/CD 自動化部署流程 (`.gitea/workflows/`)。
|
|
||||||
* **Demo 環境 (對應 `demo` 分支)**：
|
|
||||||
* 透過 `deploy-demo.yaml`，合併或推送到 `demo` 分支會自動部署至 `demo-cloud.taiwan-star.com.tw`。
|
|
||||||
* 登入伺服器查修：`ssh gitea_work`，路徑為 `/var/www/star-cloud-demo`。
|
|
||||||
|
|
||||||
## 9. 瀏覽器測試規範 (Browser Testing)
|
|
||||||
當需要進行瀏覽器自動化測試或手動驗證時，必須遵守以下連線資訊：
|
|
||||||
|
|
||||||
* **本地測試網址**：`http://localhost:8090/` (注意：非 8000 或 8080)
|
|
||||||
* **預設管理員帳號**：`admin`
|
|
||||||
* **預設管理員密碼**：`password`
|
|
||||||
|
|
||||||
> [!IMPORTANT]
|
|
||||||
> 在執行 `open_browser_url` 或進行 E2E 測試時，請務必優先確認 Port 是否為 `8090`，以避免連線至錯誤的服務環境。
|
|
||||||
@@ -1,41 +0,0 @@
|
|||||||
---
|
|
||||||
trigger: always_on
|
|
||||||
---
|
|
||||||
|
|
||||||
# 技能觸發規範 (Skill Trigger Rules)
|
|
||||||
|
|
||||||
本文件確保 AI 助手在對話中能**主動辨識**需要參照技能 (Skill) 的時機。
|
|
||||||
Skills 位於 `.agents/skills/`，採漸進式揭露以節省 Token。
|
|
||||||
**若對話內容命中以下任一觸發條件，必須先使用 `view_file` 讀取對應的 `SKILL.md` 後標記為 active 再進行作業。**
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 觸發對照表
|
|
||||||
|
|
||||||
| 觸發詞 / 情境 | 對應 Skill | 路徑 |
|
|
||||||
|---|---|---|
|
|
||||||
| 機台通訊, IoT, 日誌上報, Log Ingestion, 異步隊列, Queue, Heartbeat, 心跳發報 | **IoT 通訊與高併發處理規範** | `.agents/skills/iot-communication/SKILL.md` |
|
|
||||||
| 介面, UI, 佈局, CSS, Tailwind, 奢華, 深色模式, Light Mode, Dark Mode, Blade, 樣式, 間距, 陰影, 動畫 | **極簡奢華風 UI 實作規範** | `.agents/skills/ui-minimal-luxury/SKILL.md` |
|
|
||||||
| 查詢、撈資料、Query、Controller、下拉選單、Eloquent、N+1、`->get()`、select、交易、Transaction、Bulk、分頁、索引 | **資料庫與 ORM 最佳實踐規範** | `/home/mama/.gemini/antigravity/global_skills/database-best-practices/SKILL.md` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 強制觸發場景
|
|
||||||
|
|
||||||
以下場景**無論對話中是否出現觸發詞**，都必須主動載入對應 Skill：
|
|
||||||
|
|
||||||
### 🔴 新增或修改頁面 (Views/Blade) 時
|
|
||||||
必須讀取：
|
|
||||||
1. **ui-minimal-luxury** — 確保符合極簡奢華風視覺與互動規範
|
|
||||||
|
|
||||||
### 🔴 新增機台通訊 API 端點時
|
|
||||||
必須讀取：
|
|
||||||
1. **iot-communication** — 決定是否使用異步隊列流程
|
|
||||||
|
|
||||||
### 🔴 修改 Job 或 Service 邏輯時
|
|
||||||
必須讀取：
|
|
||||||
1. **iot-communication** — 確保符合高併發處理架構
|
|
||||||
|
|
||||||
### 🔴 新增或修改 API 與 Controller 撈取資料庫邏輯時
|
|
||||||
必須讀取：
|
|
||||||
1. **database-best-practices** — 確認查詢優化、交易安全、批量寫入與索引規範
|
|
||||||
@@ -1,63 +0,0 @@
|
|||||||
---
|
|
||||||
name: IoT 通訊與高併發處理規範
|
|
||||||
description: 規範智能販賣機與 Cloud 平台間的高頻通訊處理流程，包含 API 接收、異步隊列、業務邏輯拆分與日誌記錄。
|
|
||||||
---
|
|
||||||
|
|
||||||
# IoT 通訊與高併發處理規範 (IoT Communication Skill)
|
|
||||||
|
|
||||||
本規範確保 Star-Cloud 系統在處理成千上萬台機台的高頻發報時，能維持伺服器響應速度與資料一致性。
|
|
||||||
|
|
||||||
## 1. 處理管線 (Processing Pipeline)
|
|
||||||
|
|
||||||
所有來自機台的非即時性資料（日誌、心跳、狀態上報）必須遵循以下 pipeline：
|
|
||||||
|
|
||||||
1. **API Controller (接收層)**：驗證 Request 合法性，隨即分派 (Dispatch) 任務至 Queue，並回傳 `202 Accepted`。
|
|
||||||
2. **Job (異步層)**：由背景 Worker 讀取隊列任務，呼叫對應 Service 處理。
|
|
||||||
3. **Service (邏輯層)**：封裝商業邏輯，更新資料庫。
|
|
||||||
4. **Model (儲存層)**：執行資料存取。
|
|
||||||
|
|
||||||
> [!IMPORTANT]
|
|
||||||
> **嚴禁**在 API Controller 直接進行資料庫寫入操作（針對機台發訊端點）。
|
|
||||||
|
|
||||||
## 2. 異步任務實作範例
|
|
||||||
|
|
||||||
### 2.1 API Endpoint
|
|
||||||
```php
|
|
||||||
public function storeLog(Request $request, int $id): JsonResponse
|
|
||||||
{
|
|
||||||
// 1. 驗證
|
|
||||||
$data = $request->validate([...]);
|
|
||||||
|
|
||||||
// 2. 異步分派
|
|
||||||
ProcessMachineLog::dispatch($id, $data);
|
|
||||||
|
|
||||||
// 3. 快速回應
|
|
||||||
return $this->successResponse([], 'Accepted', 202);
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2.2 Job 處理邏輯
|
|
||||||
Job 應保持單純，僅作為 Service 的觸發點：
|
|
||||||
```php
|
|
||||||
public function handle(MachineService $service): void
|
|
||||||
{
|
|
||||||
$service->recordLog($this->machineId, $this->logData);
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## 3. 隊列配置規範
|
|
||||||
|
|
||||||
- **連接驅動 (Driver)**：預設使用 `Redis` 以確保高併發吞吐量。
|
|
||||||
- **重試機制 (Retry)**：IoT 任務應設定合理的重試次數，避免因網路短暫波動遺失日誌。
|
|
||||||
- **失敗處理 (Failed Jobs)**：關鍵業務（如訂單同步）必須監控 `failed_jobs`。
|
|
||||||
|
|
||||||
## 4. 速率限制 (Rate Limiting)
|
|
||||||
|
|
||||||
- 所有的 IoT API 必須在 `routes/api.php` 中使用 `throttle:api` 或自定義 Middleware。
|
|
||||||
- 針對單一機台 ID 應限制其每一分鐘的最高連線數，防止遭受攻擊或機台 Bug 導致的連線暴衝。
|
|
||||||
|
|
||||||
## 5. 檢核項目 (Checklist)
|
|
||||||
- [ ] 是否使用了 `ApiResponse` Trait？
|
|
||||||
- [ ] 業務邏輯是否已封裝至 `App\Services`？
|
|
||||||
- [ ] 是否使用了 Redis Queue 進行非同步處理？
|
|
||||||
- [ ] 是否在 API 層級進行了基礎的參數驗證？
|
|
||||||
@@ -1,90 +0,0 @@
|
|||||||
---
|
|
||||||
name: 極簡奢華風 UI 實作規範 (Minimal Luxury UI)
|
|
||||||
description: 定義 Star Cloud 管理後台的「極簡奢華風」設計規範，包含 CSS Tokens、常用組件樣式、動畫效果與互動模式，確保全站 15+ 模組的視覺一致性。
|
|
||||||
---
|
|
||||||
|
|
||||||
# 極簡奢華風 UI 實作規範 (Minimal Luxury UI)
|
|
||||||
|
|
||||||
本文件定義了 Star Cloud 專案的核心視覺語言。所有新頁面與組件開發必須嚴格遵守此規範。
|
|
||||||
|
|
||||||
## 1. 核心設計令牌 (Design Tokens)
|
|
||||||
|
|
||||||
### 色彩系統 (CSS Variables)
|
|
||||||
位於 `resources/css/app.css`：
|
|
||||||
- `--color-luxury-deep`: `#0f172a` (深色背景)
|
|
||||||
- `--color-luxury-card`: `#1e293b` (卡片背景)
|
|
||||||
- `--color-accent`: `#06b6d4` (青色點綴，適用於按鈕與標示)
|
|
||||||
|
|
||||||
### 字體 (Typography)
|
|
||||||
- **內文字體**: `Plus Jakarta Sans`
|
|
||||||
- **標題/顯示字體**: `Outfit`
|
|
||||||
- **特性**: 標題需帶有 `letter-spacing: -0.02em` 以增強精密感。
|
|
||||||
|
|
||||||
## 2. 核心組件樣式
|
|
||||||
|
|
||||||
### 豪華卡片 (Luxury Card)
|
|
||||||
```html
|
|
||||||
<div class="luxury-card p-6 rounded-2xl animate-luxury-in">
|
|
||||||
<!-- 內容 -->
|
|
||||||
</div>
|
|
||||||
```
|
|
||||||
- **特效**: 懸停時帶有 Y 軸平移與深度投影。
|
|
||||||
|
|
||||||
### 側邊導覽項 (Luxury Nav Item)
|
|
||||||
```html
|
|
||||||
<a href="#" class="luxury-nav-item active">
|
|
||||||
<i class="lucide-icon"></i>
|
|
||||||
<span>節點名稱</span>
|
|
||||||
</a>
|
|
||||||
```
|
|
||||||
- **啟用狀態**: 左側帶有圓角直條指示器，並輔以青色發光陰影。
|
|
||||||
|
|
||||||
### 按鈕組件 (Buttons)
|
|
||||||
- **Primary**: `.btn-luxury-primary` (青色漸層，適用於建立、儲存)
|
|
||||||
- **Secondary**: `.btn-luxury-secondary` (白色/深色背景，帶邊框，適用於編輯、篩選)
|
|
||||||
- **Ghost**: `.btn-luxury-ghost` (無背景，適用於取消、查看更多)
|
|
||||||
|
|
||||||
```html
|
|
||||||
<!-- Primary -->
|
|
||||||
<button class="btn-luxury-primary">
|
|
||||||
<i class="lucide-plus size-4"></i>
|
|
||||||
<span>建立新機台</span>
|
|
||||||
</button>
|
|
||||||
|
|
||||||
<!-- Ghost -->
|
|
||||||
<button class="btn-luxury-ghost">取消</button>
|
|
||||||
```
|
|
||||||
|
|
||||||
## 3. 動畫與互動
|
|
||||||
|
|
||||||
### 進場動畫
|
|
||||||
- **`.animate-luxury-in`**: 所有的主內容區域或卡片在頁面載入時，應具備由下而上的淡入效果。
|
|
||||||
|
|
||||||
### Alpine.js 互動模式 (以時間選擇器為例)
|
|
||||||
- **互動原則**: 點擊觸發下拉選單時，必須使用 `x-transition` 且帶有 `scale` 偏移。
|
|
||||||
- **樣式要求**: 選單背景需使用玻璃擬態 (Glassmorphism) 或帶透明度的深色背景。
|
|
||||||
|
|
||||||
## 4. UI 檢查清單 (AI 助手執行前必讀)
|
|
||||||
- [ ] 是否使用了正確的 `rounded-2xl` (或更圓) 的導角？
|
|
||||||
- [ ] 所有的圖示是否一致使用 `lucide-react` 風格？
|
|
||||||
- [ ] 卡片是否有適當的間距 (通常為 `p-6`)？
|
|
||||||
- [ ] 文字色階是否符合：標題 (slate-900/white)、副標 (slate-500/slate-400)？
|
|
||||||
|
|
||||||
## 5. 開發注意事項 (Important Notes)
|
|
||||||
|
|
||||||
### 技術限制備忘
|
|
||||||
- **CSS 編譯**: 複雜的 `box-shadow` 或漸層應直接寫原生 CSS 屬性，避免在 `@apply` 中使用帶空格的數值導致編譯失敗（詳見 KI: `tailwind-luxury-ui-patterns`）。
|
|
||||||
- **深色模式**: 互動式按鈕在深色模式下必須強化文字亮度（`dark:text-white`），並輔以青色發光效果。
|
|
||||||
|
|
||||||
### 即時動態呈現規範
|
|
||||||
- **格式**: `#機台編號 動作內容` (例如 `#V-001 執行出貨`)。
|
|
||||||
- **脈絡**: 必須呈現相對時間與機台位置。
|
|
||||||
|
|
||||||
---
|
|
||||||
> [!IMPORTANT]
|
|
||||||
> **開發新功能前，必須確認 `app.css` 中的 `.btn-luxury-*` 系列組件是否滿足需求。**
|
|
||||||
> 嚴禁在 Blade 中寫入大量重複的 `bg-indigo-600` 等舊式類別。
|
|
||||||
|
|
||||||
---
|
|
||||||
> [!TIP]
|
|
||||||
> 當遇到未定義的 UI 區塊時，優先參考 `admin.dashboard.blade.php` 的卡片與即時動態實作方式進行衍生。
|
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
APP_NAME=starCloud
|
APP_NAME=startCloud
|
||||||
COMPOSE_PROJECT_NAME=star-cloud
|
COMPOSE_PROJECT_NAME=start-cloud
|
||||||
APP_ENV=local
|
APP_ENV=local
|
||||||
APP_KEY=
|
APP_KEY=
|
||||||
APP_DEBUG=true
|
APP_DEBUG=true
|
||||||
@@ -25,7 +25,7 @@ LOG_LEVEL=debug
|
|||||||
DB_CONNECTION=mysql
|
DB_CONNECTION=mysql
|
||||||
DB_HOST=mysql
|
DB_HOST=mysql
|
||||||
DB_PORT=3306
|
DB_PORT=3306
|
||||||
DB_DATABASE=star-cloud
|
DB_DATABASE=start-cloud
|
||||||
DB_USERNAME=sail
|
DB_USERNAME=sail
|
||||||
DB_PASSWORD=password
|
DB_PASSWORD=password
|
||||||
# FORWARD_DB_PORT=3308
|
# FORWARD_DB_PORT=3308
|
||||||
|
|||||||
@@ -22,12 +22,12 @@ jobs:
|
|||||||
echo "${{ secrets.DEMO_SSH_KEY }}" > ~/.ssh/id_rsa_demo
|
echo "${{ secrets.DEMO_SSH_KEY }}" > ~/.ssh/id_rsa_demo
|
||||||
chmod 600 ~/.ssh/id_rsa_demo
|
chmod 600 ~/.ssh/id_rsa_demo
|
||||||
rsync -avz --delete \
|
rsync -avz --delete \
|
||||||
--exclude='.git' \
|
--exclude='/.git' \
|
||||||
--exclude='node_modules' \
|
--exclude='/node_modules' \
|
||||||
--exclude='vendor' \
|
--exclude='/vendor' \
|
||||||
--exclude='storage' \
|
--exclude='/storage' \
|
||||||
--exclude='.env' \
|
--exclude='/.env' \
|
||||||
--exclude='public/build' \
|
--exclude='/public/build' \
|
||||||
-e "ssh -p 2227 -i ~/.ssh/id_rsa_demo -o StrictHostKeyChecking=no" \
|
-e "ssh -p 2227 -i ~/.ssh/id_rsa_demo -o StrictHostKeyChecking=no" \
|
||||||
./ root@220.132.7.82:/var/www/star-cloud-demo/
|
./ root@220.132.7.82:/var/www/star-cloud-demo/
|
||||||
rm ~/.ssh/id_rsa_demo
|
rm ~/.ssh/id_rsa_demo
|
||||||
@@ -92,9 +92,13 @@ jobs:
|
|||||||
|
|
||||||
# 3. Laravel 初始化與優化
|
# 3. Laravel 初始化與優化
|
||||||
php artisan migrate --force &&
|
php artisan migrate --force &&
|
||||||
|
php artisan storage:link &&
|
||||||
php artisan optimize:clear &&
|
php artisan optimize:clear &&
|
||||||
php artisan optimize &&
|
php artisan optimize &&
|
||||||
php artisan view:cache
|
php artisan view:cache &&
|
||||||
|
php artisan queue:restart &&
|
||||||
|
php artisan db:seed --class=RoleSeeder --force &&
|
||||||
|
php artisan db:seed --class=AdminUserSeeder --force
|
||||||
"
|
"
|
||||||
docker exec star-cloud-demo-laravel chmod -R 775 /var/www/html/storage /var/www/html/bootstrap/cache
|
docker exec star-cloud-demo-laravel chmod -R 775 /var/www/html/storage /var/www/html/bootstrap/cache
|
||||||
|
|
||||||
|
|||||||
4
.gitignore
vendored
4
.gitignore
vendored
@@ -17,7 +17,3 @@ yarn-error.log
|
|||||||
/.fleet
|
/.fleet
|
||||||
/.idea
|
/.idea
|
||||||
/.vscode
|
/.vscode
|
||||||
/docs/API
|
|
||||||
/docs/*.xlsx
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
216
README.md
216
README.md
@@ -1,116 +1,112 @@
|
|||||||
# Star Cloud 智能販賣機管理平台
|
# Star Cloud 智能販賣機管理平台
|
||||||
|
|
||||||
> 基於 Docker 的全方位智能販賣機後台管理系統 (Cloud 平台)
|
## 專案簡介 (Project Description)
|
||||||
|
Star Cloud 是一個專為智能販賣機設計的後台管理系統，旨在提供全方位的機台監控、庫存管理、銷售分析與會員管理功能。透過此平台，管理者可以即時掌握機台運營狀態，優化補貨流程，並透過數據分析提升營運效益。
|
||||||
|
|
||||||
Star Cloud 是一個專為智能販賣機設計的後台管理系統，負責管理機台、商品、銷售數據，並為硬體端點提供專用的 API。
|
## 技術棧 (Technology Stack)
|
||||||
|
|
||||||
|
### 後端 (Backend)
|
||||||
|
- **Framework**: Laravel 10.x
|
||||||
|
- **Language**: PHP 8.1+
|
||||||
|
- **Database**: MySQL 8.0+
|
||||||
|
- **Authentication**: Laravel Sanctum (API Token Authentication)
|
||||||
|
- **Tools**: Composer
|
||||||
|
|
||||||
|
### 前端 (Frontend)
|
||||||
|
- **Framework**: Blade Templates (Laravel 預設樣板引擎)
|
||||||
|
- **CSS Framework**: Tailwind CSS 3.x
|
||||||
|
- **JavaScript**: Alpine.js 3.x
|
||||||
|
- **Build Tool**: Vite 5.x
|
||||||
|
- **HTTP Client**: Axios
|
||||||
|
|
||||||
|
## 安裝與使用說明 (Installation & Usage)
|
||||||
|
|
||||||
|
請依照以下步驟將專案 Clone 至本地端並開始運行：
|
||||||
|
|
||||||
|
### 0. 前置需求 (Prerequisites)
|
||||||
|
確保您的系統已安裝以下軟體：
|
||||||
|
- PHP 8.1+
|
||||||
|
- Composer
|
||||||
|
- Node.js & npm
|
||||||
|
- MySQL 8.0+
|
||||||
|
|
||||||
|
若您尚未安裝 MySQL，Windows 使用者可至 [MySQL 官網](https://dev.mysql.com/downloads/installer/) 下載 Installer，或使用 XAMPP / Laragon 等整合環境。
|
||||||
|
|
||||||
|
### 1. 下載專案 (Clone Repository)
|
||||||
|
```bash
|
||||||
|
git clone <repository_url>
|
||||||
|
cd star-cloud
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 安裝依賴套件 (Install Dependencies)
|
||||||
|
|
||||||
|
安裝後端 PHP 套件：
|
||||||
|
```bash
|
||||||
|
composer install
|
||||||
|
```
|
||||||
|
|
||||||
|
安裝前端 Node.js 套件：
|
||||||
|
```bash
|
||||||
|
npm install
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 環境變數設定 (Environment Setup)
|
||||||
|
複製範例環境設定檔：
|
||||||
|
```bash
|
||||||
|
cp .env.example .env
|
||||||
|
```
|
||||||
|
|
||||||
|
請開啟 `.env` 檔案，並依照您的本地環境設定資料庫連線資訊：
|
||||||
|
```dotenv
|
||||||
|
DB_CONNECTION=mysql
|
||||||
|
DB_HOST=127.0.0.1
|
||||||
|
DB_PORT=3306
|
||||||
|
DB_DATABASE=star_cloud
|
||||||
|
DB_USERNAME=root
|
||||||
|
DB_PASSWORD=your_password
|
||||||
|
```
|
||||||
|
|
||||||
|
產生應用程式金鑰 (Application Key)：
|
||||||
|
```bash
|
||||||
|
php artisan key:generate
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 資料庫遷移 (Database Migration)
|
||||||
|
執行 Migration 以建立資料庫結構：
|
||||||
|
```bash
|
||||||
|
php artisan migrate
|
||||||
|
```
|
||||||
|
php artisan migrate --seed
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.1 預設管理員帳號 (Default Admin Account)
|
||||||
|
執行上述指令後，系統會建立一組預設管理員帳號：
|
||||||
|
- **Email**: `admin@star-cloud.com`
|
||||||
|
- **Password**: `password`
|
||||||
|
|
||||||
|
### 5. 編譯前端資源 (Build Frontend Assets)
|
||||||
|
啟動開發模式 (Hot Module Replacement)：
|
||||||
|
```bash
|
||||||
|
npm run dev
|
||||||
|
```
|
||||||
|
或編譯生產環境檔案：
|
||||||
|
```bash
|
||||||
|
npm run build
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. 啟動伺服器 (Start Server)
|
||||||
|
啟動 Laravel 開發伺服器：
|
||||||
|
```bash
|
||||||
|
php artisan serve --port=8001
|
||||||
|
```
|
||||||
|
預設網址為：http://localhost:8001
|
||||||
|
|
||||||
|
## 主要功能模組
|
||||||
|
- **儀錶板 (Dashboard)**: 銷售數據概覽、機台狀態監控
|
||||||
|
- **機台管理 (Machine Management)**: 機台列表、遠端控制、日誌查詢
|
||||||
|
- **商品與庫存 (Inventory)**: 商品管理、進銷存、補貨單
|
||||||
|
- **銷售管理 (Sales)**: 交易紀錄、營收報表
|
||||||
|
- **權限設定 (Permissions)**: 角色與權限分配
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚀 技術架構
|
|
||||||
|
|
||||||
### 核心架構
|
|
||||||
本專案採用 **傳統單體式架構 (Monolithic Architecture)**，結合 Laravel Blade 引擎進行伺服器端渲染 (SSR)。
|
|
||||||
|
|
||||||
| 服務 | 容器名稱 | 技術 | 用途 | 本地 Port |
|
|
||||||
|------|---------|------|------|--------|
|
|
||||||
| **應用程式** | `star-cloud-laravel` | Laravel 12 + PHP 8.5 | 核心業務與渲染 | 8090 |
|
|
||||||
| **資料庫** | `star-cloud-mysql` | MySQL 8.0 | 數據持久化 | 3306 |
|
|
||||||
| **快取/隊列** | `star-cloud-redis` | Redis Alpine | IoT 高併發隊列 | 6380 |
|
|
||||||
|
|
||||||
### 後端技術棧
|
|
||||||
- **Framework**: Laravel 12.x
|
|
||||||
- **Language**: PHP 8.5
|
|
||||||
- **Redis**: 用於 IoT 高併發隊列 (B010, B600 等)
|
|
||||||
- **Database**: MySQL 8.0
|
|
||||||
|
|
||||||
### 前端技術棧
|
|
||||||
- **View**: Laravel Blade
|
|
||||||
- **CSS**: Tailwind CSS + **Preline UI**
|
|
||||||
- **JS**: Alpine.js (行為控制)
|
|
||||||
- **Build**: Vite
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🛠️ 開發環境 (Laravel Sail)
|
|
||||||
|
|
||||||
本專案建議使用 **Laravel Sail** 進行開發，避免直接在宿主機執行指令。
|
|
||||||
|
|
||||||
### 前置需求
|
|
||||||
- Docker Desktop (Windows/Mac) 或 Docker Engine (Linux)
|
|
||||||
- Git
|
|
||||||
|
|
||||||
### 快速啟動
|
|
||||||
1. `clone` 專案並進入目錄
|
|
||||||
2. `cp .env.example .env`
|
|
||||||
3. `./vendor/bin/sail up -d`
|
|
||||||
4. `./vendor/bin/sail composer install`
|
|
||||||
5. `./vendor/bin/sail artisan key:generate`
|
|
||||||
6. `./vendor/bin/sail artisan migrate --seed`
|
|
||||||
7. `./vendor/bin/sail npm install`
|
|
||||||
8. `./vendor/bin/sail npm run dev`
|
|
||||||
|
|
||||||
### 常用開發指令
|
|
||||||
| 功能 | 指令 |
|
|
||||||
|------|------|
|
|
||||||
| 啟動環境 | `./vendor/bin/sail up -d` |
|
|
||||||
| 停止環境 | `./vendor/bin/sail down` |
|
|
||||||
| Artisan 指令 | `./vendor/bin/sail artisan <cmd>` |
|
|
||||||
| Composer 指令 | `./vendor/bin/sail composer <cmd>` |
|
|
||||||
| NPM 指令 | `./vendor/bin/sail npm <cmd>` |
|
|
||||||
| 執行測試 | `./vendor/bin/sail test` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔐 API 規範
|
|
||||||
|
|
||||||
系統 API 分為兩大類，遵循不同的設計慣例：
|
|
||||||
|
|
||||||
### 1. Admin/Web API (`/api/v1/...`)
|
|
||||||
- **對象**: 後台管理介面、APP UI。
|
|
||||||
- **認證**: Laravel Sanctum (Session/Token)。
|
|
||||||
- **格式**: 標準 RESTful JSON。
|
|
||||||
|
|
||||||
### 2. Machine IoT API (`/api/app/...`)
|
|
||||||
- **對象**: 智能販賣機、計時器等硬體。
|
|
||||||
- **認證**: Header `Authorization: Bearer <api_token>`。
|
|
||||||
- **高併發處理**: 核心日誌 (B010 心跳、B600 交易) **嚴禁直寫 DB**，必須進入 **Redis Queue** 背景異步處理。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🌐 多語系支援 (I18n)
|
|
||||||
|
|
||||||
所有 UI 顯示文字必須支援多語系，禁止 Hard-coded。
|
|
||||||
- **語系檔案**: `lang/zh_TW.json`, `lang/en.json`, `lang/ja.json`。
|
|
||||||
- **呼叫方式**: 使用 `__('Phrases in English')` 或 `@lang('...')`。
|
|
||||||
- **命名規範**: 優先使用「英文原始詞彙」作為 Key 名稱。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📂 目錄結構
|
|
||||||
|
|
||||||
- `app/Http/Controllers/`: 控制器
|
|
||||||
- `app/Models/{Domain}/`: 分領域的模型 (如 `Machine`, `Member`)
|
|
||||||
- `app/Services/{Domain}/`: 封裝商業邏輯與資料異動
|
|
||||||
- `app/Jobs/{Domain}/`: IoT 異步隊列處理任務 (重要)
|
|
||||||
- `resources/views/`: Blade 模板 (按功能分資料夾)
|
|
||||||
- `resources/views/components/`: 可重用的 UI 組件
|
|
||||||
- `routes/`: 路由定義 (`web.php` 與 `api.php`)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚢 CI/CD 與部署
|
|
||||||
|
|
||||||
- **自動化工具**: Gitea Actions (`.gitea/workflows/`)。
|
|
||||||
- **Demo 環境**: 推送到 `demo` 分支會自動部署至 `demo-cloud.taiwan-star.com.tw`。
|
|
||||||
- **伺服器路徑**: `/var/www/star-cloud-demo` (透過 `ssh gitea_work` 登入)。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 授權與版權
|
|
||||||
© Star Cloud. All Rights Reserved.
|
© Star Cloud. All Rights Reserved.
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 技術支援
|
|
||||||
|
|
||||||
如有問題或建議，請聯繫開發團隊或提交 Issue。
|
|
||||||
@@ -1,64 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Console\Commands\Machine;
|
|
||||||
|
|
||||||
use App\Models\Machine\Machine;
|
|
||||||
use Illuminate\Console\Command;
|
|
||||||
use Illuminate\Support\Facades\Http;
|
|
||||||
|
|
||||||
class SimulateMachineLogs extends Command
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* @var string
|
|
||||||
*/
|
|
||||||
protected $signature = 'simulate:machine-logs {--count=10 : 發送日誌的次數}';
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @var string
|
|
||||||
*/
|
|
||||||
protected $description = '模擬機台發送 API 日誌請求到後端 (用於壓測與驗證 Queue)';
|
|
||||||
|
|
||||||
public function handle(): void
|
|
||||||
{
|
|
||||||
$count = (int) $this->option('count');
|
|
||||||
$machines = Machine::all();
|
|
||||||
|
|
||||||
if ($machines->isEmpty()) {
|
|
||||||
$this->error('No machines found. Please run MachineSeeder first.');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
$this->info("Starting simulation of {$count} logs...");
|
|
||||||
|
|
||||||
$bar = $this->output->createProgressBar($count);
|
|
||||||
$bar->start();
|
|
||||||
|
|
||||||
// 由於是在同一個開發環境，且在 Sail 容器內部執行，
|
|
||||||
// 外部 8090 埠對應容器內部 8080 埠。
|
|
||||||
$baseUrl = 'http://localhost:8080/api/v1/machines/';
|
|
||||||
|
|
||||||
for ($i = 0; $i < $count; $i++) {
|
|
||||||
$machine = $machines->random();
|
|
||||||
$level = collect(['info', 'warning', 'error'])->random();
|
|
||||||
|
|
||||||
try {
|
|
||||||
Http::post($baseUrl . $machine->id . '/logs', [
|
|
||||||
'level' => $level,
|
|
||||||
'message' => "Simulated message #{$i} for machine {$machine->name}",
|
|
||||||
'context' => [
|
|
||||||
'simulated' => true,
|
|
||||||
'timestamp' => now()->toIso8601String(),
|
|
||||||
]
|
|
||||||
]);
|
|
||||||
} catch (\Exception $e) {
|
|
||||||
$this->error("\nFailed to send log: " . $e->getMessage());
|
|
||||||
}
|
|
||||||
|
|
||||||
$bar->advance();
|
|
||||||
}
|
|
||||||
|
|
||||||
$bar->finish();
|
|
||||||
$this->newLine();
|
|
||||||
$this->info('Simulation completed.');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,10 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers\Admin;
|
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
|
||||||
|
|
||||||
abstract class AdminController extends Controller
|
|
||||||
{
|
|
||||||
// Admin 相關的共用邏輯可寫於此
|
|
||||||
}
|
|
||||||
@@ -3,7 +3,7 @@
|
|||||||
namespace App\Http\Controllers\Admin;
|
namespace App\Http\Controllers\Admin;
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
use App\Http\Controllers\Controller;
|
||||||
use App\Models\System\AppConfig;
|
use App\Models\AppConfig;
|
||||||
use Illuminate\Http\Request;
|
use Illuminate\Http\Request;
|
||||||
|
|
||||||
class AppConfigController extends Controller
|
class AppConfigController extends Controller
|
||||||
|
|||||||
@@ -3,31 +3,25 @@
|
|||||||
namespace App\Http\Controllers\Admin;
|
namespace App\Http\Controllers\Admin;
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
use App\Http\Controllers\Controller;
|
||||||
use App\Models\Machine\Machine;
|
use App\Models\Machine;
|
||||||
use Illuminate\Http\Request;
|
use Illuminate\Http\Request;
|
||||||
|
|
||||||
class DashboardController extends Controller
|
class DashboardController extends Controller
|
||||||
{
|
{
|
||||||
public function index()
|
public function index()
|
||||||
{
|
{
|
||||||
// 從資料庫獲取真實統計數據
|
// 模擬數據或從資料庫獲取
|
||||||
$totalRevenue = \App\Models\Member\MemberWallet::sum('balance');
|
// 由於目前沒有數據，我們先傳遞一些預設值或空集合
|
||||||
$activeMachines = Machine::where('status', 'online')->count();
|
$totalMachines = Machine::count();
|
||||||
$alertsPending = Machine::where('status', 'error')->count();
|
$onlineMachines = Machine::where('status', 'online')->count();
|
||||||
$memberCount = \App\Models\Member\Member::count();
|
$offlineMachines = Machine::where('status', 'offline')->count();
|
||||||
|
$errorMachines = Machine::where('status', 'error')->count();
|
||||||
// 獲取最新動態 (最近 3 筆機台日誌)
|
|
||||||
$latestActivities = \App\Models\Machine\MachineLog::with('machine')
|
|
||||||
->latest()
|
|
||||||
->limit(3)
|
|
||||||
->get();
|
|
||||||
|
|
||||||
return view('admin.dashboard', compact(
|
return view('admin.dashboard', compact(
|
||||||
'totalRevenue',
|
'totalMachines',
|
||||||
'activeMachines',
|
'onlineMachines',
|
||||||
'alertsPending',
|
'offlineMachines',
|
||||||
'memberCount',
|
'errorMachines'
|
||||||
'latestActivities'
|
|
||||||
));
|
));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,56 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers\Admin;
|
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
|
||||||
use App\Models\Member\DepositBonusRule;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
|
|
||||||
class DepositBonusRuleController extends Controller
|
|
||||||
{
|
|
||||||
public function index()
|
|
||||||
{
|
|
||||||
$rules = DepositBonusRule::orderBy('min_amount')->get();
|
|
||||||
return view('admin.deposit-bonus-rules.index', compact('rules'));
|
|
||||||
}
|
|
||||||
|
|
||||||
public function store(Request $request)
|
|
||||||
{
|
|
||||||
$validated = $request->validate([
|
|
||||||
'name' => 'required|string|max:255',
|
|
||||||
'min_amount' => 'required|numeric|min:0',
|
|
||||||
'bonus_type' => 'required|in:fixed,percentage',
|
|
||||||
'bonus_value' => 'required|numeric|min:0',
|
|
||||||
'is_active' => 'boolean',
|
|
||||||
'start_at' => 'nullable|date',
|
|
||||||
'end_at' => 'nullable|date|after:start_at',
|
|
||||||
]);
|
|
||||||
|
|
||||||
DepositBonusRule::create($validated);
|
|
||||||
|
|
||||||
return redirect()->route('admin.deposit-bonus-rules.index')->with('success', '儲值回饋規則已建立');
|
|
||||||
}
|
|
||||||
|
|
||||||
public function update(Request $request, DepositBonusRule $depositBonusRule)
|
|
||||||
{
|
|
||||||
$validated = $request->validate([
|
|
||||||
'name' => 'required|string|max:255',
|
|
||||||
'min_amount' => 'required|numeric|min:0',
|
|
||||||
'bonus_type' => 'required|in:fixed,percentage',
|
|
||||||
'bonus_value' => 'required|numeric|min:0',
|
|
||||||
'is_active' => 'boolean',
|
|
||||||
'start_at' => 'nullable|date',
|
|
||||||
'end_at' => 'nullable|date|after:start_at',
|
|
||||||
]);
|
|
||||||
|
|
||||||
$depositBonusRule->update($validated);
|
|
||||||
|
|
||||||
return redirect()->route('admin.deposit-bonus-rules.index')->with('success', '儲值回饋規則已更新');
|
|
||||||
}
|
|
||||||
|
|
||||||
public function destroy(DepositBonusRule $depositBonusRule)
|
|
||||||
{
|
|
||||||
$depositBonusRule->delete();
|
|
||||||
return redirect()->route('admin.deposit-bonus-rules.index')->with('success', '儲值回饋規則已刪除');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,58 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers\Admin;
|
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
|
||||||
use App\Models\Member\GiftDefinition;
|
|
||||||
use App\Models\Member\MembershipTier;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
|
|
||||||
class GiftDefinitionController extends Controller
|
|
||||||
{
|
|
||||||
public function index()
|
|
||||||
{
|
|
||||||
$gifts = GiftDefinition::with('tier')->get();
|
|
||||||
$tiers = MembershipTier::orderBy('sort_order')->get();
|
|
||||||
return view('admin.gift-definitions.index', compact('gifts', 'tiers'));
|
|
||||||
}
|
|
||||||
|
|
||||||
public function store(Request $request)
|
|
||||||
{
|
|
||||||
$validated = $request->validate([
|
|
||||||
'name' => 'required|string|max:255',
|
|
||||||
'type' => 'required|in:points,coupon,product,discount,cash',
|
|
||||||
'value' => 'required|numeric|min:0',
|
|
||||||
'tier_id' => 'nullable|exists:membership_tiers,id',
|
|
||||||
'trigger' => 'required|in:register,birthday,annual,upgrade,manual',
|
|
||||||
'validity_days' => 'required|integer|min:1',
|
|
||||||
'is_active' => 'boolean',
|
|
||||||
]);
|
|
||||||
|
|
||||||
GiftDefinition::create($validated);
|
|
||||||
|
|
||||||
return redirect()->route('admin.gift-definitions.index')->with('success', '禮品已建立');
|
|
||||||
}
|
|
||||||
|
|
||||||
public function update(Request $request, GiftDefinition $giftDefinition)
|
|
||||||
{
|
|
||||||
$validated = $request->validate([
|
|
||||||
'name' => 'required|string|max:255',
|
|
||||||
'type' => 'required|in:points,coupon,product,discount,cash',
|
|
||||||
'value' => 'required|numeric|min:0',
|
|
||||||
'tier_id' => 'nullable|exists:membership_tiers,id',
|
|
||||||
'trigger' => 'required|in:register,birthday,annual,upgrade,manual',
|
|
||||||
'validity_days' => 'required|integer|min:1',
|
|
||||||
'is_active' => 'boolean',
|
|
||||||
]);
|
|
||||||
|
|
||||||
$giftDefinition->update($validated);
|
|
||||||
|
|
||||||
return redirect()->route('admin.gift-definitions.index')->with('success', '禮品已更新');
|
|
||||||
}
|
|
||||||
|
|
||||||
public function destroy(GiftDefinition $giftDefinition)
|
|
||||||
{
|
|
||||||
$giftDefinition->delete();
|
|
||||||
return redirect()->route('admin.gift-definitions.index')->with('success', '禮品已刪除');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -2,88 +2,142 @@
|
|||||||
|
|
||||||
namespace App\Http\Controllers\Admin;
|
namespace App\Http\Controllers\Admin;
|
||||||
|
|
||||||
use App\Models\Machine\Machine;
|
use App\Http\Controllers\Controller;
|
||||||
|
use App\Models\Machine;
|
||||||
use Illuminate\Http\Request;
|
use Illuminate\Http\Request;
|
||||||
use Illuminate\View\View;
|
|
||||||
|
|
||||||
class MachineController extends AdminController
|
class MachineController extends Controller
|
||||||
{
|
{
|
||||||
/**
|
/**
|
||||||
* 顯示所有機台列表
|
* Display a listing of the resource.
|
||||||
*/
|
*/
|
||||||
public function index(Request $request): View
|
public function index()
|
||||||
{
|
{
|
||||||
$machines = Machine::query()
|
$machines = Machine::latest()->paginate(10);
|
||||||
->when($request->status, function ($query, $status) {
|
|
||||||
return $query->where('status', $status);
|
|
||||||
})
|
|
||||||
->latest()
|
|
||||||
->paginate(10);
|
|
||||||
|
|
||||||
return view('admin.machines.index', compact('machines'));
|
return view('admin.machines.index', compact('machines'));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 顯示特定機台的日誌與詳細資訊
|
* Show the form for creating a new resource.
|
||||||
*/
|
*/
|
||||||
public function show(int $id): View
|
public function create()
|
||||||
{
|
{
|
||||||
$machine = Machine::with(['logs' => function ($query) {
|
return view('admin.machines.create');
|
||||||
$query->latest()->limit(50);
|
}
|
||||||
}])->findOrFail($id);
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Store a newly created resource in storage.
|
||||||
|
*/
|
||||||
|
public function store(Request $request)
|
||||||
|
{
|
||||||
|
$validated = $request->validate([
|
||||||
|
'name' => 'required|string|max:255',
|
||||||
|
'location' => 'nullable|string|max:255',
|
||||||
|
'status' => 'required|in:online,offline,error',
|
||||||
|
'temperature' => 'nullable|numeric',
|
||||||
|
'firmware_version' => 'nullable|string|max:50',
|
||||||
|
]);
|
||||||
|
|
||||||
|
Machine::create($validated);
|
||||||
|
|
||||||
|
return redirect()->route('admin.machines.index')
|
||||||
|
->with('success', '機台建立成功');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Display the specified resource.
|
||||||
|
*/
|
||||||
|
public function show(Machine $machine)
|
||||||
|
{
|
||||||
return view('admin.machines.show', compact('machine'));
|
return view('admin.machines.show', compact('machine'));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 顯示所有機台日誌列表
|
* Show the form for editing the specified resource.
|
||||||
*/
|
*/
|
||||||
public function logs(Request $request): View
|
public function edit(Machine $machine)
|
||||||
{
|
{
|
||||||
$logs = \App\Models\Machine\MachineLog::with('machine')
|
return view('admin.machines.edit', compact('machine'));
|
||||||
->when($request->level, function ($query, $level) {
|
|
||||||
return $query->where('level', $level);
|
|
||||||
})
|
|
||||||
->when($request->machine_id, function ($query, $machineId) {
|
|
||||||
return $query->where('machine_id', $machineId);
|
|
||||||
})
|
|
||||||
->latest()
|
|
||||||
->paginate(20);
|
|
||||||
|
|
||||||
$machines = Machine::select('id', 'name')->get();
|
|
||||||
|
|
||||||
return view('admin.machines.logs', compact('logs', 'machines'));
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 機台權限設定 (開發中)
|
* Update the specified resource in storage.
|
||||||
*/
|
*/
|
||||||
public function permissions(Request $request): View
|
public function update(Request $request, Machine $machine)
|
||||||
{
|
{
|
||||||
return view('admin.machines.index', ['machines' => Machine::paginate(1)]); // Placeholder
|
$validated = $request->validate([
|
||||||
|
'name' => 'required|string|max:255',
|
||||||
|
'location' => 'nullable|string|max:255',
|
||||||
|
'status' => 'required|in:online,offline,error',
|
||||||
|
'temperature' => 'nullable|numeric',
|
||||||
|
'firmware_version' => 'nullable|string|max:50',
|
||||||
|
]);
|
||||||
|
|
||||||
|
$machine->update($validated);
|
||||||
|
|
||||||
|
return redirect()->route('admin.machines.index')
|
||||||
|
->with('success', '機台更新成功');
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 機台使用率統計 (開發中)
|
* Remove the specified resource from storage.
|
||||||
*/
|
*/
|
||||||
public function utilization(Request $request): View
|
public function destroy(Machine $machine)
|
||||||
{
|
{
|
||||||
return view('admin.machines.index', ['machines' => Machine::paginate(1)]); // Placeholder
|
$machine->delete();
|
||||||
|
|
||||||
|
return redirect()->route('admin.machines.index')
|
||||||
|
->with('success', '機台已刪除');
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 機台日誌
|
||||||
* 機台到期管理 (開發中)
|
public function logs()
|
||||||
*/
|
|
||||||
public function expiry(Request $request): View
|
|
||||||
{
|
{
|
||||||
return view('admin.machines.index', ['machines' => Machine::paginate(1)]); // Placeholder
|
return view('admin.placeholder', [
|
||||||
|
'title' => '機台日誌',
|
||||||
|
'description' => '機台操作歷史紀錄回溯',
|
||||||
|
'features' => [
|
||||||
|
'操作時間戳記',
|
||||||
|
'事件類型分類',
|
||||||
|
'操作人員記錄',
|
||||||
|
'詳細描述查詢',
|
||||||
|
]
|
||||||
|
]);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 機台權限
|
||||||
* 機台維護紀錄 (開發中)
|
public function permissions()
|
||||||
*/
|
|
||||||
public function maintenance(Request $request): View
|
|
||||||
{
|
{
|
||||||
return view('admin.machines.index', ['machines' => Machine::paginate(1)]); // Placeholder
|
return view('admin.placeholder', [
|
||||||
|
'title' => '機台權限',
|
||||||
|
'description' => '機台存取權限控管',
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 機台稼動率
|
||||||
|
public function utilization()
|
||||||
|
{
|
||||||
|
return view('admin.placeholder', [
|
||||||
|
'title' => '機台稼動率',
|
||||||
|
'description' => '機台運行效率分析',
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 效期管理
|
||||||
|
public function expiry()
|
||||||
|
{
|
||||||
|
return view('admin.placeholder', [
|
||||||
|
'title' => '效期管理',
|
||||||
|
'description' => '商品效期與貨道出貨控制',
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 維修管理單
|
||||||
|
public function maintenance()
|
||||||
|
{
|
||||||
|
return view('admin.placeholder', [
|
||||||
|
'title' => '維修管理單',
|
||||||
|
'description' => '機台維修工單系統',
|
||||||
|
]);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,62 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers\Admin;
|
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
|
||||||
use App\Models\Member\MembershipTier;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
|
|
||||||
class MembershipTierController extends Controller
|
|
||||||
{
|
|
||||||
public function index()
|
|
||||||
{
|
|
||||||
$tiers = MembershipTier::orderBy('sort_order')->get();
|
|
||||||
return view('admin.membership-tiers.index', compact('tiers'));
|
|
||||||
}
|
|
||||||
|
|
||||||
public function store(Request $request)
|
|
||||||
{
|
|
||||||
$validated = $request->validate([
|
|
||||||
'name' => 'required|string|max:255',
|
|
||||||
'annual_fee' => 'required|numeric|min:0',
|
|
||||||
'discount_rate' => 'required|numeric|min:0|max:1',
|
|
||||||
'point_multiplier' => 'required|numeric|min:0',
|
|
||||||
'description' => 'nullable|string',
|
|
||||||
'is_default' => 'boolean',
|
|
||||||
]);
|
|
||||||
|
|
||||||
if ($request->is_default) {
|
|
||||||
MembershipTier::where('is_default', true)->update(['is_default' => false]);
|
|
||||||
}
|
|
||||||
|
|
||||||
MembershipTier::create($validated);
|
|
||||||
|
|
||||||
return redirect()->route('admin.membership-tiers.index')->with('success', '會員等級已建立');
|
|
||||||
}
|
|
||||||
|
|
||||||
public function update(Request $request, MembershipTier $membershipTier)
|
|
||||||
{
|
|
||||||
$validated = $request->validate([
|
|
||||||
'name' => 'required|string|max:255',
|
|
||||||
'annual_fee' => 'required|numeric|min:0',
|
|
||||||
'discount_rate' => 'required|numeric|min:0|max:1',
|
|
||||||
'point_multiplier' => 'required|numeric|min:0',
|
|
||||||
'description' => 'nullable|string',
|
|
||||||
'is_default' => 'boolean',
|
|
||||||
]);
|
|
||||||
|
|
||||||
if ($request->is_default && !$membershipTier->is_default) {
|
|
||||||
MembershipTier::where('is_default', true)->update(['is_default' => false]);
|
|
||||||
}
|
|
||||||
|
|
||||||
$membershipTier->update($validated);
|
|
||||||
|
|
||||||
return redirect()->route('admin.membership-tiers.index')->with('success', '會員等級已更新');
|
|
||||||
}
|
|
||||||
|
|
||||||
public function destroy(MembershipTier $membershipTier)
|
|
||||||
{
|
|
||||||
$membershipTier->delete();
|
|
||||||
return redirect()->route('admin.membership-tiers.index')->with('success', '會員等級已刪除');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,54 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers\Admin;
|
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
|
||||||
use App\Models\Member\PointRule;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
|
|
||||||
class PointRuleController extends Controller
|
|
||||||
{
|
|
||||||
public function index()
|
|
||||||
{
|
|
||||||
$rules = PointRule::all();
|
|
||||||
return view('admin.point-rules.index', compact('rules'));
|
|
||||||
}
|
|
||||||
|
|
||||||
public function store(Request $request)
|
|
||||||
{
|
|
||||||
$validated = $request->validate([
|
|
||||||
'name' => 'required|string|max:255',
|
|
||||||
'trigger' => 'required|in:purchase,deposit,register,birthday,referral',
|
|
||||||
'points_per_unit' => 'required|integer|min:1',
|
|
||||||
'unit_amount' => 'required|numeric|min:0',
|
|
||||||
'validity_days' => 'required|integer|min:1',
|
|
||||||
'is_active' => 'boolean',
|
|
||||||
]);
|
|
||||||
|
|
||||||
PointRule::create($validated);
|
|
||||||
|
|
||||||
return redirect()->route('admin.point-rules.index')->with('success', '點數規則已建立');
|
|
||||||
}
|
|
||||||
|
|
||||||
public function update(Request $request, PointRule $pointRule)
|
|
||||||
{
|
|
||||||
$validated = $request->validate([
|
|
||||||
'name' => 'required|string|max:255',
|
|
||||||
'trigger' => 'required|in:purchase,deposit,register,birthday,referral',
|
|
||||||
'points_per_unit' => 'required|integer|min:1',
|
|
||||||
'unit_amount' => 'required|numeric|min:0',
|
|
||||||
'validity_days' => 'required|integer|min:1',
|
|
||||||
'is_active' => 'boolean',
|
|
||||||
]);
|
|
||||||
|
|
||||||
$pointRule->update($validated);
|
|
||||||
|
|
||||||
return redirect()->route('admin.point-rules.index')->with('success', '點數規則已更新');
|
|
||||||
}
|
|
||||||
|
|
||||||
public function destroy(PointRule $pointRule)
|
|
||||||
{
|
|
||||||
$pointRule->delete();
|
|
||||||
return redirect()->route('admin.point-rules.index')->with('success', '點數規則已刪除');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,260 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers\Api;
|
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
|
||||||
use App\Models\Member\Member;
|
|
||||||
use App\Models\Member\SocialAccount;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
use Illuminate\Http\JsonResponse;
|
|
||||||
use Illuminate\Support\Facades\Hash;
|
|
||||||
use Illuminate\Support\Facades\Validator;
|
|
||||||
use Illuminate\Validation\Rules\Password;
|
|
||||||
|
|
||||||
class MemberController extends Controller
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 會員註冊
|
|
||||||
*/
|
|
||||||
public function register(Request $request): JsonResponse
|
|
||||||
{
|
|
||||||
$validator = Validator::make($request->all(), [
|
|
||||||
'name' => ['required', 'string', 'max:255'],
|
|
||||||
'email' => ['nullable', 'email', 'unique:members,email'],
|
|
||||||
'phone' => ['nullable', 'string', 'unique:members,phone'],
|
|
||||||
'password' => ['required', Password::min(6)],
|
|
||||||
'birthday' => ['nullable', 'date'],
|
|
||||||
'gender' => ['nullable', 'in:male,female,other'],
|
|
||||||
], [
|
|
||||||
'name.required' => '請輸入姓名',
|
|
||||||
'email.unique' => '此 Email 已被註冊',
|
|
||||||
'phone.unique' => '此手機號碼已被註冊',
|
|
||||||
'password.required' => '請輸入密碼',
|
|
||||||
]);
|
|
||||||
|
|
||||||
if ($validator->fails()) {
|
|
||||||
return response()->json([
|
|
||||||
'success' => false,
|
|
||||||
'message' => '驗證失敗',
|
|
||||||
'errors' => $validator->errors(),
|
|
||||||
], 422);
|
|
||||||
}
|
|
||||||
|
|
||||||
// 必須提供 email 或 phone 其中之一
|
|
||||||
if (empty($request->email) && empty($request->phone)) {
|
|
||||||
return response()->json([
|
|
||||||
'success' => false,
|
|
||||||
'message' => '請提供 Email 或手機號碼',
|
|
||||||
], 422);
|
|
||||||
}
|
|
||||||
|
|
||||||
$member = Member::create([
|
|
||||||
'name' => $request->name,
|
|
||||||
'email' => $request->email,
|
|
||||||
'phone' => $request->phone,
|
|
||||||
'password' => $request->password,
|
|
||||||
'birthday' => $request->birthday,
|
|
||||||
'gender' => $request->gender,
|
|
||||||
]);
|
|
||||||
|
|
||||||
$token = $member->createToken('member-token')->plainTextToken;
|
|
||||||
|
|
||||||
return response()->json([
|
|
||||||
'success' => true,
|
|
||||||
'message' => '註冊成功',
|
|
||||||
'data' => [
|
|
||||||
'member' => $member,
|
|
||||||
'token' => $token,
|
|
||||||
],
|
|
||||||
], 201);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 會員登入（Email/Phone + Password）
|
|
||||||
*/
|
|
||||||
public function login(Request $request): JsonResponse
|
|
||||||
{
|
|
||||||
$validator = Validator::make($request->all(), [
|
|
||||||
'account' => ['required', 'string'],
|
|
||||||
'password' => ['required', 'string'],
|
|
||||||
], [
|
|
||||||
'account.required' => '請輸入帳號',
|
|
||||||
'password.required' => '請輸入密碼',
|
|
||||||
]);
|
|
||||||
|
|
||||||
if ($validator->fails()) {
|
|
||||||
return response()->json([
|
|
||||||
'success' => false,
|
|
||||||
'message' => '驗證失敗',
|
|
||||||
'errors' => $validator->errors(),
|
|
||||||
], 422);
|
|
||||||
}
|
|
||||||
|
|
||||||
// 嘗試以 email 或 phone 查詢
|
|
||||||
$member = Member::where('email', $request->account)
|
|
||||||
->orWhere('phone', $request->account)
|
|
||||||
->first();
|
|
||||||
|
|
||||||
if (!$member || !Hash::check($request->password, $member->password)) {
|
|
||||||
return response()->json([
|
|
||||||
'success' => false,
|
|
||||||
'message' => '帳號或密碼錯誤',
|
|
||||||
], 401);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!$member->is_active) {
|
|
||||||
return response()->json([
|
|
||||||
'success' => false,
|
|
||||||
'message' => '帳號已被停用',
|
|
||||||
], 403);
|
|
||||||
}
|
|
||||||
|
|
||||||
$token = $member->createToken('member-token')->plainTextToken;
|
|
||||||
|
|
||||||
return response()->json([
|
|
||||||
'success' => true,
|
|
||||||
'message' => '登入成功',
|
|
||||||
'data' => [
|
|
||||||
'member' => $member,
|
|
||||||
'token' => $token,
|
|
||||||
],
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 社群登入
|
|
||||||
*/
|
|
||||||
public function socialLogin(Request $request): JsonResponse
|
|
||||||
{
|
|
||||||
$validator = Validator::make($request->all(), [
|
|
||||||
'provider' => ['required', 'in:line,google,facebook'],
|
|
||||||
'provider_id' => ['required', 'string'],
|
|
||||||
'access_token' => ['nullable', 'string'],
|
|
||||||
'name' => ['nullable', 'string'],
|
|
||||||
'email' => ['nullable', 'email'],
|
|
||||||
'avatar' => ['nullable', 'string'],
|
|
||||||
], [
|
|
||||||
'provider.required' => '請指定登入平台',
|
|
||||||
'provider.in' => '不支援的登入平台',
|
|
||||||
'provider_id.required' => '缺少社群用戶 ID',
|
|
||||||
]);
|
|
||||||
|
|
||||||
if ($validator->fails()) {
|
|
||||||
return response()->json([
|
|
||||||
'success' => false,
|
|
||||||
'message' => '驗證失敗',
|
|
||||||
'errors' => $validator->errors(),
|
|
||||||
], 422);
|
|
||||||
}
|
|
||||||
|
|
||||||
// 查詢是否已綁定
|
|
||||||
$socialAccount = SocialAccount::where('provider', $request->provider)
|
|
||||||
->where('provider_id', $request->provider_id)
|
|
||||||
->first();
|
|
||||||
|
|
||||||
if ($socialAccount) {
|
|
||||||
// 已綁定，直接登入
|
|
||||||
$member = $socialAccount->member;
|
|
||||||
|
|
||||||
// 更新 token
|
|
||||||
$socialAccount->update([
|
|
||||||
'access_token' => $request->access_token,
|
|
||||||
]);
|
|
||||||
} else {
|
|
||||||
// 未綁定，建立新會員
|
|
||||||
$member = Member::create([
|
|
||||||
'name' => $request->name ?? '會員',
|
|
||||||
'email' => $request->email,
|
|
||||||
'avatar' => $request->avatar,
|
|
||||||
'email_verified_at' => $request->email ? now() : null, // 社群登入自動驗證
|
|
||||||
]);
|
|
||||||
|
|
||||||
// 綁定社群帳號
|
|
||||||
$member->socialAccounts()->create([
|
|
||||||
'provider' => $request->provider,
|
|
||||||
'provider_id' => $request->provider_id,
|
|
||||||
'access_token' => $request->access_token,
|
|
||||||
'profile_data' => $request->only(['name', 'email', 'avatar']),
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!$member->is_active) {
|
|
||||||
return response()->json([
|
|
||||||
'success' => false,
|
|
||||||
'message' => '帳號已被停用',
|
|
||||||
], 403);
|
|
||||||
}
|
|
||||||
|
|
||||||
$token = $member->createToken('member-token')->plainTextToken;
|
|
||||||
|
|
||||||
return response()->json([
|
|
||||||
'success' => true,
|
|
||||||
'message' => '登入成功',
|
|
||||||
'data' => [
|
|
||||||
'member' => $member,
|
|
||||||
'token' => $token,
|
|
||||||
],
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 取得個人資料
|
|
||||||
*/
|
|
||||||
public function profile(Request $request): JsonResponse
|
|
||||||
{
|
|
||||||
$member = $request->user();
|
|
||||||
|
|
||||||
return response()->json([
|
|
||||||
'success' => true,
|
|
||||||
'data' => [
|
|
||||||
'member' => $member->load('socialAccounts'),
|
|
||||||
],
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新個人資料
|
|
||||||
*/
|
|
||||||
public function updateProfile(Request $request): JsonResponse
|
|
||||||
{
|
|
||||||
$member = $request->user();
|
|
||||||
|
|
||||||
$validator = Validator::make($request->all(), [
|
|
||||||
'name' => ['nullable', 'string', 'max:255'],
|
|
||||||
'birthday' => ['nullable', 'date'],
|
|
||||||
'gender' => ['nullable', 'in:male,female,other'],
|
|
||||||
'avatar' => ['nullable', 'string'],
|
|
||||||
]);
|
|
||||||
|
|
||||||
if ($validator->fails()) {
|
|
||||||
return response()->json([
|
|
||||||
'success' => false,
|
|
||||||
'message' => '驗證失敗',
|
|
||||||
'errors' => $validator->errors(),
|
|
||||||
], 422);
|
|
||||||
}
|
|
||||||
|
|
||||||
$member->update($request->only(['name', 'birthday', 'gender', 'avatar']));
|
|
||||||
|
|
||||||
return response()->json([
|
|
||||||
'success' => true,
|
|
||||||
'message' => '更新成功',
|
|
||||||
'data' => [
|
|
||||||
'member' => $member,
|
|
||||||
],
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 登出
|
|
||||||
*/
|
|
||||||
public function logout(Request $request): JsonResponse
|
|
||||||
{
|
|
||||||
$request->user()->currentAccessToken()->delete();
|
|
||||||
|
|
||||||
return response()->json([
|
|
||||||
'success' => true,
|
|
||||||
'message' => '登出成功',
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers\Api\V1;
|
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
|
||||||
use App\Traits\ApiResponse;
|
|
||||||
|
|
||||||
abstract class ApiController extends Controller
|
|
||||||
{
|
|
||||||
use ApiResponse;
|
|
||||||
}
|
|
||||||
@@ -1,39 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers\Api\V1;
|
|
||||||
|
|
||||||
use App\Jobs\Machine\ProcessMachineLog;
|
|
||||||
use App\Models\Machine\Machine;
|
|
||||||
use Illuminate\Http\JsonResponse;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
use Illuminate\Support\Facades\Validator;
|
|
||||||
|
|
||||||
class MachineController extends ApiController
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 接收機台回傳的日誌 (IoT Endpoint)
|
|
||||||
* 採用異步處理 (Queue)
|
|
||||||
*/
|
|
||||||
public function storeLog(Request $request, int $id): JsonResponse
|
|
||||||
{
|
|
||||||
$validator = Validator::make($request->all(), [
|
|
||||||
'level' => 'required|string|in:info,warning,error',
|
|
||||||
'message' => 'required|string',
|
|
||||||
'context' => 'nullable|array',
|
|
||||||
]);
|
|
||||||
|
|
||||||
if ($validator->fails()) {
|
|
||||||
return $this->errorResponse('Validation error', 422, $validator->errors());
|
|
||||||
}
|
|
||||||
|
|
||||||
// 檢查機台是否存在
|
|
||||||
if (!Machine::where('id', $id)->exists()) {
|
|
||||||
return $this->errorResponse('Machine not found', 404);
|
|
||||||
}
|
|
||||||
|
|
||||||
// 丟入隊列進行異步處理，回傳 202 Accepted
|
|
||||||
ProcessMachineLog::dispatch($id, $request->only(['level', 'message', 'context']));
|
|
||||||
|
|
||||||
return $this->successResponse([], 'Log accepted. Processing asynchronously.', 202);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers\Api\V1;
|
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
|
|
||||||
class MemberController extends Controller
|
|
||||||
{
|
|
||||||
//
|
|
||||||
}
|
|
||||||
@@ -3,7 +3,7 @@
|
|||||||
namespace App\Http\Controllers\Auth;
|
namespace App\Http\Controllers\Auth;
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
use App\Http\Controllers\Controller;
|
||||||
use App\Models\System\User;
|
use App\Models\User;
|
||||||
use App\Providers\RouteServiceProvider;
|
use App\Providers\RouteServiceProvider;
|
||||||
use Illuminate\Auth\Events\Registered;
|
use Illuminate\Auth\Events\Registered;
|
||||||
use Illuminate\Http\RedirectResponse;
|
use Illuminate\Http\RedirectResponse;
|
||||||
|
|||||||
@@ -1,25 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers;
|
|
||||||
|
|
||||||
use App\Models\Member\Member;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
use Inertia\Inertia;
|
|
||||||
use Inertia\Response;
|
|
||||||
|
|
||||||
class MemberController extends Controller
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Display a listing of the members.
|
|
||||||
*/
|
|
||||||
public function index()
|
|
||||||
{
|
|
||||||
$members = Member::query()
|
|
||||||
->latest()
|
|
||||||
->paginate(10);
|
|
||||||
|
|
||||||
return view('admin.members.index', [
|
|
||||||
'members' => $members,
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -7,7 +7,6 @@ use Illuminate\Http\RedirectResponse;
|
|||||||
use Illuminate\Http\Request;
|
use Illuminate\Http\Request;
|
||||||
use Illuminate\Support\Facades\Auth;
|
use Illuminate\Support\Facades\Auth;
|
||||||
use Illuminate\Support\Facades\Redirect;
|
use Illuminate\Support\Facades\Redirect;
|
||||||
use Illuminate\Support\Facades\Storage;
|
|
||||||
use Illuminate\View\View;
|
use Illuminate\View\View;
|
||||||
|
|
||||||
class ProfileController extends Controller
|
class ProfileController extends Controller
|
||||||
@@ -17,11 +16,8 @@ class ProfileController extends Controller
|
|||||||
*/
|
*/
|
||||||
public function edit(Request $request): View
|
public function edit(Request $request): View
|
||||||
{
|
{
|
||||||
$user = $request->user();
|
|
||||||
|
|
||||||
return view('profile.edit', [
|
return view('profile.edit', [
|
||||||
// 只取最新 10 筆登入紀錄
|
'user' => $request->user(),
|
||||||
'user' => $user->load(['loginLogs' => fn($q) => $q->latest('login_at')->limit(10)]),
|
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -30,24 +26,13 @@ class ProfileController extends Controller
|
|||||||
*/
|
*/
|
||||||
public function update(ProfileUpdateRequest $request): RedirectResponse
|
public function update(ProfileUpdateRequest $request): RedirectResponse
|
||||||
{
|
{
|
||||||
$user = $request->user();
|
$request->user()->fill($request->validated());
|
||||||
$user->fill($request->validated());
|
|
||||||
|
|
||||||
if ($user->isDirty('email')) {
|
if ($request->user()->isDirty('email')) {
|
||||||
$user->email_verified_at = null;
|
$request->user()->email_verified_at = null;
|
||||||
}
|
}
|
||||||
|
|
||||||
if ($request->hasFile('avatar')) {
|
$request->user()->save();
|
||||||
// Delete old avatar if exists
|
|
||||||
if ($user->avatar) {
|
|
||||||
Storage::disk('public')->delete($user->avatar);
|
|
||||||
}
|
|
||||||
|
|
||||||
$path = $request->file('avatar')->store('avatars', 'public');
|
|
||||||
$user->avatar = $path;
|
|
||||||
}
|
|
||||||
|
|
||||||
$user->save();
|
|
||||||
|
|
||||||
return Redirect::route('profile.edit')->with('status', 'profile-updated');
|
return Redirect::route('profile.edit')->with('status', 'profile-updated');
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,33 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers;
|
|
||||||
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
use Illuminate\Support\Facades\Http;
|
|
||||||
|
|
||||||
class SocialLoginTestController extends Controller
|
|
||||||
{
|
|
||||||
public function index()
|
|
||||||
{
|
|
||||||
return view('test.social-login');
|
|
||||||
}
|
|
||||||
|
|
||||||
public function lineCallback(Request $request)
|
|
||||||
{
|
|
||||||
// 這裡可以實作後端換發 Token 的邏輯
|
|
||||||
// 為了測試方便，我們先直接顯示回傳的 code 與 state
|
|
||||||
// 或者嘗試交換 Token 並取得 User Profile
|
|
||||||
|
|
||||||
$code = $request->input('code');
|
|
||||||
$state = $request->input('state');
|
|
||||||
$error = $request->input('error');
|
|
||||||
|
|
||||||
return view('test.social-login', [
|
|
||||||
'line_data' => [
|
|
||||||
'code' => $code,
|
|
||||||
'state' => $state,
|
|
||||||
'error' => $error
|
|
||||||
]
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,25 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Controllers\System;
|
|
||||||
|
|
||||||
use App\Http\Controllers\Controller;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
use Illuminate\Support\Facades\Session;
|
|
||||||
|
|
||||||
class LanguageController extends Controller
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Switch application language.
|
|
||||||
*
|
|
||||||
* @param string $locale
|
|
||||||
* @return \Illuminate\Http\RedirectResponse
|
|
||||||
*/
|
|
||||||
public function switch($locale)
|
|
||||||
{
|
|
||||||
if (in_array($locale, ['en', 'zh_TW', 'ja'])) {
|
|
||||||
Session::put('locale', $locale);
|
|
||||||
}
|
|
||||||
|
|
||||||
return redirect()->back();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -33,7 +33,6 @@ class Kernel extends HttpKernel
|
|||||||
\App\Http\Middleware\EncryptCookies::class,
|
\App\Http\Middleware\EncryptCookies::class,
|
||||||
\Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
|
\Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
|
||||||
\Illuminate\Session\Middleware\StartSession::class,
|
\Illuminate\Session\Middleware\StartSession::class,
|
||||||
\App\Http\Middleware\SetLocale::class,
|
|
||||||
\Illuminate\View\Middleware\ShareErrorsFromSession::class,
|
\Illuminate\View\Middleware\ShareErrorsFromSession::class,
|
||||||
\App\Http\Middleware\VerifyCsrfToken::class,
|
\App\Http\Middleware\VerifyCsrfToken::class,
|
||||||
\Illuminate\Routing\Middleware\SubstituteBindings::class,
|
\Illuminate\Routing\Middleware\SubstituteBindings::class,
|
||||||
|
|||||||
@@ -1,27 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Http\Middleware;
|
|
||||||
|
|
||||||
use Closure;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
use Symfony\Component\HttpFoundation\Response;
|
|
||||||
|
|
||||||
class SetLocale
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Handle an incoming request.
|
|
||||||
*
|
|
||||||
* @param \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response) $next
|
|
||||||
*/
|
|
||||||
public function handle(Request $request, Closure $next): Response
|
|
||||||
{
|
|
||||||
if (session()->has('locale')) {
|
|
||||||
$locale = session()->get('locale');
|
|
||||||
if (in_array($locale, ['zh_TW', 'en', 'ja'])) {
|
|
||||||
app()->setLocale($locale);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return $next($request);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -12,7 +12,7 @@ class TrustProxies extends Middleware
|
|||||||
*
|
*
|
||||||
* @var array<int, string>|string|null
|
* @var array<int, string>|string|null
|
||||||
*/
|
*/
|
||||||
protected $proxies = '*';
|
protected $proxies;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* The headers that should be used to detect proxies.
|
* The headers that should be used to detect proxies.
|
||||||
|
|||||||
@@ -27,22 +27,11 @@ class LoginRequest extends FormRequest
|
|||||||
public function rules(): array
|
public function rules(): array
|
||||||
{
|
{
|
||||||
return [
|
return [
|
||||||
'username' => ['required', 'string'],
|
'email' => ['required', 'string', 'email'],
|
||||||
'password' => ['required', 'string'],
|
'password' => ['required', 'string'],
|
||||||
];
|
];
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* 取得驗證規則的自訂錯誤訊息
|
|
||||||
*/
|
|
||||||
public function messages(): array
|
|
||||||
{
|
|
||||||
return [
|
|
||||||
'username.required' => '請輸入帳號',
|
|
||||||
'password.required' => '請輸入密碼',
|
|
||||||
];
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Attempt to authenticate the request's credentials.
|
* Attempt to authenticate the request's credentials.
|
||||||
*
|
*
|
||||||
@@ -52,11 +41,11 @@ class LoginRequest extends FormRequest
|
|||||||
{
|
{
|
||||||
$this->ensureIsNotRateLimited();
|
$this->ensureIsNotRateLimited();
|
||||||
|
|
||||||
if (! Auth::attempt($this->only('username', 'password'), $this->boolean('remember'))) {
|
if (! Auth::attempt($this->only('email', 'password'), $this->boolean('remember'))) {
|
||||||
RateLimiter::hit($this->throttleKey());
|
RateLimiter::hit($this->throttleKey());
|
||||||
|
|
||||||
throw ValidationException::withMessages([
|
throw ValidationException::withMessages([
|
||||||
'username' => trans('auth.failed'),
|
'email' => trans('auth.failed'),
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -79,7 +68,7 @@ class LoginRequest extends FormRequest
|
|||||||
$seconds = RateLimiter::availableIn($this->throttleKey());
|
$seconds = RateLimiter::availableIn($this->throttleKey());
|
||||||
|
|
||||||
throw ValidationException::withMessages([
|
throw ValidationException::withMessages([
|
||||||
'username' => trans('auth.throttle', [
|
'email' => trans('auth.throttle', [
|
||||||
'seconds' => $seconds,
|
'seconds' => $seconds,
|
||||||
'minutes' => ceil($seconds / 60),
|
'minutes' => ceil($seconds / 60),
|
||||||
]),
|
]),
|
||||||
@@ -91,6 +80,6 @@ class LoginRequest extends FormRequest
|
|||||||
*/
|
*/
|
||||||
public function throttleKey(): string
|
public function throttleKey(): string
|
||||||
{
|
{
|
||||||
return Str::transliterate(Str::lower($this->string('username')).'|'.$this->ip());
|
return Str::transliterate(Str::lower($this->string('email')).'|'.$this->ip());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
namespace App\Http\Requests;
|
namespace App\Http\Requests;
|
||||||
|
|
||||||
use App\Models\System\User;
|
use App\Models\User;
|
||||||
use Illuminate\Foundation\Http\FormRequest;
|
use Illuminate\Foundation\Http\FormRequest;
|
||||||
use Illuminate\Validation\Rule;
|
use Illuminate\Validation\Rule;
|
||||||
|
|
||||||
@@ -19,7 +19,7 @@ class ProfileUpdateRequest extends FormRequest
|
|||||||
'name' => ['required', 'string', 'max:255'],
|
'name' => ['required', 'string', 'max:255'],
|
||||||
'email' => ['required', 'string', 'lowercase', 'email', 'max:255', Rule::unique(User::class)->ignore($this->user()->id)],
|
'email' => ['required', 'string', 'lowercase', 'email', 'max:255', Rule::unique(User::class)->ignore($this->user()->id)],
|
||||||
'phone' => ['nullable', 'string', 'max:20'],
|
'phone' => ['nullable', 'string', 'max:20'],
|
||||||
'avatar' => ['nullable', 'image', 'mimes:jpeg,png,jpg,gif', 'max:2048'],
|
'avatar' => ['nullable', 'string', 'max:255'],
|
||||||
];
|
];
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,46 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Jobs\Machine;
|
|
||||||
|
|
||||||
use App\Services\Machine\MachineService;
|
|
||||||
use Illuminate\Bus\Queueable;
|
|
||||||
use Illuminate\Contracts\Queue\ShouldQueue;
|
|
||||||
use Illuminate\Foundation\Bus\Dispatchable;
|
|
||||||
use Illuminate\Queue\InteractsWithQueue;
|
|
||||||
use Illuminate\Queue\SerializesModels;
|
|
||||||
use Illuminate\Support\Facades\Log;
|
|
||||||
|
|
||||||
class ProcessMachineLog implements ShouldQueue
|
|
||||||
{
|
|
||||||
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @var int
|
|
||||||
*/
|
|
||||||
protected $machineId;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @var array
|
|
||||||
*/
|
|
||||||
protected $logData;
|
|
||||||
|
|
||||||
public function __construct(int $machineId, array $logData)
|
|
||||||
{
|
|
||||||
$this->machineId = $machineId;
|
|
||||||
$this->logData = $logData;
|
|
||||||
}
|
|
||||||
|
|
||||||
public function getMachineId(): int
|
|
||||||
{
|
|
||||||
return $this->machineId;
|
|
||||||
}
|
|
||||||
|
|
||||||
public function handle(MachineService $service): void
|
|
||||||
{
|
|
||||||
try {
|
|
||||||
$service->recordLog($this->machineId, $this->logData);
|
|
||||||
} catch (\Exception $e) {
|
|
||||||
Log::error("Failed to process machine log for machine {$this->machineId}: " . $e->getMessage());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,44 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Listeners;
|
|
||||||
|
|
||||||
use App\Models\UserLoginLog;
|
|
||||||
use Illuminate\Auth\Events\Login;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
|
|
||||||
class LogSuccessfulLogin
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* The request instance.
|
|
||||||
*
|
|
||||||
* @var \Illuminate\Http\Request
|
|
||||||
*/
|
|
||||||
protected $request;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create the event listener.
|
|
||||||
*
|
|
||||||
* @param \Illuminate\Http\Request $request
|
|
||||||
* @return void
|
|
||||||
*/
|
|
||||||
public function __construct(Request $request)
|
|
||||||
{
|
|
||||||
$this->request = $request;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle the event.
|
|
||||||
*
|
|
||||||
* @param \Illuminate\Auth\Events\Login $event
|
|
||||||
* @return void
|
|
||||||
*/
|
|
||||||
public function handle(Login $event)
|
|
||||||
{
|
|
||||||
UserLoginLog::create([
|
|
||||||
'user_id' => $event->user->id,
|
|
||||||
'ip_address' => $this->request->ip(),
|
|
||||||
'user_agent' => $this->request->userAgent(),
|
|
||||||
'login_at' => now(),
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
<?php
|
<?php
|
||||||
|
|
||||||
namespace App\Models\System;
|
namespace App\Models;
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||||
use Illuminate\Database\Eloquent\Model;
|
use Illuminate\Database\Eloquent\Model;
|
||||||
@@ -1,14 +1,12 @@
|
|||||||
<?php
|
<?php
|
||||||
|
|
||||||
namespace App\Models\Machine;
|
namespace App\Models;
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||||
use Illuminate\Database\Eloquent\Model;
|
use Illuminate\Database\Eloquent\Model;
|
||||||
|
|
||||||
class Machine extends Model
|
class Machine extends Model
|
||||||
{
|
{
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
protected $fillable = [
|
protected $fillable = [
|
||||||
'name',
|
'name',
|
||||||
'location',
|
'location',
|
||||||
@@ -1,16 +1,12 @@
|
|||||||
<?php
|
<?php
|
||||||
|
|
||||||
namespace App\Models\Machine;
|
namespace App\Models;
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||||
use Illuminate\Database\Eloquent\Model;
|
use Illuminate\Database\Eloquent\Model;
|
||||||
|
|
||||||
class MachineLog extends Model
|
class MachineLog extends Model
|
||||||
{
|
{
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
const UPDATED_AT = null;
|
|
||||||
|
|
||||||
protected $fillable = [
|
protected $fillable = [
|
||||||
'machine_id',
|
'machine_id',
|
||||||
'level',
|
'level',
|
||||||
@@ -1,60 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
|
|
||||||
class DepositBonusRule extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'name',
|
|
||||||
'min_amount',
|
|
||||||
'bonus_type',
|
|
||||||
'bonus_value',
|
|
||||||
'is_active',
|
|
||||||
'start_at',
|
|
||||||
'end_at',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'min_amount' => 'decimal:2',
|
|
||||||
'bonus_value' => 'decimal:2',
|
|
||||||
'is_active' => 'boolean',
|
|
||||||
'start_at' => 'datetime',
|
|
||||||
'end_at' => 'datetime',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 取得目前有效的規則
|
|
||||||
*/
|
|
||||||
public function scopeActive($query)
|
|
||||||
{
|
|
||||||
return $query->where('is_active', true)
|
|
||||||
->where(function ($q) {
|
|
||||||
$q->whereNull('start_at')->orWhere('start_at', '<=', now());
|
|
||||||
})
|
|
||||||
->where(function ($q) {
|
|
||||||
$q->whereNull('end_at')->orWhere('end_at', '>=', now());
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 計算回饋金額
|
|
||||||
*/
|
|
||||||
public function calculateBonus(float $depositAmount): float
|
|
||||||
{
|
|
||||||
if ($depositAmount < $this->min_amount) {
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
if ($this->bonus_type === 'fixed') {
|
|
||||||
return $this->bonus_value;
|
|
||||||
}
|
|
||||||
|
|
||||||
// percentage
|
|
||||||
return $depositAmount * ($this->bonus_value / 100);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,53 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
||||||
|
|
||||||
class GiftDefinition extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'name',
|
|
||||||
'type',
|
|
||||||
'value',
|
|
||||||
'tier_id',
|
|
||||||
'trigger',
|
|
||||||
'validity_days',
|
|
||||||
'is_active',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'value' => 'decimal:2',
|
|
||||||
'validity_days' => 'integer',
|
|
||||||
'is_active' => 'boolean',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 適用等級
|
|
||||||
*/
|
|
||||||
public function tier(): BelongsTo
|
|
||||||
{
|
|
||||||
return $this->belongsTo(MembershipTier::class, 'tier_id');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 發放紀錄
|
|
||||||
*/
|
|
||||||
public function memberGifts(): HasMany
|
|
||||||
{
|
|
||||||
return $this->hasMany(MemberGift::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 有效禮品
|
|
||||||
*/
|
|
||||||
public function scopeActive($query)
|
|
||||||
{
|
|
||||||
return $query->where('is_active', true);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,147 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Foundation\Auth\User as Authenticatable;
|
|
||||||
use Illuminate\Notifications\Notifiable;
|
|
||||||
use Laravel\Sanctum\HasApiTokens;
|
|
||||||
use Illuminate\Support\Str;
|
|
||||||
|
|
||||||
class Member extends Authenticatable
|
|
||||||
{
|
|
||||||
use HasApiTokens, HasFactory, Notifiable;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 資料表名稱
|
|
||||||
*/
|
|
||||||
protected $table = 'members';
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 可批量賦值的屬性
|
|
||||||
*/
|
|
||||||
protected $fillable = [
|
|
||||||
'uuid',
|
|
||||||
'name',
|
|
||||||
'email',
|
|
||||||
'phone',
|
|
||||||
'password',
|
|
||||||
'birthday',
|
|
||||||
'gender',
|
|
||||||
'avatar',
|
|
||||||
'is_active',
|
|
||||||
'email_verified_at',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 隱藏的屬性
|
|
||||||
*/
|
|
||||||
protected $hidden = [
|
|
||||||
'password',
|
|
||||||
'remember_token',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 屬性轉換
|
|
||||||
*/
|
|
||||||
protected $casts = [
|
|
||||||
'email_verified_at' => 'datetime',
|
|
||||||
'birthday' => 'date',
|
|
||||||
'is_active' => 'boolean',
|
|
||||||
'password' => 'hashed',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 建立時自動產生 UUID
|
|
||||||
*/
|
|
||||||
protected static function boot()
|
|
||||||
{
|
|
||||||
parent::boot();
|
|
||||||
|
|
||||||
static::creating(function ($model) {
|
|
||||||
if (empty($model->uuid)) {
|
|
||||||
$model->uuid = (string) Str::uuid();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 關聯：社群帳號
|
|
||||||
*/
|
|
||||||
public function socialAccounts()
|
|
||||||
{
|
|
||||||
return $this->hasMany(SocialAccount::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 關聯：錢包
|
|
||||||
*/
|
|
||||||
public function wallet()
|
|
||||||
{
|
|
||||||
return $this->hasOne(MemberWallet::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 關聯：點數帳戶
|
|
||||||
*/
|
|
||||||
public function points()
|
|
||||||
{
|
|
||||||
return $this->hasOne(MemberPoint::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 關聯：會員資格紀錄
|
|
||||||
*/
|
|
||||||
public function memberships()
|
|
||||||
{
|
|
||||||
return $this->hasMany(MemberMembership::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 關聯：禮品紀錄
|
|
||||||
*/
|
|
||||||
public function gifts()
|
|
||||||
{
|
|
||||||
return $this->hasMany(MemberGift::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 取得目前有效的會員資格
|
|
||||||
*/
|
|
||||||
public function activeMembership()
|
|
||||||
{
|
|
||||||
return $this->hasOne(MemberMembership::class)->active()->latest('starts_at');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 檢查是否已綁定指定社群
|
|
||||||
*/
|
|
||||||
public function hasSocialAccount(string $provider): bool
|
|
||||||
{
|
|
||||||
return $this->socialAccounts()->where('provider', $provider)->exists();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 取得或建立錢包
|
|
||||||
*/
|
|
||||||
public function getOrCreateWallet(): MemberWallet
|
|
||||||
{
|
|
||||||
return $this->wallet ?? $this->wallet()->create([
|
|
||||||
'balance' => 0,
|
|
||||||
'bonus_balance' => 0,
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 取得或建立點數帳戶
|
|
||||||
*/
|
|
||||||
public function getOrCreatePoints(): MemberPoint
|
|
||||||
{
|
|
||||||
return $this->points ?? $this->points()->create([
|
|
||||||
'available_points' => 0,
|
|
||||||
'pending_points' => 0,
|
|
||||||
'expired_points' => 0,
|
|
||||||
'used_points' => 0,
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,56 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
||||||
|
|
||||||
class MemberGift extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
public $timestamps = false;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'member_id',
|
|
||||||
'gift_definition_id',
|
|
||||||
'status',
|
|
||||||
'claimed_at',
|
|
||||||
'expires_at',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'claimed_at' => 'datetime',
|
|
||||||
'expires_at' => 'datetime',
|
|
||||||
'created_at' => 'datetime',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 所屬會員
|
|
||||||
*/
|
|
||||||
public function member(): BelongsTo
|
|
||||||
{
|
|
||||||
return $this->belongsTo(Member::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 禮品定義
|
|
||||||
*/
|
|
||||||
public function giftDefinition(): BelongsTo
|
|
||||||
{
|
|
||||||
return $this->belongsTo(GiftDefinition::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 待領取的禮品
|
|
||||||
*/
|
|
||||||
public function scopePending($query)
|
|
||||||
{
|
|
||||||
return $query->where('status', 'pending')
|
|
||||||
->where(function ($q) {
|
|
||||||
$q->whereNull('expires_at')
|
|
||||||
->orWhere('expires_at', '>', now());
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,65 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
||||||
|
|
||||||
class MemberMembership extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'member_id',
|
|
||||||
'tier_id',
|
|
||||||
'starts_at',
|
|
||||||
'expires_at',
|
|
||||||
'payment_id',
|
|
||||||
'auto_renew',
|
|
||||||
'status',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'starts_at' => 'datetime',
|
|
||||||
'expires_at' => 'datetime',
|
|
||||||
'auto_renew' => 'boolean',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 所屬會員
|
|
||||||
*/
|
|
||||||
public function member(): BelongsTo
|
|
||||||
{
|
|
||||||
return $this->belongsTo(Member::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 會員等級
|
|
||||||
*/
|
|
||||||
public function tier(): BelongsTo
|
|
||||||
{
|
|
||||||
return $this->belongsTo(MembershipTier::class, 'tier_id');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 是否有效
|
|
||||||
*/
|
|
||||||
public function getIsActiveAttribute(): bool
|
|
||||||
{
|
|
||||||
return $this->status === 'active'
|
|
||||||
&& (!$this->expires_at || $this->expires_at->isFuture());
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 有效會員資格
|
|
||||||
*/
|
|
||||||
public function scopeActive($query)
|
|
||||||
{
|
|
||||||
return $query->where('status', 'active')
|
|
||||||
->where(function ($q) {
|
|
||||||
$q->whereNull('expires_at')
|
|
||||||
->orWhere('expires_at', '>', now());
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,44 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
||||||
|
|
||||||
class MemberPoint extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'member_id',
|
|
||||||
'available_points',
|
|
||||||
'pending_points',
|
|
||||||
'expired_points',
|
|
||||||
'used_points',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'available_points' => 'integer',
|
|
||||||
'pending_points' => 'integer',
|
|
||||||
'expired_points' => 'integer',
|
|
||||||
'used_points' => 'integer',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 所屬會員
|
|
||||||
*/
|
|
||||||
public function member(): BelongsTo
|
|
||||||
{
|
|
||||||
return $this->belongsTo(Member::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 點數異動紀錄
|
|
||||||
*/
|
|
||||||
public function transactions(): HasMany
|
|
||||||
{
|
|
||||||
return $this->hasMany(PointTransaction::class, 'member_id', 'member_id');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,48 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
||||||
|
|
||||||
class MemberWallet extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'member_id',
|
|
||||||
'balance',
|
|
||||||
'bonus_balance',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'balance' => 'decimal:2',
|
|
||||||
'bonus_balance' => 'decimal:2',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 所屬會員
|
|
||||||
*/
|
|
||||||
public function member(): BelongsTo
|
|
||||||
{
|
|
||||||
return $this->belongsTo(Member::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 交易紀錄
|
|
||||||
*/
|
|
||||||
public function transactions(): HasMany
|
|
||||||
{
|
|
||||||
return $this->hasMany(WalletTransaction::class, 'member_id', 'member_id');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 總餘額 (儲值 + 回饋)
|
|
||||||
*/
|
|
||||||
public function getTotalBalanceAttribute(): float
|
|
||||||
{
|
|
||||||
return $this->balance + $this->bonus_balance;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,62 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
||||||
|
|
||||||
class MembershipTier extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'name',
|
|
||||||
'annual_fee',
|
|
||||||
'discount_rate',
|
|
||||||
'point_multiplier',
|
|
||||||
'description',
|
|
||||||
'is_default',
|
|
||||||
'sort_order',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'annual_fee' => 'decimal:2',
|
|
||||||
'discount_rate' => 'decimal:2',
|
|
||||||
'point_multiplier' => 'decimal:2',
|
|
||||||
'is_default' => 'boolean',
|
|
||||||
'sort_order' => 'integer',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 此等級的會員紀錄
|
|
||||||
*/
|
|
||||||
public function memberships(): HasMany
|
|
||||||
{
|
|
||||||
return $this->hasMany(MemberMembership::class, 'tier_id');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 此等級的禮品定義
|
|
||||||
*/
|
|
||||||
public function giftDefinitions(): HasMany
|
|
||||||
{
|
|
||||||
return $this->hasMany(GiftDefinition::class, 'tier_id');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 取得預設等級
|
|
||||||
*/
|
|
||||||
public static function getDefault(): ?self
|
|
||||||
{
|
|
||||||
return static::where('is_default', true)->first();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 是否為免費等級
|
|
||||||
*/
|
|
||||||
public function getIsFreeAttribute(): bool
|
|
||||||
{
|
|
||||||
return $this->annual_fee <= 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,47 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
|
|
||||||
class PointRule extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'name',
|
|
||||||
'trigger',
|
|
||||||
'points_per_unit',
|
|
||||||
'unit_amount',
|
|
||||||
'validity_days',
|
|
||||||
'is_active',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'points_per_unit' => 'integer',
|
|
||||||
'unit_amount' => 'decimal:2',
|
|
||||||
'validity_days' => 'integer',
|
|
||||||
'is_active' => 'boolean',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 取得有效規則
|
|
||||||
*/
|
|
||||||
public function scopeActive($query)
|
|
||||||
{
|
|
||||||
return $query->where('is_active', true);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根據金額計算可獲得點數
|
|
||||||
*/
|
|
||||||
public function calculatePoints(float $amount): int
|
|
||||||
{
|
|
||||||
if ($this->unit_amount <= 0) {
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
return (int) floor($amount / $this->unit_amount) * $this->points_per_unit;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,48 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
||||||
|
|
||||||
class PointTransaction extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
public $timestamps = false;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'member_id',
|
|
||||||
'type',
|
|
||||||
'points',
|
|
||||||
'balance_after',
|
|
||||||
'description',
|
|
||||||
'expires_at',
|
|
||||||
'reference_type',
|
|
||||||
'reference_id',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'points' => 'integer',
|
|
||||||
'balance_after' => 'integer',
|
|
||||||
'expires_at' => 'datetime',
|
|
||||||
'created_at' => 'datetime',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 所屬會員
|
|
||||||
*/
|
|
||||||
public function member(): BelongsTo
|
|
||||||
{
|
|
||||||
return $this->belongsTo(Member::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 是否已過期
|
|
||||||
*/
|
|
||||||
public function getIsExpiredAttribute(): bool
|
|
||||||
{
|
|
||||||
return $this->expires_at && $this->expires_at->isPast();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,53 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
|
|
||||||
class SocialAccount extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 資料表名稱
|
|
||||||
*/
|
|
||||||
protected $table = 'social_accounts';
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 可批量賦值的屬性
|
|
||||||
*/
|
|
||||||
protected $fillable = [
|
|
||||||
'member_id',
|
|
||||||
'provider',
|
|
||||||
'provider_id',
|
|
||||||
'access_token',
|
|
||||||
'refresh_token',
|
|
||||||
'profile_data',
|
|
||||||
'token_expires_at',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 屬性轉換
|
|
||||||
*/
|
|
||||||
protected $casts = [
|
|
||||||
'profile_data' => 'array',
|
|
||||||
'token_expires_at' => 'datetime',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 隱藏的屬性
|
|
||||||
*/
|
|
||||||
protected $hidden = [
|
|
||||||
'access_token',
|
|
||||||
'refresh_token',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 關聯：會員
|
|
||||||
*/
|
|
||||||
public function member()
|
|
||||||
{
|
|
||||||
return $this->belongsTo(Member::class);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,38 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models\Member;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
||||||
|
|
||||||
class WalletTransaction extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
public $timestamps = false;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'member_id',
|
|
||||||
'type',
|
|
||||||
'amount',
|
|
||||||
'balance_after',
|
|
||||||
'description',
|
|
||||||
'reference_type',
|
|
||||||
'reference_id',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'amount' => 'decimal:2',
|
|
||||||
'balance_after' => 'decimal:2',
|
|
||||||
'created_at' => 'datetime',
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 所屬會員
|
|
||||||
*/
|
|
||||||
public function member(): BelongsTo
|
|
||||||
{
|
|
||||||
return $this->belongsTo(Member::class);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
<?php
|
<?php
|
||||||
|
|
||||||
namespace App\Models\System;
|
namespace App\Models;
|
||||||
|
|
||||||
// use Illuminate\Contracts\Auth\MustVerifyEmail;
|
// use Illuminate\Contracts\Auth\MustVerifyEmail;
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||||
@@ -18,7 +18,6 @@ class User extends Authenticatable
|
|||||||
* @var array<int, string>
|
* @var array<int, string>
|
||||||
*/
|
*/
|
||||||
protected $fillable = [
|
protected $fillable = [
|
||||||
'username',
|
|
||||||
'name',
|
'name',
|
||||||
'email',
|
'email',
|
||||||
'password',
|
'password',
|
||||||
@@ -46,24 +45,4 @@ class User extends Authenticatable
|
|||||||
'email_verified_at' => 'datetime',
|
'email_verified_at' => 'datetime',
|
||||||
'password' => 'hashed',
|
'password' => 'hashed',
|
||||||
];
|
];
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the login logs for the user.
|
|
||||||
*/
|
|
||||||
public function loginLogs()
|
|
||||||
{
|
|
||||||
return $this->hasMany(\App\Models\UserLoginLog::class);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the user's avatar URL.
|
|
||||||
*/
|
|
||||||
public function getAvatarUrlAttribute(): string
|
|
||||||
{
|
|
||||||
if ($this->avatar) {
|
|
||||||
return asset('storage/' . $this->avatar);
|
|
||||||
}
|
|
||||||
|
|
||||||
return "https://ui-avatars.com/api/?name=" . urlencode($this->name) . "&background=0D8ABC&color=fff";
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
@@ -1,27 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Models;
|
|
||||||
|
|
||||||
use Illuminate\Database\Eloquent\Model;
|
|
||||||
use Illuminate\Database\Eloquent\Factories\HasFactory; // Added this line
|
|
||||||
|
|
||||||
class UserLoginLog extends Model
|
|
||||||
{
|
|
||||||
use HasFactory;
|
|
||||||
|
|
||||||
protected $fillable = [
|
|
||||||
'user_id',
|
|
||||||
'ip_address',
|
|
||||||
'user_agent',
|
|
||||||
'login_at',
|
|
||||||
];
|
|
||||||
|
|
||||||
protected $casts = [
|
|
||||||
'login_at' => 'datetime',
|
|
||||||
];
|
|
||||||
|
|
||||||
public function user()
|
|
||||||
{
|
|
||||||
return $this->belongsTo(User::class);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -2,9 +2,6 @@
|
|||||||
|
|
||||||
namespace App\Providers;
|
namespace App\Providers;
|
||||||
|
|
||||||
use App\Listeners\LogSuccessfulLogin;
|
|
||||||
use Illuminate\Auth\Events\Login;
|
|
||||||
use Illuminate\Support\Facades\Event;
|
|
||||||
use Illuminate\Support\ServiceProvider;
|
use Illuminate\Support\ServiceProvider;
|
||||||
|
|
||||||
class AppServiceProvider extends ServiceProvider
|
class AppServiceProvider extends ServiceProvider
|
||||||
@@ -22,12 +19,6 @@ class AppServiceProvider extends ServiceProvider
|
|||||||
*/
|
*/
|
||||||
public function boot(): void
|
public function boot(): void
|
||||||
{
|
{
|
||||||
if (!$this->app->isLocal()) {
|
//
|
||||||
\Illuminate\Support\Facades\URL::forceScheme('https');
|
|
||||||
}
|
|
||||||
|
|
||||||
// 記錄使用者成功登入的歷史
|
|
||||||
Event::listen(Login::class, LogSuccessfulLogin::class);
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -2,8 +2,6 @@
|
|||||||
|
|
||||||
namespace App\Providers;
|
namespace App\Providers;
|
||||||
|
|
||||||
use App\Listeners\LogSuccessfulLogin;
|
|
||||||
use Illuminate\Auth\Events\Login;
|
|
||||||
use Illuminate\Auth\Events\Registered;
|
use Illuminate\Auth\Events\Registered;
|
||||||
use Illuminate\Auth\Listeners\SendEmailVerificationNotification;
|
use Illuminate\Auth\Listeners\SendEmailVerificationNotification;
|
||||||
use Illuminate\Foundation\Support\Providers\EventServiceProvider as ServiceProvider;
|
use Illuminate\Foundation\Support\Providers\EventServiceProvider as ServiceProvider;
|
||||||
@@ -20,9 +18,6 @@ class EventServiceProvider extends ServiceProvider
|
|||||||
Registered::class => [
|
Registered::class => [
|
||||||
SendEmailVerificationNotification::class,
|
SendEmailVerificationNotification::class,
|
||||||
],
|
],
|
||||||
Login::class => [
|
|
||||||
LogSuccessfulLogin::class,
|
|
||||||
],
|
|
||||||
];
|
];
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -1,45 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Services\Machine;
|
|
||||||
|
|
||||||
use App\Models\Machine\Machine;
|
|
||||||
use App\Models\Machine\MachineLog;
|
|
||||||
use Illuminate\Support\Facades\Log;
|
|
||||||
|
|
||||||
class MachineService
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 處理機台日誌寫入與狀態更新
|
|
||||||
*/
|
|
||||||
public function recordLog(int $machineId, array $data): MachineLog
|
|
||||||
{
|
|
||||||
$machine = Machine::findOrFail($machineId);
|
|
||||||
|
|
||||||
// 建立日誌紀錄
|
|
||||||
$log = $machine->logs()->create([
|
|
||||||
'level' => $data['level'] ?? 'info',
|
|
||||||
'message' => $data['message'],
|
|
||||||
'context' => $data['context'] ?? null,
|
|
||||||
]);
|
|
||||||
|
|
||||||
// 同步更新機台最後活耀時間與狀態
|
|
||||||
$machine->update([
|
|
||||||
'last_heartbeat_at' => now(),
|
|
||||||
'status' => $this->resolveStatus($data),
|
|
||||||
]);
|
|
||||||
|
|
||||||
return $log;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根據日誌內容判斷機台是否應標記成錯誤
|
|
||||||
*/
|
|
||||||
protected function resolveStatus(array $data): string
|
|
||||||
{
|
|
||||||
if (isset($data['level']) && $data['level'] === 'error') {
|
|
||||||
return 'error';
|
|
||||||
}
|
|
||||||
|
|
||||||
return 'online';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,49 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace App\Traits;
|
|
||||||
|
|
||||||
use Illuminate\Http\JsonResponse;
|
|
||||||
|
|
||||||
trait ApiResponse
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 回傳成功的回應
|
|
||||||
*
|
|
||||||
* @param mixed $data
|
|
||||||
* @param string $message
|
|
||||||
* @param int $code
|
|
||||||
* @return JsonResponse
|
|
||||||
*/
|
|
||||||
public function successResponse($data = [], string $message = 'OK', int $code = 200): JsonResponse
|
|
||||||
{
|
|
||||||
return response()->json([
|
|
||||||
'success' => true,
|
|
||||||
'code' => $code,
|
|
||||||
'message' => $message,
|
|
||||||
'data' => empty($data) ? new \stdClass() : $data, // 確保前端收到的是 Object 而非 Empty Array
|
|
||||||
], $code);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 回傳錯誤的回應
|
|
||||||
*
|
|
||||||
* @param string $message
|
|
||||||
* @param int $code
|
|
||||||
* @param mixed $errors
|
|
||||||
* @return JsonResponse
|
|
||||||
*/
|
|
||||||
public function errorResponse(string $message, int $code = 400, $errors = null): JsonResponse
|
|
||||||
{
|
|
||||||
$response = [
|
|
||||||
'success' => false,
|
|
||||||
'code' => $code,
|
|
||||||
'message' => $message,
|
|
||||||
];
|
|
||||||
|
|
||||||
if (!is_null($errors)) {
|
|
||||||
$response['errors'] = $errors;
|
|
||||||
}
|
|
||||||
|
|
||||||
return response()->json($response, $code);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
49
artisan
49
artisan
@@ -1,18 +1,53 @@
|
|||||||
#!/usr/bin/env php
|
#!/usr/bin/env php
|
||||||
<?php
|
<?php
|
||||||
|
|
||||||
use Illuminate\Foundation\Application;
|
|
||||||
use Symfony\Component\Console\Input\ArgvInput;
|
|
||||||
|
|
||||||
define('LARAVEL_START', microtime(true));
|
define('LARAVEL_START', microtime(true));
|
||||||
|
|
||||||
// Register the Composer autoloader...
|
/*
|
||||||
|
|--------------------------------------------------------------------------
|
||||||
|
| Register The Auto Loader
|
||||||
|
|--------------------------------------------------------------------------
|
||||||
|
|
|
||||||
|
| Composer provides a convenient, automatically generated class loader
|
||||||
|
| for our application. We just need to utilize it! We'll require it
|
||||||
|
| into the script here so that we do not have to worry about the
|
||||||
|
| loading of any of our classes manually. It's great to relax.
|
||||||
|
|
|
||||||
|
*/
|
||||||
|
|
||||||
require __DIR__.'/vendor/autoload.php';
|
require __DIR__.'/vendor/autoload.php';
|
||||||
|
|
||||||
// Bootstrap Laravel and handle the command...
|
|
||||||
/** @var Application $app */
|
|
||||||
$app = require_once __DIR__.'/bootstrap/app.php';
|
$app = require_once __DIR__.'/bootstrap/app.php';
|
||||||
|
|
||||||
$status = $app->handleCommand(new ArgvInput);
|
/*
|
||||||
|
|--------------------------------------------------------------------------
|
||||||
|
| Run The Artisan Application
|
||||||
|
|--------------------------------------------------------------------------
|
||||||
|
|
|
||||||
|
| When we run the console application, the current CLI command will be
|
||||||
|
| executed in this console and the response sent back to a terminal
|
||||||
|
| or another output device for the developers. Here goes nothing!
|
||||||
|
|
|
||||||
|
*/
|
||||||
|
|
||||||
|
$kernel = $app->make(Illuminate\Contracts\Console\Kernel::class);
|
||||||
|
|
||||||
|
$status = $kernel->handle(
|
||||||
|
$input = new Symfony\Component\Console\Input\ArgvInput,
|
||||||
|
new Symfony\Component\Console\Output\ConsoleOutput
|
||||||
|
);
|
||||||
|
|
||||||
|
/*
|
||||||
|
|--------------------------------------------------------------------------
|
||||||
|
| Shutdown The Application
|
||||||
|
|--------------------------------------------------------------------------
|
||||||
|
|
|
||||||
|
| Once Artisan has finished running, we will fire off the shutdown events
|
||||||
|
| so that any final work may be done by the application before we shut
|
||||||
|
| down the process. This is the last thing to happen to the request.
|
||||||
|
|
|
||||||
|
*/
|
||||||
|
|
||||||
|
$kernel->terminate($input, $status);
|
||||||
|
|
||||||
exit($status);
|
exit($status);
|
||||||
|
|||||||
14
compose.yaml
14
compose.yaml
@@ -6,12 +6,12 @@ services:
|
|||||||
args:
|
args:
|
||||||
WWWGROUP: '${WWWGROUP}'
|
WWWGROUP: '${WWWGROUP}'
|
||||||
image: 'sail-8.5/app'
|
image: 'sail-8.5/app'
|
||||||
container_name: star-cloud-laravel
|
container_name: start-cloud-laravel
|
||||||
hostname: star-cloud-laravel
|
hostname: start-cloud-laravel
|
||||||
extra_hosts:
|
extra_hosts:
|
||||||
- 'host.docker.internal:host-gateway'
|
- 'host.docker.internal:host-gateway'
|
||||||
ports:
|
ports:
|
||||||
- '${APP_PORT:-80}:8080'
|
- '${APP_PORT:-80}:80'
|
||||||
- '${VITE_PORT:-5173}:${VITE_PORT:-5173}'
|
- '${VITE_PORT:-5173}:${VITE_PORT:-5173}'
|
||||||
environment:
|
environment:
|
||||||
WWWUSER: '${WWWUSER}'
|
WWWUSER: '${WWWUSER}'
|
||||||
@@ -29,8 +29,8 @@ services:
|
|||||||
|
|
||||||
mysql:
|
mysql:
|
||||||
image: 'mysql/mysql-server:8.0'
|
image: 'mysql/mysql-server:8.0'
|
||||||
container_name: star-cloud-mysql
|
container_name: start-cloud-mysql
|
||||||
hostname: star-cloud-mysql
|
hostname: start-cloud-mysql
|
||||||
ports:
|
ports:
|
||||||
- '${FORWARD_DB_PORT:-3306}:3306'
|
- '${FORWARD_DB_PORT:-3306}:3306'
|
||||||
environment:
|
environment:
|
||||||
@@ -56,8 +56,8 @@ services:
|
|||||||
timeout: 5s
|
timeout: 5s
|
||||||
redis:
|
redis:
|
||||||
image: 'redis:alpine'
|
image: 'redis:alpine'
|
||||||
container_name: star-cloud-redis
|
container_name: start-cloud-redis
|
||||||
hostname: star-cloud-redis
|
hostname: start-cloud-redis
|
||||||
ports:
|
ports:
|
||||||
- '${FORWARD_REDIS_PORT:-6379}:6379'
|
- '${FORWARD_REDIS_PORT:-6379}:6379'
|
||||||
volumes:
|
volumes:
|
||||||
|
|||||||
@@ -2,27 +2,24 @@
|
|||||||
"name": "laravel/laravel",
|
"name": "laravel/laravel",
|
||||||
"type": "project",
|
"type": "project",
|
||||||
"description": "The skeleton application for the Laravel framework.",
|
"description": "The skeleton application for the Laravel framework.",
|
||||||
"keywords": [
|
"keywords": ["laravel", "framework"],
|
||||||
"laravel",
|
|
||||||
"framework"
|
|
||||||
],
|
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"require": {
|
"require": {
|
||||||
"php": "^8.2",
|
"php": "^8.1",
|
||||||
"guzzlehttp/guzzle": "^7.8",
|
"guzzlehttp/guzzle": "^7.2",
|
||||||
"laravel/framework": "^12.0",
|
"laravel/framework": "^10.10",
|
||||||
"laravel/sanctum": "^4.3",
|
"laravel/sanctum": "^3.3",
|
||||||
"laravel/tinker": "^2.10.1"
|
"laravel/tinker": "^2.8"
|
||||||
},
|
},
|
||||||
"require-dev": {
|
"require-dev": {
|
||||||
"fakerphp/faker": "^1.23",
|
"fakerphp/faker": "^1.9.1",
|
||||||
"laravel/breeze": "^2.0",
|
"laravel/breeze": "^1.29",
|
||||||
"laravel/pail": "^1.2.2",
|
"laravel/pint": "^1.0",
|
||||||
"laravel/pint": "^1.24",
|
"laravel/sail": "^1.18",
|
||||||
"laravel/sail": "^1.41",
|
"mockery/mockery": "^1.4.4",
|
||||||
"mockery/mockery": "^1.6",
|
"nunomaduro/collision": "^7.0",
|
||||||
"nunomaduro/collision": "^8.6",
|
"phpunit/phpunit": "^10.1",
|
||||||
"phpunit/phpunit": "^11.5.3"
|
"spatie/laravel-ignition": "^2.0"
|
||||||
},
|
},
|
||||||
"autoload": {
|
"autoload": {
|
||||||
"psr-4": {
|
"psr-4": {
|
||||||
|
|||||||
2623
composer.lock
generated
2623
composer.lock
generated
File diff suppressed because it is too large
Load Diff
@@ -83,7 +83,7 @@ return [
|
|||||||
|
|
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
'locale' => 'zh_TW',
|
'locale' => 'en',
|
||||||
|
|
||||||
/*
|
/*
|
||||||
|--------------------------------------------------------------------------
|
|--------------------------------------------------------------------------
|
||||||
|
|||||||
@@ -62,7 +62,7 @@ return [
|
|||||||
'providers' => [
|
'providers' => [
|
||||||
'users' => [
|
'users' => [
|
||||||
'driver' => 'eloquent',
|
'driver' => 'eloquent',
|
||||||
'model' => App\Models\System\User::class,
|
'model' => App\Models\User::class,
|
||||||
],
|
],
|
||||||
|
|
||||||
// 'users' => [
|
// 'users' => [
|
||||||
|
|||||||
@@ -1,23 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace Database\Factories\Machine;
|
|
||||||
|
|
||||||
use App\Models\Machine\Machine;
|
|
||||||
use Illuminate\Database\Eloquent\Factories\Factory;
|
|
||||||
|
|
||||||
class MachineFactory extends Factory
|
|
||||||
{
|
|
||||||
protected $model = Machine::class;
|
|
||||||
|
|
||||||
public function definition(): array
|
|
||||||
{
|
|
||||||
return [
|
|
||||||
'name' => 'Machine-' . fake()->unique()->numberBetween(101, 999),
|
|
||||||
'location' => fake()->address(),
|
|
||||||
'status' => fake()->randomElement(['online', 'offline', 'error']),
|
|
||||||
'temperature' => fake()->randomFloat(2, 2, 10),
|
|
||||||
'firmware_version' => 'v' . fake()->randomElement(['1.0.0', '1.1.2', '2.0.1']),
|
|
||||||
'last_heartbeat_at' => fake()->dateTimeBetween('-1 day', 'now'),
|
|
||||||
];
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,51 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace Database\Factories\Machine;
|
|
||||||
|
|
||||||
use App\Models\Machine\Machine;
|
|
||||||
use App\Models\Machine\MachineLog;
|
|
||||||
use Illuminate\Database\Eloquent\Factories\Factory;
|
|
||||||
|
|
||||||
class MachineLogFactory extends Factory
|
|
||||||
{
|
|
||||||
protected $model = MachineLog::class;
|
|
||||||
|
|
||||||
public function definition(): array
|
|
||||||
{
|
|
||||||
$messages = [
|
|
||||||
'info' => [
|
|
||||||
'機台啟動完成',
|
|
||||||
'系統心跳上報',
|
|
||||||
'交易成功 (訂單 #'.fake()->numberBetween(1000, 9999).')',
|
|
||||||
'補貨作業完成',
|
|
||||||
'環境溫度穩定 (24C)',
|
|
||||||
],
|
|
||||||
'warning' => [
|
|
||||||
'貨道 A3 庫存偏低',
|
|
||||||
'通訊品質不穩定',
|
|
||||||
'感測器回報數值異常',
|
|
||||||
'機門開啟次數過多',
|
|
||||||
],
|
|
||||||
'error' => [
|
|
||||||
'馬達轉動失效 (貨道 B2)',
|
|
||||||
'硬幣器卡幣',
|
|
||||||
'散熱風扇停止運作',
|
|
||||||
'電源供應模組故障',
|
|
||||||
'網路連線中斷',
|
|
||||||
]
|
|
||||||
];
|
|
||||||
|
|
||||||
$level = fake()->randomElement(['info', 'warning', 'error']);
|
|
||||||
|
|
||||||
return [
|
|
||||||
'machine_id' => Machine::factory(),
|
|
||||||
'level' => $level,
|
|
||||||
'message' => fake()->randomElement($messages[$level]),
|
|
||||||
'context' => [
|
|
||||||
'ip' => fake()->ipv4(),
|
|
||||||
'uptime' => fake()->numberBetween(1000, 100000),
|
|
||||||
],
|
|
||||||
'created_at' => fake()->dateTimeBetween('-1 day', 'now'),
|
|
||||||
];
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,27 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace Database\Factories\Member;
|
|
||||||
|
|
||||||
use App\Models\Member\Member;
|
|
||||||
use Illuminate\Database\Eloquent\Factories\Factory;
|
|
||||||
use Illuminate\Support\Str;
|
|
||||||
|
|
||||||
class MemberFactory extends Factory
|
|
||||||
{
|
|
||||||
protected $model = Member::class;
|
|
||||||
|
|
||||||
public function definition(): array
|
|
||||||
{
|
|
||||||
return [
|
|
||||||
'uuid' => (string) Str::uuid(),
|
|
||||||
'name' => fake()->name(),
|
|
||||||
'email' => fake()->unique()->safeEmail(),
|
|
||||||
'phone' => '09' . fake()->numberBetween(10000000, 99999999),
|
|
||||||
'password' => '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi', // password
|
|
||||||
'birthday' => fake()->date(),
|
|
||||||
'gender' => fake()->randomElement(['male', 'female', 'other']),
|
|
||||||
'is_active' => true,
|
|
||||||
'email_verified_at' => now(),
|
|
||||||
];
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -7,7 +7,7 @@ use Illuminate\Support\Facades\Hash;
|
|||||||
use Illuminate\Support\Str;
|
use Illuminate\Support\Str;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\System\User>
|
* @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\User>
|
||||||
*/
|
*/
|
||||||
class UserFactory extends Factory
|
class UserFactory extends Factory
|
||||||
{
|
{
|
||||||
|
|||||||
@@ -1,31 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Run the migrations.
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('sessions', function (Blueprint $table) {
|
|
||||||
$table->string('id')->primary();
|
|
||||||
$table->foreignId('user_id')->nullable()->index();
|
|
||||||
$table->string('ip_address', 45)->nullable();
|
|
||||||
$table->text('user_agent')->nullable();
|
|
||||||
$table->longText('payload');
|
|
||||||
$table->integer('last_activity')->index();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Reverse the migrations.
|
|
||||||
*/
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('sessions');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,32 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Run the migrations.
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
if (!Schema::hasColumn('users', 'username')) {
|
|
||||||
Schema::table('users', function (Blueprint $table) {
|
|
||||||
$table->string('username')->unique()->nullable()->after('id');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Reverse the migrations.
|
|
||||||
*/
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
if (Schema::hasColumn('users', 'username')) {
|
|
||||||
Schema::table('users', function (Blueprint $table) {
|
|
||||||
$table->dropColumn('username');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,38 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Run the migrations.
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('members', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->uuid('uuid')->unique();
|
|
||||||
$table->string('name');
|
|
||||||
$table->string('email')->nullable()->unique();
|
|
||||||
$table->string('phone')->nullable()->unique();
|
|
||||||
$table->string('password')->nullable();
|
|
||||||
$table->date('birthday')->nullable();
|
|
||||||
$table->enum('gender', ['male', 'female', 'other'])->nullable();
|
|
||||||
$table->string('avatar')->nullable();
|
|
||||||
$table->boolean('is_active')->default(true);
|
|
||||||
$table->timestamp('email_verified_at')->nullable();
|
|
||||||
$table->rememberToken();
|
|
||||||
$table->timestamps();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Reverse the migrations.
|
|
||||||
*/
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('members');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,37 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Run the migrations.
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('social_accounts', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->foreignId('member_id')->constrained('members')->onDelete('cascade');
|
|
||||||
$table->enum('provider', ['line', 'google', 'facebook']);
|
|
||||||
$table->string('provider_id');
|
|
||||||
$table->text('access_token')->nullable();
|
|
||||||
$table->text('refresh_token')->nullable();
|
|
||||||
$table->json('profile_data')->nullable();
|
|
||||||
$table->timestamp('token_expires_at')->nullable();
|
|
||||||
$table->timestamps();
|
|
||||||
|
|
||||||
// 同一平台同一用戶只能綁定一次
|
|
||||||
$table->unique(['provider', 'provider_id']);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Reverse the migrations.
|
|
||||||
*/
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('social_accounts');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,29 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 會員錢包
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('member_wallets', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->foreignId('member_id')->constrained('members')->onDelete('cascade');
|
|
||||||
$table->decimal('balance', 12, 2)->default(0)->comment('錢包餘額');
|
|
||||||
$table->decimal('bonus_balance', 12, 2)->default(0)->comment('回饋金餘額');
|
|
||||||
$table->timestamps();
|
|
||||||
|
|
||||||
$table->unique('member_id');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('member_wallets');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,34 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 錢包交易紀錄
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('wallet_transactions', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->foreignId('member_id')->constrained('members')->onDelete('cascade');
|
|
||||||
$table->enum('type', ['deposit', 'consume', 'refund', 'bonus', 'adjust'])->comment('交易類型');
|
|
||||||
$table->decimal('amount', 12, 2)->comment('異動金額');
|
|
||||||
$table->decimal('balance_after', 12, 2)->comment('異動後餘額');
|
|
||||||
$table->string('description')->nullable()->comment('說明');
|
|
||||||
$table->string('reference_type')->nullable()->comment('關聯類型');
|
|
||||||
$table->unsignedBigInteger('reference_id')->nullable()->comment('關聯ID');
|
|
||||||
$table->timestamp('created_at')->useCurrent();
|
|
||||||
|
|
||||||
$table->index(['member_id', 'created_at']);
|
|
||||||
$table->index(['reference_type', 'reference_id']);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('wallet_transactions');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 儲值回饋規則
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('deposit_bonus_rules', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->string('name')->comment('規則名稱');
|
|
||||||
$table->decimal('min_amount', 12, 2)->comment('最低儲值金額');
|
|
||||||
$table->enum('bonus_type', ['fixed', 'percentage'])->comment('回饋類型');
|
|
||||||
$table->decimal('bonus_value', 12, 2)->comment('回饋值');
|
|
||||||
$table->boolean('is_active')->default(true);
|
|
||||||
$table->datetime('start_at')->nullable()->comment('開始時間');
|
|
||||||
$table->datetime('end_at')->nullable()->comment('結束時間');
|
|
||||||
$table->timestamps();
|
|
||||||
|
|
||||||
$table->index(['is_active', 'start_at', 'end_at']);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('deposit_bonus_rules');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,31 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 會員點數帳戶
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('member_points', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->foreignId('member_id')->constrained('members')->onDelete('cascade');
|
|
||||||
$table->integer('available_points')->default(0)->comment('可用點數');
|
|
||||||
$table->integer('pending_points')->default(0)->comment('待生效點數');
|
|
||||||
$table->integer('expired_points')->default(0)->comment('已過期點數(統計)');
|
|
||||||
$table->integer('used_points')->default(0)->comment('已使用點數(統計)');
|
|
||||||
$table->timestamps();
|
|
||||||
|
|
||||||
$table->unique('member_id');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('member_points');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,36 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 點數異動紀錄
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('point_transactions', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->foreignId('member_id')->constrained('members')->onDelete('cascade');
|
|
||||||
$table->enum('type', ['earn', 'use', 'expire', 'gift', 'adjust'])->comment('異動類型');
|
|
||||||
$table->integer('points')->comment('異動點數');
|
|
||||||
$table->integer('balance_after')->comment('異動後餘額');
|
|
||||||
$table->string('description')->nullable()->comment('說明');
|
|
||||||
$table->datetime('expires_at')->nullable()->comment('此筆點數到期日');
|
|
||||||
$table->string('reference_type')->nullable()->comment('關聯類型');
|
|
||||||
$table->unsignedBigInteger('reference_id')->nullable()->comment('關聯ID');
|
|
||||||
$table->timestamp('created_at')->useCurrent();
|
|
||||||
|
|
||||||
$table->index(['member_id', 'created_at']);
|
|
||||||
$table->index('expires_at');
|
|
||||||
$table->index(['reference_type', 'reference_id']);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('point_transactions');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,32 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 點數規則
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('point_rules', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->string('name')->comment('規則名稱');
|
|
||||||
$table->enum('trigger', ['purchase', 'deposit', 'register', 'birthday', 'referral'])->comment('觸發條件');
|
|
||||||
$table->integer('points_per_unit')->default(1)->comment('每單位獲得點數');
|
|
||||||
$table->decimal('unit_amount', 12, 2)->default(100)->comment('單位金額');
|
|
||||||
$table->integer('validity_days')->default(365)->comment('點數有效天數');
|
|
||||||
$table->boolean('is_active')->default(true);
|
|
||||||
$table->timestamps();
|
|
||||||
|
|
||||||
$table->index('is_active');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('point_rules');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,34 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 會員等級定義
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('membership_tiers', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->string('name')->comment('等級名稱');
|
|
||||||
$table->decimal('annual_fee', 12, 2)->default(0)->comment('年費金額');
|
|
||||||
$table->decimal('discount_rate', 4, 2)->default(1.00)->comment('折扣比例(0.95=95折)');
|
|
||||||
$table->decimal('point_multiplier', 4, 2)->default(1.00)->comment('點數倍率');
|
|
||||||
$table->text('description')->nullable()->comment('說明');
|
|
||||||
$table->boolean('is_default')->default(false)->comment('是否為預設等級');
|
|
||||||
$table->integer('sort_order')->default(0)->comment('排序');
|
|
||||||
$table->timestamps();
|
|
||||||
|
|
||||||
$table->index('is_default');
|
|
||||||
$table->index('sort_order');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('membership_tiers');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,34 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 會員等級紀錄
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('member_memberships', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->foreignId('member_id')->constrained('members')->onDelete('cascade');
|
|
||||||
$table->foreignId('tier_id')->constrained('membership_tiers')->onDelete('cascade');
|
|
||||||
$table->datetime('starts_at')->comment('生效日');
|
|
||||||
$table->datetime('expires_at')->nullable()->comment('到期日');
|
|
||||||
$table->unsignedBigInteger('payment_id')->nullable()->comment('付款紀錄ID');
|
|
||||||
$table->boolean('auto_renew')->default(false)->comment('是否自動續約');
|
|
||||||
$table->enum('status', ['active', 'expired', 'cancelled'])->default('active');
|
|
||||||
$table->timestamps();
|
|
||||||
|
|
||||||
$table->index(['member_id', 'status']);
|
|
||||||
$table->index('expires_at');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('member_memberships');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 禮品/福利定義
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('gift_definitions', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->string('name')->comment('禮品名稱');
|
|
||||||
$table->enum('type', ['points', 'coupon', 'product', 'discount', 'cash'])->comment('禮品類型');
|
|
||||||
$table->decimal('value', 12, 2)->default(0)->comment('數值');
|
|
||||||
$table->foreignId('tier_id')->nullable()->constrained('membership_tiers')->nullOnDelete()->comment('適用等級');
|
|
||||||
$table->enum('trigger', ['register', 'birthday', 'annual', 'upgrade', 'manual'])->comment('觸發條件');
|
|
||||||
$table->integer('validity_days')->default(30)->comment('有效天數');
|
|
||||||
$table->boolean('is_active')->default(true);
|
|
||||||
$table->timestamps();
|
|
||||||
|
|
||||||
$table->index(['is_active', 'trigger']);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('gift_definitions');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,32 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* 會員禮品發放紀錄
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('member_gifts', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->foreignId('member_id')->constrained('members')->onDelete('cascade');
|
|
||||||
$table->foreignId('gift_definition_id')->constrained('gift_definitions')->onDelete('cascade');
|
|
||||||
$table->enum('status', ['pending', 'claimed', 'expired'])->default('pending');
|
|
||||||
$table->datetime('claimed_at')->nullable()->comment('領取時間');
|
|
||||||
$table->datetime('expires_at')->nullable()->comment('有效期限');
|
|
||||||
$table->timestamp('created_at')->useCurrent();
|
|
||||||
|
|
||||||
$table->index(['member_id', 'status']);
|
|
||||||
$table->index('expires_at');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('member_gifts');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,31 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
use Illuminate\Database\Migrations\Migration;
|
|
||||||
use Illuminate\Database\Schema\Blueprint;
|
|
||||||
use Illuminate\Support\Facades\Schema;
|
|
||||||
|
|
||||||
return new class extends Migration
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Run the migrations.
|
|
||||||
*/
|
|
||||||
public function up(): void
|
|
||||||
{
|
|
||||||
Schema::create('user_login_logs', function (Blueprint $table) {
|
|
||||||
$table->id();
|
|
||||||
$table->foreignId('user_id')->constrained()->onDelete('cascade');
|
|
||||||
$table->string('ip_address', 45)->nullable();
|
|
||||||
$table->text('user_agent')->nullable();
|
|
||||||
$table->timestamp('login_at')->useCurrent();
|
|
||||||
$table->timestamps();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Reverse the migrations.
|
|
||||||
*/
|
|
||||||
public function down(): void
|
|
||||||
{
|
|
||||||
Schema::dropIfExists('user_login_logs');
|
|
||||||
}
|
|
||||||
};
|
|
||||||
@@ -1,45 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace Database\Seeders;
|
|
||||||
|
|
||||||
use App\Models\System\User;
|
|
||||||
use Illuminate\Database\Seeder;
|
|
||||||
use Illuminate\Support\Facades\Hash;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 管理員帳號 Seeder
|
|
||||||
*
|
|
||||||
* 執行方式：php artisan db:seed --class=AdminUserSeeder
|
|
||||||
*/
|
|
||||||
class AdminUserSeeder extends Seeder
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Run the database seeds.
|
|
||||||
*/
|
|
||||||
public function run(): void
|
|
||||||
{
|
|
||||||
// 檢查是否已存在 admin 帳號，避免重複建立
|
|
||||||
$admin = User::where('username', 'admin')->first();
|
|
||||||
|
|
||||||
if ($admin) {
|
|
||||||
$this->command->info('Admin 帳號已存在，執行更新密碼與資料。');
|
|
||||||
$admin->update([
|
|
||||||
'name' => 'Admin',
|
|
||||||
'email' => 'admin@star-cloud.com',
|
|
||||||
'password' => Hash::make('password'),
|
|
||||||
'role' => 'admin',
|
|
||||||
]);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
User::create([
|
|
||||||
'username' => 'admin',
|
|
||||||
'name' => 'Admin',
|
|
||||||
'email' => 'admin@star-cloud.com',
|
|
||||||
'password' => Hash::make('password'),
|
|
||||||
'role' => 'admin',
|
|
||||||
]);
|
|
||||||
|
|
||||||
$this->command->info('Admin 帳號建立成功！');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -9,16 +9,15 @@ class DatabaseSeeder extends Seeder
|
|||||||
{
|
{
|
||||||
/**
|
/**
|
||||||
* Seed the application's database.
|
* Seed the application's database.
|
||||||
*
|
|
||||||
* 執行全部 Seeder：php artisan db:seed
|
|
||||||
* 執行單一 Seeder：php artisan db:seed --class=AdminUserSeeder
|
|
||||||
*/
|
*/
|
||||||
public function run(): void
|
public function run(): void
|
||||||
{
|
{
|
||||||
$this->call([
|
// \App\Models\User::factory(10)->create();
|
||||||
AdminUserSeeder::class,
|
|
||||||
MachineSeeder::class,
|
\App\Models\User::factory()->create([
|
||||||
MemberSeeder::class,
|
'name' => 'Admin',
|
||||||
|
'email' => 'admin@star-cloud.com',
|
||||||
|
'password' => bcrypt('password'),
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,21 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace Database\Seeders;
|
|
||||||
|
|
||||||
use App\Models\Machine\Machine;
|
|
||||||
use App\Models\Machine\MachineLog;
|
|
||||||
use Illuminate\Database\Seeder;
|
|
||||||
|
|
||||||
class MachineSeeder extends Seeder
|
|
||||||
{
|
|
||||||
public function run(): void
|
|
||||||
{
|
|
||||||
// 建立 50 台機台
|
|
||||||
Machine::factory()->count(50)->create()->each(function ($machine) {
|
|
||||||
// 每台機台隨機建立 5-10 筆初始日誌
|
|
||||||
MachineLog::factory()->count(rand(5, 10))->create([
|
|
||||||
'machine_id' => $machine->id,
|
|
||||||
]);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,22 +0,0 @@
|
|||||||
<?php
|
|
||||||
|
|
||||||
namespace Database\Seeders;
|
|
||||||
|
|
||||||
use App\Models\Member\Member;
|
|
||||||
use App\Models\Member\MemberWallet;
|
|
||||||
use Illuminate\Database\Seeder;
|
|
||||||
|
|
||||||
class MemberSeeder extends Seeder
|
|
||||||
{
|
|
||||||
public function run(): void
|
|
||||||
{
|
|
||||||
// 建立 20 位會員並分配錢包
|
|
||||||
Member::factory()->count(20)->create()->each(function ($member) {
|
|
||||||
MemberWallet::create([
|
|
||||||
'member_id' => $member->id,
|
|
||||||
'balance' => fake()->randomFloat(2, 100, 5000),
|
|
||||||
'bonus_balance' => fake()->randomFloat(2, 0, 500),
|
|
||||||
]);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,74 +0,0 @@
|
|||||||
FROM ubuntu:24.04
|
|
||||||
|
|
||||||
LABEL maintainer="Taylor Otwell"
|
|
||||||
|
|
||||||
ARG WWWGROUP
|
|
||||||
ARG NODE_VERSION=22
|
|
||||||
ARG MYSQL_CLIENT="mysql-client"
|
|
||||||
ARG POSTGRES_VERSION=18
|
|
||||||
|
|
||||||
WORKDIR /var/www/html
|
|
||||||
|
|
||||||
ENV DEBIAN_FRONTEND=noninteractive
|
|
||||||
ENV TZ=UTC
|
|
||||||
ENV SUPERVISOR_PHP_COMMAND="/usr/bin/php -d variables_order=EGPCS /var/www/html/artisan serve --host=0.0.0.0 --port=80"
|
|
||||||
ENV SUPERVISOR_PHP_USER="sail"
|
|
||||||
ENV PLAYWRIGHT_BROWSERS_PATH=0
|
|
||||||
|
|
||||||
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
|
|
||||||
|
|
||||||
RUN echo "Acquire::http::Pipeline-Depth 0;" > /etc/apt/apt.conf.d/99custom && \
|
|
||||||
echo "Acquire::http::No-Cache true;" >> /etc/apt/apt.conf.d/99custom && \
|
|
||||||
echo "Acquire::BrokenProxy true;" >> /etc/apt/apt.conf.d/99custom
|
|
||||||
|
|
||||||
RUN apt-get update && apt-get upgrade -y \
|
|
||||||
&& mkdir -p /etc/apt/keyrings \
|
|
||||||
&& apt-get install -y gnupg gosu curl ca-certificates zip unzip git supervisor sqlite3 libcap2-bin libpng-dev python3 dnsutils librsvg2-bin fswatch ffmpeg nano \
|
|
||||||
&& curl -sS 'https://keyserver.ubuntu.com/pks/lookup?op=get&search=0xb8dc7e53946656efbce4c1dd71daeaab4ad4cab6' | gpg --dearmor | tee /etc/apt/keyrings/ppa_ondrej_php.gpg > /dev/null \
|
|
||||||
&& echo "deb [signed-by=/etc/apt/keyrings/ppa_ondrej_php.gpg] https://ppa.launchpadcontent.net/ondrej/php/ubuntu noble main" > /etc/apt/sources.list.d/ppa_ondrej_php.list \
|
|
||||||
&& apt-get update \
|
|
||||||
&& apt-get install -y php8.4-cli php8.4-dev \
|
|
||||||
php8.4-pgsql php8.4-sqlite3 php8.4-gd \
|
|
||||||
php8.4-curl php8.4-mongodb \
|
|
||||||
php8.4-imap php8.4-mysql php8.4-mbstring \
|
|
||||||
php8.4-xml php8.4-zip php8.4-bcmath php8.4-soap \
|
|
||||||
php8.4-intl php8.4-readline \
|
|
||||||
php8.4-ldap \
|
|
||||||
php8.4-msgpack php8.4-igbinary php8.4-redis php8.4-swoole \
|
|
||||||
php8.4-memcached php8.4-pcov php8.4-imagick php8.4-xdebug \
|
|
||||||
&& curl -sLS https://getcomposer.org/installer | php -- --install-dir=/usr/bin/ --filename=composer \
|
|
||||||
&& curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg \
|
|
||||||
&& echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_VERSION.x nodistro main" > /etc/apt/sources.list.d/nodesource.list \
|
|
||||||
&& apt-get update \
|
|
||||||
&& apt-get install -y nodejs \
|
|
||||||
&& npm install -g npm \
|
|
||||||
&& npm install -g pnpm \
|
|
||||||
&& npm install -g bun \
|
|
||||||
&& npx playwright install-deps \
|
|
||||||
&& curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | gpg --dearmor | tee /etc/apt/keyrings/yarn.gpg >/dev/null \
|
|
||||||
&& echo "deb [signed-by=/etc/apt/keyrings/yarn.gpg] https://dl.yarnpkg.com/debian/ stable main" > /etc/apt/sources.list.d/yarn.list \
|
|
||||||
&& curl -sS https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor | tee /etc/apt/keyrings/pgdg.gpg >/dev/null \
|
|
||||||
&& echo "deb [signed-by=/etc/apt/keyrings/pgdg.gpg] http://apt.postgresql.org/pub/repos/apt noble-pgdg main" > /etc/apt/sources.list.d/pgdg.list \
|
|
||||||
&& apt-get update \
|
|
||||||
&& apt-get install -y yarn \
|
|
||||||
&& apt-get install -y $MYSQL_CLIENT \
|
|
||||||
&& apt-get install -y postgresql-client-$POSTGRES_VERSION \
|
|
||||||
&& apt-get -y autoremove \
|
|
||||||
&& apt-get clean \
|
|
||||||
&& rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
|
|
||||||
|
|
||||||
RUN setcap "cap_net_bind_service=+ep" /usr/bin/php8.4
|
|
||||||
|
|
||||||
RUN userdel -r ubuntu
|
|
||||||
RUN groupadd --force -g $WWWGROUP sail
|
|
||||||
RUN useradd -ms /bin/bash --no-user-group -g $WWWGROUP -u 1337 sail
|
|
||||||
RUN git config --global --add safe.directory /var/www/html
|
|
||||||
|
|
||||||
COPY start-container /usr/local/bin/start-container
|
|
||||||
COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
|
|
||||||
COPY php.ini /etc/php/8.4/cli/conf.d/99-sail.ini
|
|
||||||
RUN chmod +x /usr/local/bin/start-container
|
|
||||||
|
|
||||||
EXPOSE 80/tcp
|
|
||||||
|
|
||||||
ENTRYPOINT ["start-container"]
|
|
||||||
@@ -1,5 +0,0 @@
|
|||||||
[PHP]
|
|
||||||
post_max_size = 100M
|
|
||||||
upload_max_filesize = 100M
|
|
||||||
variables_order = EGPCS
|
|
||||||
pcov.directory = .
|
|
||||||
@@ -1,26 +0,0 @@
|
|||||||
#!/usr/bin/env bash
|
|
||||||
|
|
||||||
if [ "$SUPERVISOR_PHP_USER" != "root" ] && [ "$SUPERVISOR_PHP_USER" != "sail" ]; then
|
|
||||||
echo "You should set SUPERVISOR_PHP_USER to either 'sail' or 'root'."
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ ! -z "$WWWUSER" ]; then
|
|
||||||
usermod -u $WWWUSER sail
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ ! -d /.composer ]; then
|
|
||||||
mkdir /.composer
|
|
||||||
fi
|
|
||||||
|
|
||||||
chmod -R ugo+rw /.composer
|
|
||||||
|
|
||||||
if [ $# -gt 0 ]; then
|
|
||||||
if [ "$SUPERVISOR_PHP_USER" = "root" ]; then
|
|
||||||
exec "$@"
|
|
||||||
else
|
|
||||||
exec gosu $WWWUSER "$@"
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
exec /usr/bin/supervisord -c /etc/supervisor/conf.d/supervisord.conf
|
|
||||||
fi
|
|
||||||
@@ -1,14 +0,0 @@
|
|||||||
[supervisord]
|
|
||||||
nodaemon=true
|
|
||||||
user=root
|
|
||||||
logfile=/var/log/supervisor/supervisord.log
|
|
||||||
pidfile=/var/run/supervisord.pid
|
|
||||||
|
|
||||||
[program:php]
|
|
||||||
command=%(ENV_SUPERVISOR_PHP_COMMAND)s
|
|
||||||
user=%(ENV_SUPERVISOR_PHP_USER)s
|
|
||||||
environment=LARAVEL_SAIL="1"
|
|
||||||
stdout_logfile=/dev/stdout
|
|
||||||
stdout_logfile_maxbytes=0
|
|
||||||
stderr_logfile=/dev/stderr
|
|
||||||
stderr_logfile_maxbytes=0
|
|
||||||
@@ -1,474 +0,0 @@
|
|||||||
# Star Cloud API 分析與資料庫結構整理
|
|
||||||
|
|
||||||
> 基於 `docs/API/` 中 12 個 PDF 文件的完整分析，整理出 API 端點清單、資料流向及推導出的資料庫結構。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 一、API 端點總覽
|
|
||||||
|
|
||||||
| 代碼 | 名稱 | URL | Method | 說明 |
|
|
||||||
|------|------|-----|--------|------|
|
|
||||||
| B010 | 機台狀態上傳 & 指令撈回 | `/api/app/machine/status/{workid}` | POST | 機台定期心跳上報（狀態、溫度、門禁、版本），並撈回遠端指令。詳見 [b010_technical_spec.md](file:///home/mama/projects/star-cloud/docs/b010_technical_spec.md) |
|
|
||||||
| B017 | 遠端改庫存 | `/api/app/machine/reload_msg/{workid}` | POST | 機台撈取最新貨道庫存數量。詳見 [b017_technical_spec.md](file:///home/mama/projects/star-cloud/docs/b017_technical_spec.md) |
|
|
||||||
| B055 | 遠端出貨（取得指令） | `/api/app/machine/dispense/{workid}` | POST | 機台撈取遠端出貨指令列表。詳見 [b055_technical_spec.md](file:///home/mama/projects/star-cloud/docs/b055_technical_spec.md) |
|
|
||||||
| B055 | 遠端出貨（狀態回傳） | `/api/app/machine/dispense/{workid}` | PUT | 機台回報出貨結果（成功/失敗）及剩餘庫存。詳見 [b055_technical_spec.md](file:///home/mama/projects/star-cloud/docs/b055_technical_spec.md) |
|
|
||||||
| B220 | 零錢機庫存變動回傳 | `/api/app/coin/inventory/B220` | POST | 零錢機各面額庫存回傳（1/5/10/50/100/500/1000 元）。詳見 [b220_technical_spec.md](file:///home/mama/projects/star-cloud/docs/b220_technical_spec.md) |
|
|
||||||
| B600 | 消費金流回傳 | `/api/app/B600` | POST | 消費交易核心 API — 記錄金流類型、金額、商品、發票、會員等。詳見 [b600_technical_spec.md](file:///home/mama/projects/star-cloud/docs/b600_technical_spec.md) |
|
|
||||||
| B601 | 發票資訊回傳 | `/api/app/B601` | POST | 開立發票後回傳發票號碼、日期、隨機碼等。詳見 [b601_technical_spec.md](file:///home/mama/projects/star-cloud/docs/b601_technical_spec.md) |
|
|
||||||
| B602 | 出貨回傳 | `/api/app/B602` | POST | 出貨結果回傳（商品、貨道、金額、庫存、會員條碼等）。詳見 [b602_technical_spec.md](file:///home/mama/projects/star-cloud/docs/b602_technical_spec.md) |
|
|
||||||
| B650 | 驗證會員 | `/api/app/B650` | POST | 會員驗證（點數折抵、優惠券、取貨碼、線上訂單線下取貨等）。詳見 [b650_technical_spec.md](file:///home/mama/projects/star-cloud/docs/b650_technical_spec.md) |
|
|
||||||
| B710 | 計時器狀態回傳 | `/api/app/B710` | POST | 計時型機台的貨道使用狀態與倒數秒數回傳。詳見 [b710_technical_spec.md](file:///home/mama/projects/star-cloud/docs/b710_technical_spec.md) |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 二、API 詳細分析
|
|
||||||
|
|
||||||
### 2.1 B010 — 機台狀態上傳 & 指令撈回
|
|
||||||
|
|
||||||
**用途**：機台定期向 Cloud 回報自身狀態，Cloud 透過 response 中的 `status` 碼下發遠端指令。
|
|
||||||
|
|
||||||
**Request 欄位**：
|
|
||||||
|
|
||||||
| 欄位 | 說明 |
|
|
||||||
|------|------|
|
|
||||||
| `key` | API 金鑰 (`KahnEwjhfDBHUYS7`) |
|
|
||||||
| `machine` | 機台序號 |
|
|
||||||
| `door` | 門禁狀態（非必填） |
|
|
||||||
| `temperature` | 溫度 |
|
|
||||||
| `M_Stus` | 機台型號（非必填） |
|
|
||||||
| `M_Stus2` | 當前頁面狀態碼 |
|
|
||||||
| `M_Ver` | 當前軟體版本 |
|
|
||||||
|
|
||||||
**頁面狀態碼 (M_Stus2)**：
|
|
||||||
- `0`: 離線, `1`: 主頁面, `2`: 販賣頁, `3`: 管理頁, `4`: 補貨頁, `5`: 教學頁
|
|
||||||
- `6`: 購買中, `7`: 鎖定頁, `60`: 出貨成功, `61`: 貨道測試, `62`: 付款選擇
|
|
||||||
- `63`: 等待付款, `64`: 出貨, `65`: 收據簽單, `66`: 通行碼, `67`: 取貨碼
|
|
||||||
- `68`: 訊息顯示, `69`: 取消購買, `610`: 購買結束, `611`: 來店禮, `612`: 出貨失敗
|
|
||||||
|
|
||||||
**遠端指令碼 (Response status)**：
|
|
||||||
- `49`: reload B017 (重新載入庫存), `50`: reload B005, `51`: reboot (重啟)
|
|
||||||
- `60`: reboot card machine, `61`: checkout, `70`: unlock, `71`: lock
|
|
||||||
- `72`: sellCode reload B023, `75`: exp reload B026, `79`: read B050
|
|
||||||
- `81`: sync timer status (B710), `85`: reload B055 (遠端出貨)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2.2 B600 — 消費金流回傳（核心交易 API）
|
|
||||||
|
|
||||||
**用途**：記錄每筆消費交易的完整資訊，為最核心的銷售數據 API。
|
|
||||||
|
|
||||||
**Request 欄位**：
|
|
||||||
|
|
||||||
| 欄位 | 參數名 | 說明 | 類型 |
|
|
||||||
|------|--------|------|------|
|
|
||||||
| req1 | key | API 金鑰 | String |
|
|
||||||
| req2 | machine | 機台編號 | String |
|
|
||||||
| req3 | payment_type | 金流類型代碼 | String |
|
|
||||||
| req4 | payment_request | 金流送出 data | String |
|
|
||||||
| req5 | payment_response | 金流回傳 data | String |
|
|
||||||
| req6 | product_id | 商品 ID | String |
|
|
||||||
| req7 | amount | 消費金額 | String |
|
|
||||||
| req8 | invoice_info | 發票歸戶資訊（統編-電話） | String |
|
|
||||||
| req9 | order_no | APP 定義訂單編號 | String |
|
|
||||||
| req10 | member_barcode | 掃會員得到的條碼 | String |
|
|
||||||
| req11 | machine_time | 機台時間 | String |
|
|
||||||
| req12 | status | 金流狀態 (0: 失敗, 1: 成功, 2: 50 結帳) | String |
|
|
||||||
| req13 | change_amount | 找零金額 | String |
|
|
||||||
| req14 | points_used | 使用的點數 | String |
|
|
||||||
| req15 | reserved | 系統保留 | String |
|
|
||||||
| req16 | items | 商品明細 `[{pid, amount, num}]` | JsonArray |
|
|
||||||
|
|
||||||
**金流類型 (req3) 完整對照**：
|
|
||||||
|
|
||||||
| 代碼 | 說明 |
|
|
||||||
|------|------|
|
|
||||||
| 1 | 信用卡 |
|
|
||||||
| 2 | 悠遊卡/一卡通 |
|
|
||||||
| 3 | 掃碼支付 |
|
|
||||||
| 4 | 手機支付 |
|
|
||||||
| 5 | 通行碼 |
|
|
||||||
| 6 | 取貨碼 |
|
|
||||||
| 7 | 來店禮 |
|
|
||||||
| 8 | 問卷 |
|
|
||||||
| 9 | 零錢 |
|
|
||||||
| 21-25 | 線下付款 + (1/2/3/4/9) |
|
|
||||||
| 30-34 | TapPay (Line/街口/悠遊付/Pi/全盈+) |
|
|
||||||
| 40 | 會員驗證取貨商品 |
|
|
||||||
| 41 | 線上訂單線下結帳 |
|
|
||||||
| 50-54 | 線下付款 + TapPay 系列 |
|
|
||||||
| 60 | 點數/優惠券全額折抵 |
|
|
||||||
| 61-64, 69 | 會員 + (1/2/3/4/9) |
|
|
||||||
| 70 | 官方 LinePay |
|
|
||||||
| 90-94 | 會員 + TapPay 系列 |
|
|
||||||
| 101-109 | 大豐環保點數 + 消費 |
|
|
||||||
| 110-114, 120 | 大豐環保 + TapPay/LinePay |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2.3 B650 — 驗證會員
|
|
||||||
|
|
||||||
**驗證類型 (req6)**：
|
|
||||||
|
|
||||||
| req6 | 說明 | Response 特殊欄位 |
|
|
||||||
|------|------|--------------------|
|
|
||||||
| 0 | 有點擊商品的驗證 | `userToken`, `amount`, `point`, `respondMSG` |
|
|
||||||
| 1 | 會員純驗證 | 基本驗證回應 |
|
|
||||||
| 2 | 會員兌換商品列表 | `productList[{pId, pName, token, validityPeriod, num}]` |
|
|
||||||
| 3 | 線上訂單線下結帳 | `orderUrl`, `orderNumber`, `orderAmount` |
|
|
||||||
| 4 | 會員贈品 | — |
|
|
||||||
|
|
||||||
**Response 狀態碼**：
|
|
||||||
- `100`: 成功 — 無可用點數
|
|
||||||
- `101`: 成功 — 全額折抵（點數或優惠券）
|
|
||||||
- `102`: 成功 — 部分折抵
|
|
||||||
- `103`: 取貨碼驗證成功
|
|
||||||
- `104`: 線上訂單驗證成功
|
|
||||||
- `21`: Key Error, `22`: Time Error, `23`: User Token Error
|
|
||||||
- `25`: 會員平台錯誤, `30`: 會員正在其他機台使用中
|
|
||||||
- `35`: 無效優惠券, `40`: 已兌換過, `41`: 無效訂單, `42`: 取貨碼錯誤
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 三、資料庫結構推導
|
|
||||||
|
|
||||||
根據以上 API 的欄位分析，以下是系統需要的**完整資料庫結構**：
|
|
||||||
|
|
||||||
### 🟢 已存在的資料表（比對現有 migration）
|
|
||||||
|
|
||||||
| 資料表 | 說明 | 對應 API |
|
|
||||||
|--------|------|----------|
|
|
||||||
| `users` | 後台管理員 | — |
|
|
||||||
| `machines` | 機台基本資料 | B010, B017, B055, B220, B600, B602 |
|
|
||||||
| `machine_logs` | 機台日誌 | B010 |
|
|
||||||
| `app_configs` | APP 設定 | — |
|
|
||||||
| `members` | 會員資料 | B650 |
|
|
||||||
| `social_accounts` | 社群帳號 | B650 |
|
|
||||||
| `member_wallets` | 會員錢包 | B650 |
|
|
||||||
| `wallet_transactions` | 錢包交易 | B600, B650 |
|
|
||||||
| `member_points` | 點數帳戶 | B650 |
|
|
||||||
| `point_transactions` | 點數異動 | B650, B600 |
|
|
||||||
| `point_rules` | 點數規則 | B650 |
|
|
||||||
| `membership_tiers` | 會員等級 | — |
|
|
||||||
| `member_memberships` | 會員等級紀錄 | — |
|
|
||||||
| `gift_definitions` | 禮品定義 | — |
|
|
||||||
| `member_gifts` | 禮品發放 | — |
|
|
||||||
| `deposit_bonus_rules` | 儲值回饋規則 | — |
|
|
||||||
|
|
||||||
### 🔴 需新增的資料表
|
|
||||||
|
|
||||||
以下是從 API 欄位推導出**目前資料庫中缺少**，但系統運作所必需的資料表：
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1. `products` — 商品資料
|
|
||||||
|
|
||||||
> 來源：B600 (req6, req16), B602 (req5), B650 (productList), B710 (pid)
|
|
||||||
|
|
||||||
```
|
|
||||||
products
|
|
||||||
├── id BIGINT PK
|
|
||||||
├── name VARCHAR 商品名稱
|
|
||||||
├── price DECIMAL(10,2) 售價
|
|
||||||
├── cost DECIMAL(10,2) 成本（選填）
|
|
||||||
├── category_id BIGINT FK 分類（選填）
|
|
||||||
├── image VARCHAR 商品圖片 URL
|
|
||||||
├── barcode VARCHAR 商品條碼
|
|
||||||
├── description TEXT 商品描述
|
|
||||||
├── is_active BOOLEAN 是否上架
|
|
||||||
├── created_at TIMESTAMP
|
|
||||||
└── updated_at TIMESTAMP
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 2. `machine_slots` — 機台貨道
|
|
||||||
|
|
||||||
> 來源：B017 (tid, num), B055 (res2), B602 (req6, req9), B710 (cid)
|
|
||||||
|
|
||||||
```
|
|
||||||
machine_slots
|
|
||||||
├── id BIGINT PK
|
|
||||||
├── machine_id BIGINT FK → machines
|
|
||||||
├── slot_no VARCHAR 貨道編號 (tid/cid)
|
|
||||||
├── product_id BIGINT FK → products（可空）
|
|
||||||
├── stock INT 當前庫存數量
|
|
||||||
├── max_stock INT 最大容量
|
|
||||||
├── is_active BOOLEAN 是否啟用
|
|
||||||
├── created_at TIMESTAMP
|
|
||||||
└── updated_at TIMESTAMP
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 3. `orders` — 訂單（消費紀錄主表）
|
|
||||||
|
|
||||||
> 來源：B600 (核心), B601, B602
|
|
||||||
|
|
||||||
```
|
|
||||||
orders
|
|
||||||
├── id BIGINT PK
|
|
||||||
├── order_no VARCHAR UNIQUE APP 定義訂單編號 (req9)
|
|
||||||
├── machine_id BIGINT FK → machines (req2)
|
|
||||||
├── member_id BIGINT FK → members（可空）
|
|
||||||
├── payment_type TINYINT 金流類型代碼 (req3)
|
|
||||||
├── total_amount DECIMAL(10,2) 消費金額 (req7)
|
|
||||||
├── change_amount DECIMAL(10,2) 找零金額 (req13)
|
|
||||||
├── points_used INT 使用的點數 (req14)
|
|
||||||
├── discount_amount DECIMAL(10,2) 折扣前金額 (req15)
|
|
||||||
├── payment_status TINYINT 金流狀態 (req12: 0失敗/1成功/2:50結帳)
|
|
||||||
├── payment_request TEXT 金流送出 data (req4)
|
|
||||||
├── payment_response TEXT 金流回傳 data (req5)
|
|
||||||
├── member_barcode VARCHAR 會員條碼 (req10)
|
|
||||||
├── invoice_info VARCHAR 發票歸戶資訊 (req8)
|
|
||||||
├── machine_time DATETIME 機台時間 (req11)
|
|
||||||
├── flow_id VARCHAR Cloud 回傳的金流 ID (B600 response message)
|
|
||||||
├── created_at TIMESTAMP
|
|
||||||
└── updated_at TIMESTAMP
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 4. `order_items` — 訂單明細
|
|
||||||
|
|
||||||
> 來源：B600 (req16: `[{pid, amount, num}]`)
|
|
||||||
|
|
||||||
```
|
|
||||||
order_items
|
|
||||||
├── id BIGINT PK
|
|
||||||
├── order_id BIGINT FK → orders
|
|
||||||
├── product_id BIGINT FK → products (pid)
|
|
||||||
├── quantity INT 數量 (num)
|
|
||||||
├── unit_price DECIMAL(10,2) 單價 (amount)
|
|
||||||
├── subtotal DECIMAL(10,2) 小計
|
|
||||||
├── created_at TIMESTAMP
|
|
||||||
└── updated_at TIMESTAMP
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 5. `invoices` — 發票紀錄
|
|
||||||
|
|
||||||
> 來源：B601
|
|
||||||
|
|
||||||
```
|
|
||||||
invoices
|
|
||||||
├── id BIGINT PK
|
|
||||||
├── order_id BIGINT FK → orders（透過 flow_id 關聯）
|
|
||||||
├── flow_id VARCHAR B600 回傳的金流 ID (req3)
|
|
||||||
├── machine_id BIGINT FK → machines (req2)
|
|
||||||
├── rtn_code VARCHAR 發票回傳碼 (req4)
|
|
||||||
├── rtn_msg VARCHAR 發票回傳訊息 (req5)
|
|
||||||
├── invoice_no VARCHAR 發票號碼 (req6)
|
|
||||||
├── invoice_date DATE 發票日期 (req7)
|
|
||||||
├── random_number VARCHAR 隨機碼 (req8)
|
|
||||||
├── love_code VARCHAR 愛心碼 (req9)
|
|
||||||
├── business_tax_id VARCHAR 公司統編 (新增)
|
|
||||||
├── carrier_id VARCHAR 載具編號 (新增)
|
|
||||||
├── carrier_type VARCHAR 載具類型 (新增)
|
|
||||||
├── status TINYINT 發票狀態 (1:有效, 0:作廢)
|
|
||||||
├── created_at TIMESTAMP
|
|
||||||
└── updated_at TIMESTAMP
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 6. `dispense_records` — 出貨紀錄
|
|
||||||
|
|
||||||
> 來源：B602, B055
|
|
||||||
|
|
||||||
```
|
|
||||||
dispense_records
|
|
||||||
├── id BIGINT PK
|
|
||||||
├── order_id BIGINT FK → orders（透過 flow_id 關聯）
|
|
||||||
├── flow_id VARCHAR 金流 ID (req3)
|
|
||||||
├── machine_id BIGINT FK → machines (req2)
|
|
||||||
├── product_id BIGINT FK → products (req5)
|
|
||||||
├── slot_no VARCHAR 貨道編號 (req6)
|
|
||||||
├── amount DECIMAL(10,2) 消費金額 (req7)
|
|
||||||
├── remaining_stock INT 貨道剩餘庫存 (req9)
|
|
||||||
├── member_barcode VARCHAR 會員條碼 (req10)
|
|
||||||
├── machine_time DATETIME 機台時間 (req11)
|
|
||||||
├── coupon_order_no VARCHAR 商品券訂單編號 (req12)
|
|
||||||
├── dispense_status TINYINT 出貨狀態 (req13: 0成功/1失敗)
|
|
||||||
├── original_price DECIMAL(10,2) 折扣前金額 (req15)
|
|
||||||
├── points_used INT 使用的點數 (req16)
|
|
||||||
├── created_at TIMESTAMP
|
|
||||||
└── updated_at TIMESTAMP
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 7. `remote_dispense_commands` — 遠端出貨指令
|
|
||||||
|
|
||||||
> 來源：B055
|
|
||||||
|
|
||||||
```
|
|
||||||
remote_dispense_commands
|
|
||||||
├── id BIGINT PK
|
|
||||||
├── machine_id BIGINT FK → machines
|
|
||||||
├── command_id VARCHAR 執行命令 ID (res1)
|
|
||||||
├── slot_no VARCHAR 貨道 ID (res2)
|
|
||||||
├── status TINYINT 狀態 (0: 待執行, 1: 出貨成功, 2: 出貨失敗)
|
|
||||||
├── remaining_stock INT 出貨後剩餘庫存
|
|
||||||
├── created_at TIMESTAMP
|
|
||||||
└── updated_at TIMESTAMP
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 8. `coin_inventory_logs` — 零錢機庫存紀錄
|
|
||||||
|
|
||||||
> 來源：B220
|
|
||||||
|
|
||||||
```
|
|
||||||
coin_inventory_logs
|
|
||||||
├── id BIGINT PK
|
|
||||||
├── machine_id BIGINT FK → machines
|
|
||||||
├── value_1 INT 1 元庫存
|
|
||||||
├── value_5 INT 5 元庫存
|
|
||||||
├── value_10 INT 10 元庫存
|
|
||||||
├── value_50 INT 50 元庫存
|
|
||||||
├── value_100 INT 100 元庫存
|
|
||||||
├── value_500 INT 500 元庫存
|
|
||||||
├── value_1000 INT 1000 元庫存
|
|
||||||
├── account VARCHAR 操作人帳號 (0=消費者)
|
|
||||||
├── created_at TIMESTAMP
|
|
||||||
└── updated_at TIMESTAMP
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 9. `timer_statuses` — 計時器狀態
|
|
||||||
|
|
||||||
> 來源：B710
|
|
||||||
|
|
||||||
```
|
|
||||||
timer_statuses
|
|
||||||
├── id BIGINT PK
|
|
||||||
├── machine_id BIGINT FK → machines
|
|
||||||
├── slot_no VARCHAR 貨道 ID (cid)
|
|
||||||
├── product_id BIGINT FK → products (pid, 0=未設定)
|
|
||||||
├── status TINYINT 狀態 (0: 未啟用, 1: 使用中, 2: 異常)
|
|
||||||
├── remaining_seconds INT 剩餘秒數 (num)
|
|
||||||
├── created_at TIMESTAMP
|
|
||||||
└── updated_at TIMESTAMP
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 10. `payment_types` — 金流類型參照表（建議）
|
|
||||||
|
|
||||||
> 來源：B600 req3 的龐大對照表
|
|
||||||
|
|
||||||
```
|
|
||||||
payment_types
|
|
||||||
├── id BIGINT PK
|
|
||||||
├── code INT UNIQUE 金流類型代碼
|
|
||||||
├── name VARCHAR 名稱（中文）
|
|
||||||
├── category VARCHAR 分類（信用卡/電子票證/行動支付/TapPay/會員/環保點數...）
|
|
||||||
├── is_active BOOLEAN 是否啟用
|
|
||||||
├── created_at TIMESTAMP
|
|
||||||
└── updated_at TIMESTAMP
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 四、ER 關係圖
|
|
||||||
|
|
||||||
```mermaid
|
|
||||||
erDiagram
|
|
||||||
machines ||--o{ machine_slots : "擁有"
|
|
||||||
machines ||--o{ machine_logs : "產生"
|
|
||||||
machines ||--o{ orders : "交易於"
|
|
||||||
machines ||--o{ coin_inventory_logs : "零錢記錄"
|
|
||||||
machines ||--o{ timer_statuses : "計時器"
|
|
||||||
machines ||--o{ remote_dispense_commands : "遠端指令"
|
|
||||||
|
|
||||||
products ||--o{ machine_slots : "放置於"
|
|
||||||
products ||--o{ order_items : "被購買"
|
|
||||||
products ||--o{ timer_statuses : "計時商品"
|
|
||||||
|
|
||||||
orders ||--o{ order_items : "包含"
|
|
||||||
orders ||--o| invoices : "開立"
|
|
||||||
orders ||--o{ dispense_records : "出貨"
|
|
||||||
orders }o--o| members : "消費者"
|
|
||||||
orders }o--|| payment_types : "付款方式"
|
|
||||||
|
|
||||||
members ||--o{ social_accounts : "社群綁定"
|
|
||||||
members ||--o| member_wallets : "錢包"
|
|
||||||
members ||--o| member_points : "點數"
|
|
||||||
members ||--o{ member_memberships : "會員等級"
|
|
||||||
members ||--o{ member_gifts : "禮品"
|
|
||||||
|
|
||||||
member_wallets ||--o{ wallet_transactions : "異動"
|
|
||||||
member_points ||--o{ point_transactions : "異動"
|
|
||||||
membership_tiers ||--o{ member_memberships : "對應等級"
|
|
||||||
gift_definitions ||--o{ member_gifts : "對應禮品"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 五、API 資料流向圖
|
|
||||||
|
|
||||||
```
|
|
||||||
┌─────────────┐
|
|
||||||
│ 機台 (APP) │
|
|
||||||
└──────┬──────┘
|
|
||||||
│
|
|
||||||
├── B010 ──► 心跳上報 ──► machine_logs（狀態/溫度/版本）
|
|
||||||
│ ◄── 返回遠端指令碼
|
|
||||||
│
|
|
||||||
├── B017 ──► 撈取庫存 ──► machine_slots（最新貨道數量）
|
|
||||||
│
|
|
||||||
├── B055 ──► 撈取出貨指令 ──► remote_dispense_commands
|
|
||||||
│ PUT ──► 回報出貨結果 ──► 更新 command status + 庫存
|
|
||||||
│
|
|
||||||
├── B220 ──► 零錢機庫存 ──► coin_inventory_logs
|
|
||||||
│
|
|
||||||
├── B600 ──► 消費金流 ──► orders + order_items（核心交易）
|
|
||||||
│ ◄── 返回金流 ID (flow_id)
|
|
||||||
│
|
|
||||||
├── B601 ──► 發票回傳 ──► invoices（關聯 flow_id）
|
|
||||||
│
|
|
||||||
├── B602 ──► 出貨回傳 ──► dispense_records（關聯 flow_id）
|
|
||||||
│
|
|
||||||
├── B650 ──► 驗證會員 ──► members + member_points
|
|
||||||
│ ◄── 點數折抵/優惠券/取貨碼/線上訂單
|
|
||||||
│
|
|
||||||
└── B710 ──► 計時器狀態 ──► timer_statuses
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 六、重要觀察與建議
|
|
||||||
|
|
||||||
### 6.1 API 金鑰
|
|
||||||
- 所有 API 使用同一把硬編碼金鑰 `KahnEwjhfDBHUYS7`
|
|
||||||
- **建議**：遷移到 Star Cloud 後改為每台機台獨立的 API Token，使用 Laravel Sanctum 管理
|
|
||||||
|
|
||||||
### 6.2 資料一致性
|
|
||||||
- B600（金流）→ B601（發票）→ B602（出貨）三支 API 透過 `flow_id` 串聯
|
|
||||||
- 建議資料庫設計中以 `orders.flow_id` 作為三者的關聯基準
|
|
||||||
|
|
||||||
### 6.3 高頻 API
|
|
||||||
- **B010** 為最高頻率 API（每台機台數秒呼叫一次），必須走 **Redis Queue 異步寫入**
|
|
||||||
- B220（零錢機庫存）與 B710（計時器）也屬於高頻回報，建議異步處理
|
|
||||||
|
|
||||||
### 6.4 新舊版差異
|
|
||||||
- B220 和 B600/B602 各有兩個版本的 PDF（新舊版），新版增加了更多面額（500/1000 元）和 TapPay 金流類型
|
|
||||||
- 建議以**較新版本 (帶日期後綴的)** 為準進行開發
|
|
||||||
|
|
||||||
### 6.5 `machines` 表建議補充欄位
|
|
||||||
|
|
||||||
根據 B010 API，`machines` 表應包含：
|
|
||||||
|
|
||||||
| 欄位 | 說明 | 來源 |
|
|
||||||
|------|------|------|
|
|
||||||
| `serial_no` | 機台序號 | B010 machine |
|
|
||||||
| `model` | 機台型號 | B010 M_Stus |
|
|
||||||
| `current_status` | 當前頁面狀態碼 | B010 M_Stus2 |
|
|
||||||
| `current_version` | 當前軟體版本 | B010 M_Ver |
|
|
||||||
| `temperature` | 最新溫度 | B010 temperature |
|
|
||||||
| `door_status` | 門禁狀態 | B010 door |
|
|
||||||
| `last_heartbeat_at` | 最後心跳時間 | B010 呼叫時間 |
|
|
||||||
| `is_online` | 是否在線 | 由心跳超時判斷 |
|
|
||||||
@@ -1,567 +0,0 @@
|
|||||||
# Star Cloud — 智能販賣機管理平台技術架構規劃
|
|
||||||
|
|
||||||
> **目標**：為上千至上萬台智能販賣機建構集中式管理後台，承接所有機台透過 API 回寫的資料，並提供完整的營運管理介面。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 一、系統架構全景
|
|
||||||
|
|
||||||
```
|
|
||||||
┌──────────────────────────────────────────────┐
|
|
||||||
│ Star Cloud 管理後台 │
|
|
||||||
│ (Laravel 12 + Blade + Tailwind) │
|
|
||||||
│ ┌──────────┐ ┌──────────┐ ┌───────────┐ │
|
|
||||||
│ │ 儀表板 │ │ 機台管理 │ │ 銷售分析 │ │
|
|
||||||
│ │ Dashboard │ │ Machines │ │ Analytics │ │
|
|
||||||
│ └──────────┘ └──────────┘ └───────────┘ │
|
|
||||||
│ ┌──────────┐ ┌──────────┐ ┌───────────┐ │
|
|
||||||
│ │ 倉庫管理 │ │ 會員系統 │ │ 遠端操控 │ │
|
|
||||||
│ │Warehouses │ │ Members │ │ Remote │ │
|
|
||||||
│ └──────────┘ └──────────┘ └───────────┘ │
|
|
||||||
└──────────┬───────────────┬───────────────────┘
|
|
||||||
│ Web Routes │
|
|
||||||
│ (Blade SSR) │
|
|
||||||
┌──────────┴───────────────┴───────────────────┐
|
|
||||||
│ Laravel Application │
|
|
||||||
│ │
|
|
||||||
│ Controllers → Services → Models → MySQL │
|
|
||||||
│ │
|
|
||||||
└──────┬────────────────────┬──────────────────┘
|
|
||||||
│ │
|
|
||||||
┌──────────┴────┐ ┌───────┴───────┐
|
|
||||||
│ API Routes │ │ Redis Queue │
|
|
||||||
│ /api/v1/app │ │ (異步處理) │
|
|
||||||
└──────┬────────┘ └───────┬───────┘
|
|
||||||
│ │
|
|
||||||
┌──────┴────────┐ ┌───────┴───────┐
|
|
||||||
│ API Controller│──────►│ Jobs │
|
|
||||||
│ (驗證 + 分派) │ dispatch│ (Worker 執行) │
|
|
||||||
└───────────────┘ └───────┬───────┘
|
|
||||||
▲ │
|
|
||||||
┌────────────────┤ ▼
|
|
||||||
│ │ ┌──────────────┐
|
|
||||||
┌─────┴─────┐ ┌────┴─────┐ │ Services │
|
|
||||||
│ 販賣機 #1 │ │販賣機 #N │ │ (業務邏輯) │
|
|
||||||
│ B010 │ │ B600 │ └──────┬───────┘
|
|
||||||
│ B600 │ │ B602 │ │
|
|
||||||
│ B602 │ │ ... │ ▼
|
|
||||||
└────────────┘ └──────────┘ ┌──────────────┐
|
|
||||||
│ MySQL │
|
|
||||||
│ (持久化) │
|
|
||||||
└──────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 二、技術棧確認
|
|
||||||
|
|
||||||
| 層級 | 技術 | 說明 |
|
|
||||||
|------|------|------|
|
|
||||||
| **後端框架** | PHP 8.5 / Laravel 12 | 單體架構，Blade SSR |
|
|
||||||
| **資料庫** | MySQL 8.0 | 資料持久化 |
|
|
||||||
| **快取/隊列** | Redis | B010 心跳、B600 金流等高頻 API 必須異步 |
|
|
||||||
| **前端視圖** | Blade + Tailwind CSS + Preline UI | 極簡奢華風 |
|
|
||||||
| **前端互動** | Alpine.js | 輕量 DOM 互動 |
|
|
||||||
| **建置工具** | Vite | 前端資源編譯 |
|
|
||||||
| **開發環境** | Laravel Sail (Docker) | 本地開發 |
|
|
||||||
| **IoT 通訊** | Redis Queue + Jobs | 異步寫入，避免 API 直連 DB |
|
|
||||||
| **認證** | Laravel Sanctum | 後台用 Session，API 用 Token |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 三、多租戶與權限架構 (Multi-Tenant RBAC)
|
|
||||||
|
|
||||||
為支援系統管理員（內部營運）與租戶（客戶公司及子帳號）的雙層管理模式，平台採用以下三層級權限隔離架構：
|
|
||||||
|
|
||||||
### 3.1 租戶隔離層 (Tenant Isolation)
|
|
||||||
* **核心機制**：導入 `companies` 資料表作為租戶實體，所有歸屬於客戶的資源（`users`, `machines` 等）均需綁定 `company_id`。
|
|
||||||
* **身份判定**：
|
|
||||||
* **系統管理員 (內部)**：`company_id = null`，具備跨租戶檢視與管理機台、設定全局參數的最高權限。
|
|
||||||
* **客戶端帳號 (租戶)**：`company_id` 有值，所有查詢（透過 Eloquent Global Scopes 或 Middleware）自動注入 `where('company_id', $user->company_id)`，達成資料物理隔離。
|
|
||||||
|
|
||||||
### 3.2 角色與權限層 (Roles & Permissions)
|
|
||||||
* 採用 `spatie/laravel-permission` 套件並進行多租戶改造。
|
|
||||||
* **多租戶角色 (Tenant-Aware Roles)**：擴充 `roles` 表，加入 `company_id` 欄位。
|
|
||||||
* **系統預設角色** (`company_id = null`)：如 Super Admin, System Support。
|
|
||||||
* **客戶自建角色** (`company_id = N`)：如客戶建立的「分區維修員」、「會計」，確保客戶只能看見與分配屬於自己公司的角色給員工。
|
|
||||||
* **權限 (Permissions)**：定義系統最小操作單位（如 `machine.view`, `user.create`），供角色綁定。
|
|
||||||
|
|
||||||
### 3.3 流程控制與防禦 (Flow Control)
|
|
||||||
* **介面隔離**：依據身份動態隱藏/顯示系統級選單（例如「全站設定」、「合約管理」等多租戶不可見的功能）。
|
|
||||||
* **越權防禦**：客戶創建子帳號時，後端必定強制攔截並覆寫 `user->company_id = Auth::user()->company_id`，確保子帳號牢牢綁在自己的公司名下。同時限制其只能撈與分配自己公司名下的 Role。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 四、資料庫完整設計
|
|
||||||
|
|
||||||
### 4.1 資料表總覽
|
|
||||||
|
|
||||||
分為 **6 大領域**，共 **28 張表**：
|
|
||||||
|
|
||||||
```mermaid
|
|
||||||
graph LR
|
|
||||||
subgraph 系統管理
|
|
||||||
A1[users] --> A2[sessions]
|
|
||||||
A1 --> A3[personal_access_tokens]
|
|
||||||
A4[failed_jobs]
|
|
||||||
end
|
|
||||||
|
|
||||||
subgraph 機台領域
|
|
||||||
B1[machines] --> B2[machine_slots]
|
|
||||||
B1 --> B3[machine_logs]
|
|
||||||
B1 --> B4[coin_inventories]
|
|
||||||
B1 --> B5[timer_statuses]
|
|
||||||
B1 --> B6[remote_commands]
|
|
||||||
B1 --> B7[machine_heartbeats]
|
|
||||||
end
|
|
||||||
|
|
||||||
subgraph 商品領域
|
|
||||||
C1[products]
|
|
||||||
C2[product_categories]
|
|
||||||
end
|
|
||||||
|
|
||||||
subgraph 交易領域
|
|
||||||
D1[orders] --> D2[order_items]
|
|
||||||
D1 --> D3[invoices]
|
|
||||||
D1 --> D4[dispense_records]
|
|
||||||
D5[payment_types]
|
|
||||||
end
|
|
||||||
|
|
||||||
subgraph 會員領域
|
|
||||||
E1[members] --> E2[social_accounts]
|
|
||||||
E1 --> E3[member_wallets]
|
|
||||||
E3 --> E4[wallet_transactions]
|
|
||||||
E1 --> E5[member_points]
|
|
||||||
E5 --> E6[point_transactions]
|
|
||||||
E7[point_rules]
|
|
||||||
E8[deposit_bonus_rules]
|
|
||||||
E1 --> E9[membership_tiers]
|
|
||||||
E1 --> E10[member_memberships]
|
|
||||||
E1 --> E11[gift_definitions]
|
|
||||||
E1 --> E12[member_gifts]
|
|
||||||
end
|
|
||||||
|
|
||||||
subgraph APP設定
|
|
||||||
F1[app_configs]
|
|
||||||
end
|
|
||||||
```
|
|
||||||
|
|
||||||
### 4.2 需新增的資料表（Migration 設計）
|
|
||||||
|
|
||||||
> 以下為 API 分析後推導出的缺失表，搭配各 API 欄位產生對應。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 👑 多租戶與權限基礎表 (RBAC & Tenant)
|
|
||||||
|
|
||||||
##### 🆕 `companies` — 租戶/客戶主表
|
|
||||||
所有客戶端的資料邊界，用來實現資料物理隔離。
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — |
|
|
||||||
| `name` | VARCHAR(255) | 公司/組織名稱 |
|
|
||||||
| `tax_id` | VARCHAR(20) NULL | 統一編號 |
|
|
||||||
| `contact_name` | VARCHAR(100) NULL | 聯絡人姓名 |
|
|
||||||
| `contact_phone` | VARCHAR(50) NULL | 聯絡電話 |
|
|
||||||
| `status` | TINYINT DEFAULT 1 | 狀態 (1:啟用, 0:停用) |
|
|
||||||
| `valid_until` | DATE NULL | 合約使用期限 |
|
|
||||||
| `timestamps` | — | — |
|
|
||||||
| `deleted_at` | TIMESTAMP NULL | 軟刪除 (SoftDeletes) |
|
|
||||||
|
|
||||||
##### 🟡 `users` 表 — 需擴充欄位
|
|
||||||
將 Laravel 預設的使用者表與租戶綁定。
|
|
||||||
|
|
||||||
| 新增欄位 | 類型 | 說明 |
|
|
||||||
|----------|------|------|
|
|
||||||
| `company_id` | BIGINT FK NULL | → `companies` (NULL 代表系統管理員) |
|
|
||||||
| `status` | TINYINT DEFAULT 1 | 帳號狀態 (1:啟用, 0:停用) |
|
|
||||||
|
|
||||||
##### 🟡 `roles` 表 (Spatie 權限擴充)
|
|
||||||
Spatie 預設的 roles 表必須加上多租戶設計，確保留戶只能管理自己的角色。
|
|
||||||
|
|
||||||
| 新增/調整欄位 | 類型 | 說明 |
|
|
||||||
|----------|------|------|
|
|
||||||
| `company_id` | BIGINT FK NULL | → `companies` (NULL 代表系統全域角色) |
|
|
||||||
| **UNIQUE** | `(name, guard_name, company_id)` | 原套件無 `company_id`，需修改為複合唯一鍵 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🟡 `machines` 表 — 需擴充欄位
|
|
||||||
|
|
||||||
現有 `machines` 表僅有基礎欄位，需為 B010 API 補充：
|
|
||||||
|
|
||||||
| 新增欄位 | 類型 | 說明 | 來源 API |
|
|
||||||
|----------|------|------|----------|
|
|
||||||
| `serial_no` | `VARCHAR UNIQUE` | 機台序號（API 用此識別） | B010 `machine` |
|
|
||||||
| `model` | `VARCHAR` | 機台型號 | B010 `M_Stus` |
|
|
||||||
| `current_page` | `TINYINT` | 當前頁面狀態碼 | B010 `M_Stus2` |
|
|
||||||
| `door_status` | `VARCHAR` | 門禁狀態 | B010 `door` |
|
|
||||||
| `is_online` | `BOOLEAN` | 是否在線（心跳超時判斷） | 計算欄位 |
|
|
||||||
| `api_token` | `VARCHAR` | 機台專屬 API Token | 取代硬編碼 key |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🆕 `products` — 商品資料
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — |
|
|
||||||
| `name` | VARCHAR(255) | 商品名稱 (預設語系) |
|
|
||||||
| `name_dictionary_key` | VARCHAR(100) NULL | 多語系字典鍵值 (對應 translations 表) |
|
|
||||||
| `sku` | VARCHAR(100) UNIQUE | 商品編號 |
|
|
||||||
| `price` | DECIMAL(10,2) | 售價 |
|
|
||||||
| `cost` | DECIMAL(10,2) NULL | 成本 |
|
|
||||||
| `category_id` | BIGINT FK NULL | → product_categories |
|
|
||||||
| `image` | VARCHAR NULL | 圖片 URL |
|
|
||||||
| `barcode` | VARCHAR NULL | 條碼 |
|
|
||||||
| `is_timer_product` | BOOLEAN | 是否為計時型商品 |
|
|
||||||
| `is_active` | BOOLEAN | 是否上架 |
|
|
||||||
| `timestamps` | — | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🌐 多語系支援表 (i18n)
|
|
||||||
|
|
||||||
為了支援後台介面與 APP 端顯示的多語系內容（如商品名稱、分類名稱、系統提示），統一採用字典表架構。
|
|
||||||
|
|
||||||
##### 🆕 `translations` — 多語系字典表
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — |
|
|
||||||
| `group` | VARCHAR(50) | 分組 (例如: `product`, `category`, `system`) |
|
|
||||||
| `key` | VARCHAR(100) | 字典鍵值 (例如: `prod_name_001`) |
|
|
||||||
| `locale` | VARCHAR(10) | 語系代碼 (例如: `zh_TW`, `en_US`, `ja_JP`) |
|
|
||||||
| `value` | TEXT | 翻譯內容 |
|
|
||||||
| `timestamps` | — | — |
|
|
||||||
| **UNIQUE** | `(group, key, locale)` | 確保同一組鍵值在同一語系下唯一 |
|
|
||||||
|
|
||||||
> **多語系實作策略**：
|
|
||||||
> 1. **靜態文案**：後台介面的靜態文字直接使用 Laravel 內建的 `lang/` 目錄 (JSON 或 PHP 陣列)。
|
|
||||||
> 2. **動態資料**：資料庫內容（如商品名稱 `products.name`）保留預設語系供後台快速搜尋。同時新增 `name_dictionary_key`。當對接外部 APP 或前台需要多語系時，透過 API 關聯 `translations` 表，回傳當前語系對應的 `value`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🆕 `machine_slots` — 機台貨道
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 | 來源 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — | — |
|
|
||||||
| `machine_id` | BIGINT FK | → machines | B017, B055, B710 |
|
|
||||||
| `slot_no` | VARCHAR(20) | 貨道編號 | B017 `tid`, B710 `cid` |
|
|
||||||
| `product_id` | BIGINT FK NULL | → products | B710 `pid` |
|
|
||||||
| `stock` | INT DEFAULT 0 | 當前庫存 | B017 `num` |
|
|
||||||
| `max_stock` | INT DEFAULT 0 | 最大容量 | — |
|
|
||||||
| `is_active` | BOOLEAN | 是否啟用 | — |
|
|
||||||
| `timestamps` | — | — | — |
|
|
||||||
| **UNIQUE** | `(machine_id, slot_no)` | 複合唯一鍵 | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🆕 `orders` — 訂單主表
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 | 來源 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — | — |
|
|
||||||
| `flow_id` | VARCHAR UNIQUE | Cloud 金流 ID | B600 response |
|
|
||||||
| `order_no` | VARCHAR | APP 訂單號 | B600 `req9` |
|
|
||||||
| `machine_id` | BIGINT FK | → machines | B600 `req2` |
|
|
||||||
| `member_id` | BIGINT FK NULL | → members | B650 關聯 |
|
|
||||||
| `payment_type` | SMALLINT | 金流類型碼 | B600 `req3` |
|
|
||||||
| `total_amount` | DECIMAL(10,2) | 消費金額 | B600 `req7` |
|
|
||||||
| `change_amount` | DECIMAL(10,2) | 找零 | B600 `req13` |
|
|
||||||
| `points_used` | INT DEFAULT 0 | 使用點數 | B600 `req14` |
|
|
||||||
| `original_amount` | DECIMAL(10,2) NULL | 折扣前金額 | B602 `req15` |
|
|
||||||
| `payment_status` | TINYINT | 0:失敗/1:成功 | B600 `req12` |
|
|
||||||
| `payment_request` | TEXT NULL | 金流送出 data | B600 `req4` |
|
|
||||||
| `payment_response` | TEXT NULL | 金流回傳 data | B600 `req5` |
|
|
||||||
| `member_barcode` | VARCHAR NULL | 會員條碼 | B600 `req10` |
|
|
||||||
| `invoice_info` | VARCHAR NULL | 發票歸戶 | B600 `req8` |
|
|
||||||
| `machine_time` | DATETIME NULL | 機台時間 | B600 `req11` |
|
|
||||||
| `timestamps` | — | — | — |
|
|
||||||
| **INDEX** | `(machine_id, created_at)` | 查詢最佳化 | — |
|
|
||||||
| **INDEX** | `(payment_type)` | 金流類型篩選 | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🆕 `order_items` — 訂單明細
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 | 來源 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — | — |
|
|
||||||
| `order_id` | BIGINT FK | → orders | — |
|
|
||||||
| `product_id` | BIGINT FK | → products | B600 `req16.pid` |
|
|
||||||
| `quantity` | INT | 數量 | B600 `req16.num` |
|
|
||||||
| `unit_price` | DECIMAL(10,2) | 單價 | B600 `req16.amount` |
|
|
||||||
| `subtotal` | DECIMAL(10,2) | 小計 | 計算 |
|
|
||||||
| `timestamps` | — | — | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🆕 `invoices` — 發票紀錄
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 | 來源 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — | — |
|
|
||||||
| `order_id` | BIGINT FK | → orders（via flow_id） | — |
|
|
||||||
| `flow_id` | VARCHAR | 金流 ID | B601 `req3` |
|
|
||||||
| `machine_id` | BIGINT FK | → machines | B601 `req2` |
|
|
||||||
| `rtn_code` | VARCHAR NULL | 回傳碼 | B601 `req4` |
|
|
||||||
| `rtn_msg` | VARCHAR NULL | 回傳訊息 | B601 `req5` |
|
|
||||||
| `invoice_no` | VARCHAR NULL | 發票號碼 | B601 `req6` |
|
|
||||||
| `invoice_date` | DATE NULL | 發票日期 | B601 `req7` |
|
|
||||||
| `random_number` | VARCHAR NULL | 隨機碼 | B601 `req8` |
|
|
||||||
| `love_code` | VARCHAR NULL | 愛心碼 | B601 `req9` |
|
|
||||||
| `timestamps` | — | — | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🆕 `dispense_records` — 出貨紀錄
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 | 來源 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — | — |
|
|
||||||
| `order_id` | BIGINT FK NULL | → orders | — |
|
|
||||||
| `flow_id` | VARCHAR NULL | 金流 ID | B602 `req3` |
|
|
||||||
| `machine_id` | BIGINT FK | → machines | B602 `req2` |
|
|
||||||
| `product_id` | VARCHAR | 商品 ID | B602 `req5` |
|
|
||||||
| `slot_no` | VARCHAR | 貨道編號 | B602 `req6` |
|
|
||||||
| `amount` | DECIMAL(10,2) | 消費金額 | B602 `req7` |
|
|
||||||
| `remaining_stock` | INT NULL | 剩餘庫存 | B602 `req9` |
|
|
||||||
| `dispense_status` | TINYINT | 0:成功/1:失敗 | B602 `req13` |
|
|
||||||
| `member_barcode` | VARCHAR NULL | 會員條碼 | B602 `req10` |
|
|
||||||
| `machine_time` | DATETIME NULL | 機台時間 | B602 `req11` |
|
|
||||||
| `points_used` | INT DEFAULT 0 | 使用點數 | B602 `req16` |
|
|
||||||
| `timestamps` | — | — | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🆕 `remote_commands` — 遠端指令佇列
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 | 來源 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — | — |
|
|
||||||
| `machine_id` | BIGINT FK | → machines | — |
|
|
||||||
| `command_type` | VARCHAR(50) | 指令類型 (reboot, lock, stock_update, dispense...) | B010, B017, B055 |
|
|
||||||
| `status` | ENUM | pending/sent/success/failed | — |
|
|
||||||
| `payload` | JSON NULL | 指令參數 (如: `{"slot_no": "A01", "num": 50}`) | — |
|
|
||||||
| `ttl` | INT DEFAULT 60 | 指令失效秒數 (尤其針對遠端出貨) | — |
|
|
||||||
| `executed_at` | TIMESTAMP NULL | 執行時間 | — |
|
|
||||||
| `timestamps` | — | — | — |
|
|
||||||
|
|
||||||
> 對應 B010 遠端指令（reboot, lock, unlock, checkout, dispense 等）以及 B055 遠端出貨。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🆕 `coin_inventories` — 零錢機庫存
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 | 來源 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — | — |
|
|
||||||
| `machine_id` | BIGINT FK | → machines | B220 `machine` |
|
|
||||||
| `value_1` | INT DEFAULT 0 | 1 元 | B220 |
|
|
||||||
| `value_5` | INT DEFAULT 0 | 5 元 | B220 |
|
|
||||||
| `value_10` | INT DEFAULT 0 | 10 元 | B220 |
|
|
||||||
| `value_50` | INT DEFAULT 0 | 50 元 | B220 |
|
|
||||||
| `value_100` | INT DEFAULT 0 | 100 元 | B220 |
|
|
||||||
| `value_500` | INT DEFAULT 0 | 500 元 | B220 |
|
|
||||||
| `value_1000` | INT DEFAULT 0 | 1000 元 | B220 |
|
|
||||||
| `operator` | VARCHAR NULL | 操作人 (0=消費者) | B220 `account` |
|
|
||||||
| `timestamps` | — | — | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🆕 `timer_statuses` — 計時器狀態
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 | 來源 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — | — |
|
|
||||||
| `machine_id` | BIGINT FK | → machines | B710 `req2` |
|
|
||||||
| `slot_no` | VARCHAR | 貨道 ID | B710 `cid` |
|
|
||||||
| `product_id` | BIGINT FK NULL | → products (0=未設定) | B710 `pid` |
|
|
||||||
| `status` | TINYINT | 0:未啟用/1:使用中/2:異常 | B710 `status` |
|
|
||||||
| `remaining_seconds` | INT | 剩餘秒數 | B710 `num` |
|
|
||||||
| `timestamps` | — | — | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 🆕 `payment_types` — 金流類型參照
|
|
||||||
|
|
||||||
| 欄位 | 類型 | 說明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `id` | BIGINT PK | — |
|
|
||||||
| `code` | SMALLINT UNIQUE | 金流代碼 (1,2,3...120) |
|
|
||||||
| `name` | VARCHAR | 中文名稱 |
|
|
||||||
| `category` | VARCHAR | 大分類 |
|
|
||||||
| `is_active` | BOOLEAN | 是否啟用 |
|
|
||||||
| `timestamps` | — | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 五、IoT API 路由設計
|
|
||||||
|
|
||||||
### 5.1 路由結構
|
|
||||||
|
|
||||||
```php
|
|
||||||
// routes/api.php
|
|
||||||
Route::prefix('v1/app')->middleware(['throttle:iot'])->group(function () {
|
|
||||||
|
|
||||||
// B010 - 機台狀態上傳 & 指令撈回
|
|
||||||
Route::post('/machine/status', [MachineStatusController::class, 'heartbeat']);
|
|
||||||
|
|
||||||
// B017 - 遠端撈庫存
|
|
||||||
Route::post('/machine/reload', [MachineStockController::class, 'reload']);
|
|
||||||
|
|
||||||
// B055 - 遠端出貨
|
|
||||||
Route::post('/machine/dispense', [DispenseController::class, 'getCommands']);
|
|
||||||
Route::put('/machine/dispense', [DispenseController::class, 'updateStatus']);
|
|
||||||
|
|
||||||
// B220 - 零錢機庫存
|
|
||||||
Route::post('/coin/inventory', [CoinInventoryController::class, 'store']);
|
|
||||||
|
|
||||||
// B600 - 消費金流
|
|
||||||
Route::post('/transaction', [TransactionController::class, 'store']);
|
|
||||||
|
|
||||||
// B601 - 發票回傳
|
|
||||||
Route::post('/invoice', [InvoiceController::class, 'store']);
|
|
||||||
|
|
||||||
// B602 - 出貨回傳
|
|
||||||
Route::post('/dispense-record', [DispenseRecordController::class, 'store']);
|
|
||||||
|
|
||||||
// B650 - 驗證會員
|
|
||||||
Route::post('/member/verify', [MemberVerifyController::class, 'verify']);
|
|
||||||
|
|
||||||
// B710 - 計時器狀態
|
|
||||||
Route::post('/timer/status', [TimerStatusController::class, 'sync']);
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
### 5.2 處理管線
|
|
||||||
|
|
||||||
> [!IMPORTANT]
|
|
||||||
> 遵循 IoT 通訊技能規範：**嚴禁** API Controller 直接寫入 DB。
|
|
||||||
|
|
||||||
| API | 處理方式 | 原因 |
|
|
||||||
|-----|----------|------|
|
|
||||||
| B010 | **異步** (Redis Queue) | 最高頻，每台數秒一次 |
|
|
||||||
| B017 | **同步** (直接回應) | 低頻，需即時回傳庫存數據 |
|
|
||||||
| B055 GET | **同步** | 需即時回傳指令列表 |
|
|
||||||
| B055 PUT | **異步** | 出貨結果可背景處理 |
|
|
||||||
| B220 | **異步** | 庫存變動日誌可背景寫入 |
|
|
||||||
| B600 | **異步** | 高頻交易，核心數據 |
|
|
||||||
| B601 | **異步** | 發票資訊可背景寫入 |
|
|
||||||
| B602 | **異步** | 出貨紀錄可背景寫入 |
|
|
||||||
| B650 | **同步** | 需即時回傳驗證結果與折抵金額 |
|
|
||||||
| B710 | **異步** | 計時器狀態批量更新 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 六、後台模組 ↔ 資料表對應
|
|
||||||
|
|
||||||
| 後台模組（web.php） | 對應資料表 | 資料來源 API |
|
|
||||||
|---------------------|-----------|-------------|
|
|
||||||
| 1. 儀表板 Dashboard | orders, machines, dispense_records | 統計彙整 |
|
|
||||||
| 2. 會員管理 Members | members, social_accounts, member_wallets... | B650 |
|
|
||||||
| 3. 機台管理 Machines | machines, machine_logs, machine_slots | B010, B017 |
|
|
||||||
| 4. APP 管理 App | app_configs, timer_statuses | B710 |
|
|
||||||
| 5. 倉庫管理 Warehouses | products, machine_slots | B017, B602 |
|
|
||||||
| 6. 銷售管理 Sales | orders, order_items, dispense_records | B600, B602 |
|
|
||||||
| 7. 分析管理 Analysis | orders, dispense_records, coin_inventories | 全部 |
|
|
||||||
| 8. 稽核管理 Audit | orders, dispense_records | B600, B602 |
|
|
||||||
| 9. 資料設定 DataConfig | products, payment_types, users | — |
|
|
||||||
| 10. 遠端管理 Remote | remote_commands | B010, B055 |
|
|
||||||
| 11. Line 管理 | members (Line 綁定) | — |
|
|
||||||
| 12. 預約系統 Reservation | （未來擴充） | — |
|
|
||||||
| 13. 特殊權限 SpecialPerm | machines, app_configs | — |
|
|
||||||
| 14. 權限設定 Permission | users, roles | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 七、效能預估與應對
|
|
||||||
|
|
||||||
### 10,000 台機台的流量預估
|
|
||||||
|
|
||||||
| API | 頻率 | 每秒請求量 (QPS) | 每日資料量 |
|
|
||||||
|-----|------|-----------------|-----------|
|
|
||||||
| B010 心跳 | 每 5 秒/台 | **~2,000** | ~173M 筆 |
|
|
||||||
| B600 金流 | 每筆交易 | ~10-50 | ~50K-200K 筆 |
|
|
||||||
| B602 出貨 | 每筆交易 | ~10-50 | ~50K-200K 筆 |
|
|
||||||
| B710 計時器 | 每 10 秒/台 | ~1,000 | ~86M 筆 |
|
|
||||||
|
|
||||||
### 應對策略
|
|
||||||
|
|
||||||
| 策略 | 實作方式 |
|
|
||||||
|------|----------|
|
|
||||||
| **Redis Queue 異步寫入** | 所有高頻 API 進 Queue，Worker 批量寫入 |
|
|
||||||
| **心跳資料瘦身** | B010 不逐筆寫 DB，僅更新 `machines` 表的即時欄位 + 異常時寫 log |
|
|
||||||
| **資料分區** | `orders` 和 `dispense_records` 按月份分區 |
|
|
||||||
| **索引策略** | 所有查詢欄位建立適當 INDEX（machine_id + created_at 複合索引） |
|
|
||||||
| **速率限制** | 單台機台 60 req/min，全站 100,000 req/min |
|
|
||||||
| **快取** | 機台列表、商品列表等低變動資料用 Redis Cache |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 八、實作路線圖與預估時程
|
|
||||||
|
|
||||||
> [!NOTE]
|
|
||||||
> 為了保持規劃書的簡潔，詳細的開發時程、甘特圖、子選單拆解與 Phase 任務清單已獨立至專屬文件。
|
|
||||||
|
|
||||||
👉 **[查看詳細開發時程規劃 (development_schedule.md)](file:///home/mama/projects/star-cloud/docs/development_schedule.md)**
|
|
||||||
|
|
||||||
本專案預計總開發時程為 **17 ~ 18 週** (約 85 個工作天)，分為三個主要階段：
|
|
||||||
1. **Phase 1 (5天)**：基礎建設與 IoT API 串接。
|
|
||||||
2. **Phase 2 (50天)**：後台核心營運管理介面 (含遠端與倉庫管理)。
|
|
||||||
3. **Phase 3 (30天)**：進階分析報表與垂直功能模組。
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 九、目錄結構建議
|
|
||||||
|
|
||||||
```
|
|
||||||
app/
|
|
||||||
├── Http/Controllers/
|
|
||||||
│ ├── Admin/ ← 後台管理（已存在 14 模組）
|
|
||||||
│ └── Api/V1/
|
|
||||||
│ ├── App/ ← 機台 IoT API（新增）
|
|
||||||
│ │ ├── MachineStatusController.php (B010)
|
|
||||||
│ │ ├── MachineStockController.php (B017)
|
|
||||||
│ │ ├── DispenseController.php (B055)
|
|
||||||
│ │ ├── CoinInventoryController.php (B220)
|
|
||||||
│ │ ├── TransactionController.php (B600)
|
|
||||||
│ │ ├── InvoiceController.php (B601)
|
|
||||||
│ │ ├── DispenseRecordController.php (B602)
|
|
||||||
│ │ ├── MemberVerifyController.php (B650)
|
|
||||||
│ │ └── TimerStatusController.php (B710)
|
|
||||||
│ ├── MemberController.php ← 會員 API（已存在）
|
|
||||||
│ └── MachineController.php ← 機台日誌（已存在）
|
|
||||||
├── Jobs/
|
|
||||||
│ └── Machine/ ← IoT 異步任務（新增）
|
|
||||||
│ ├── ProcessHeartbeat.php
|
|
||||||
│ ├── ProcessTransaction.php
|
|
||||||
│ ├── ProcessDispenseRecord.php
|
|
||||||
│ ├── ProcessInvoice.php
|
|
||||||
│ ├── ProcessCoinInventory.php
|
|
||||||
│ └── ProcessTimerStatus.php
|
|
||||||
├── Services/
|
|
||||||
│ └── Machine/ ← 業務邏輯（新增）
|
|
||||||
│ ├── HeartbeatService.php
|
|
||||||
│ ├── TransactionService.php
|
|
||||||
│ ├── DispenseService.php
|
|
||||||
│ └── MemberVerifyService.php
|
|
||||||
└── Models/
|
|
||||||
├── Machine/ ← 已存在
|
|
||||||
│ ├── Machine.php
|
|
||||||
│ └── MachineLog.php
|
|
||||||
├── Transaction/ ← 新增
|
|
||||||
│ ├── Order.php
|
|
||||||
│ ├── OrderItem.php
|
|
||||||
│ ├── Invoice.php
|
|
||||||
│ ├── DispenseRecord.php
|
|
||||||
│ └── PaymentType.php
|
|
||||||
├── Product/ ← 新增
|
|
||||||
│ ├── Product.php
|
|
||||||
│ └── ProductCategory.php
|
|
||||||
└── Member/ ← 已存在
|
|
||||||
```
|
|
||||||
@@ -1,65 +0,0 @@
|
|||||||
# B010 API (機台心跳與指令) 技術規範與執行指南
|
|
||||||
|
|
||||||
本文件整合了 B010 API 的業務邏輯討論與技術執行分析，作為 Star Cloud 實作機台通訊核心的指導準則。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 業務邏輯與指令下發 (Command Flow)
|
|
||||||
|
|
||||||
### 1.1 指令下發機制
|
|
||||||
B010 是 Cloud 向機台下達遠端指令（如：開鎖、重啟、改庫存）的唯一通道。
|
|
||||||
* **指令隊列**：指令需先寫入 `remote_commands` 表，狀態標記為 `pending`。
|
|
||||||
* **撈取邏輯**：當機台定期呼叫 B010 時，後端 Service 會查詢該機台是否有等待執行的指令。
|
|
||||||
* **回應處理**：若有指令，則在 Response 的 `status` 欄位回傳對應的指令碼（如 51:重啟, 70:開鎖）。
|
|
||||||
* **優先順序**：當同時有多個指令待執行時，需按緊急程度（如：重啟 > 開鎖 > 載入配置）定義優先順序回傳。
|
|
||||||
|
|
||||||
### 1.2 執行回饋 (Feedback Loop)
|
|
||||||
* **確認機制**：機台收到指令後，必須確保執行結果能回報至雲端。
|
|
||||||
* **判定方案**：
|
|
||||||
* **被動判定**：若機台在其後的 B010 心跳中回報狀態正常（如：軟體版本更新成功、頁面碼正確），即視為成功。
|
|
||||||
* **主動判定**：對於關鍵指令（如遠端出貨），機台需另外呼叫狀態更新 API (如 B055 PUT) 回報結果。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 執行面挑戰：高併發與效能 (Performance)
|
|
||||||
|
|
||||||
### 2.1 寫入瓶頸分析
|
|
||||||
* **數據規模**：10,000 台機台，每 10 秒一個心跳，全站 QPS 約 1,000。
|
|
||||||
* **DB 壓力**：直接同步寫入 MySQL `machines` 與 `machine_logs` 將導致磁碟 I/O 鎖定。
|
|
||||||
|
|
||||||
### 2.2 解決策略 (Redis 緩衝)
|
|
||||||
* **即時狀態流動**：
|
|
||||||
* **最後在線時間**、**溫度**、**門禁狀態**、**頁面碼** 等動態數據優先存入 **Redis**。
|
|
||||||
* **批量更新 (Lazy Update)**：每 1~5 分鐘由後台任務將 Redis 數據批量寫回 MySQL `machines` 表。
|
|
||||||
* **日誌優化**：
|
|
||||||
* **正常心跳不寫入資料庫日誌**，僅在**狀態變更**（如：門被打開、溫度過高、軟體報錯）時，才觸發資料庫日誌記錄。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 安全性與驗證策略 (Security)
|
|
||||||
|
|
||||||
* **API Key 遷移**：從目前全系統硬編碼的共用 Key，逐步遷移至每台機台專屬的 `api_token`。
|
|
||||||
* **驗證方式**：機台端需在 Header 帶入 `Authorization: Bearer <api_token>` 進行身份驗證。
|
|
||||||
* **實裝方式**：
|
|
||||||
* 後台管理介面新增「核發機台 Token」功能。
|
|
||||||
* 建立專屬 `IotAuthMiddleware`，驗證請求中的 Token 與 `machines` 表是否匹配。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 離線與告警機制 (Heartbeat Logic)
|
|
||||||
|
|
||||||
* **在線判定**：心跳超時超過 **30 秒** 即在 UI 將機台顯示為「離線」。
|
|
||||||
* **告警機制**：機台斷線時，系統需即時產出**警示或推播通知**給相關人員。
|
|
||||||
* **自動維護**：排程 Job 定期掃描 `machines.last_heartbeat_at`，處理長期失聯機台。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 業務邏輯細節 (Fine-grained Logic)
|
|
||||||
|
|
||||||
* **指令成功判定**：採「**被動判定**」。機台收到指令後，若在其後的 B010 心跳中回報狀態正確（如：頁面碼已變更），即視為指令執行成功。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 待確認事項 (已結案)
|
|
||||||
|
|
||||||
目前已根據 2026-03-12 的討論完成所有關鍵決策。
|
|
||||||
@@ -1,71 +0,0 @@
|
|||||||
# B017 API (遠端改庫存) 技術規範與執行指南
|
|
||||||
|
|
||||||
本文件記錄 B017 API 的業務邏輯與技術執行細節，用於指導後端管理系統遠端調整機台庫存的實作。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 業務情境與觸發機制 (Trigger)
|
|
||||||
|
|
||||||
### 1.1 觸發流程
|
|
||||||
1. **管理行為**：管理員在後台管理介面手動修改特定機台的貨道庫存數量。
|
|
||||||
2. **指令預備**：後端系統將異動請求寫入 `remote_commands` 表 (type: `stock_update`, payload 含貨道編號與數量)，並在該機台的 B010 (心跳) 回應中將 `status` 設為 `49` (reload B017)。
|
|
||||||
3. **機台拉取**：機台收到心跳回應中的 `49` 代碼後，主動呼叫 B017 API (`/api/app/machine/reload_msg/{workid}`)。
|
|
||||||
4. **數據同步**：機台獲取最新庫存數據並更新本地狀態。
|
|
||||||
|
|
||||||
### 1.2 更新範圍
|
|
||||||
* **全量更新 (Full Sync)**：B017 API 回傳該機台**所有貨道**的最新庫存數量，而非僅回傳變動部分。這有助於機台軟體進行「最終狀態一致性」的自我校正。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 資料一致性與日誌 (Consistency & Audit)
|
|
||||||
|
|
||||||
### 2.1 更新確認機制
|
|
||||||
* **隱式成功 (Implicit Success)**：機台更新本地庫存後不需要回傳明確的 B017 確認 API。
|
|
||||||
* **驗證方式**：系統將以機台下次呼叫 B010 回報的狀態或機台後續的正常銷售紀錄，視為前次更新成功。
|
|
||||||
|
|
||||||
### 2.2 管理員異動日誌 (Audit Log)
|
|
||||||
* **強制要求**：每次後台發起遠端改庫存操作，必須記錄於 `activity_logs` 或特定的 `stock_adjustment_logs`。
|
|
||||||
* *紀錄內容*：管理者 ID、執行時間、機台 ID、調整前後的貨道庫存對照。
|
|
||||||
|
|
||||||
### 2.3 庫存衝突處理
|
|
||||||
* *情境*：若雲端下發庫存更新時，機台現場同時發生實體銷售。
|
|
||||||
* *處理原則*：**詳見下方待確認事項**。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 執行面優化 (Execution Strategy)
|
|
||||||
|
|
||||||
### 3.1 Redis 緩衝與效能
|
|
||||||
* **快取策略**：機台的貨道結構與庫存數據應快取於 Redis 中。當管理員調整庫存時，同步更新 Redis 與 MySQL。
|
|
||||||
* **讀取優化**：B017 API 應直接從 Redis 讀取數據回傳給機台，以降低 MySQL 的查詢壓力。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 欄位定義與對照
|
|
||||||
|
|
||||||
| B017 欄位 | 資料庫對應 | 說明 |
|
|
||||||
|----------|------------|------|
|
|
||||||
| `channelid` | `machine_slots.slot_no` | 貨道編號 |
|
|
||||||
| `stock` | `machine_slots.stock` | 該貨道的最新庫存數量 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 開發建議
|
|
||||||
* 建立一個專屬的 `StockService` 來處理 Redis 與 DB 的同步，以及異動日誌的寫入。
|
|
||||||
* 在 `B010` 的回應邏輯中，檢查 `remote_commands` 是否有 pending 的庫存異動指令，以動態切換 `status: 49`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 庫存衝突處理原則
|
|
||||||
|
|
||||||
**以機台實際出貨為最終依據（最終一致性策略）**。
|
|
||||||
|
|
||||||
* **情境**：雲端下發庫存更新（如設為 50），同時機台現場發生實體銷售（賣出 2 個）。
|
|
||||||
* **處理原則**：機台在本地執行 `50 - 已出貨量 = 48`，並透過後續的 B602 出貨紀錄上報給雲端，雲端以此為最終庫存數字。
|
|
||||||
* **理由**：機台掌握實際出貨資訊，強制以雲端覆蓋將導致帳面庫存與實際庫存不符，引發空貨道但系統顯示有庫存的嚴重問題。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 待確認事項 (已結案)
|
|
||||||
|
|
||||||
所有關鍵決策已於 2026-03-12 完成確認。
|
|
||||||
@@ -1,67 +0,0 @@
|
|||||||
# B055 API (遠端出貨) 技術規範與執行指南
|
|
||||||
|
|
||||||
本文件定義 B055 API 的技術實作規範，用於處理從雲端發起的機台遠端出貨指令及其結果回饋。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 業務流程與通訊機制
|
|
||||||
|
|
||||||
### 1.1 指令下發流程
|
|
||||||
1. **指令生成**：Cloud 後端（管理者）在 `remote_commands` 表中建立一筆類型為 `dispense`、狀態為 `pending` 的指令。
|
|
||||||
2. **心跳通知**：在該機台的 B010 回應中，將 `status` 設為 `85` (reload B055)。
|
|
||||||
3. **機台撈取 (POST)**：機台呼叫 B055 POST API (`/api/app/machine/dispense/{workid}`) 取得詳細出貨參數（貨道 ID、指令 ID）。
|
|
||||||
4. **執行與回報 (PUT)**：機台嘗試出貨後，呼叫 B055 PUT API 回報出貨結果及剩餘庫存。
|
|
||||||
|
|
||||||
### 1.2 數據關聯 (Data Linking)
|
|
||||||
* **出貨紀錄整合**：遠端出貨成功後，系統必須在 `dispense_records` 表中同步存入一筆紀錄，並將 `source` 標記為 `remote`（或對應識別），確保後台報表包含所有實體出貨數據。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 指令資料定義：使用全域 `remote_commands`
|
|
||||||
|
|
||||||
遠端出貨指令統一存放在 `remote_commands` 表中，B055 的特定參數將存放於 `payload` (JSON) 欄位。
|
|
||||||
|
|
||||||
| 欄位 | B055 對應說明 | 備註 |
|
|
||||||
|------|--------------|------|
|
|
||||||
| `id` | 執行命令 ID | 用於追蹤單次指令 (POST 回傳) |
|
|
||||||
| `payload->slot_no` | 貨道 ID | 指派機台出貨的通道 |
|
|
||||||
| `status` | 執行狀態 | pending/sent/success/failed |
|
|
||||||
| `ttl` | 指令效期 | 預設 60 秒 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 執行面優化 (Execution Strategy)
|
|
||||||
|
|
||||||
* **Redis 隊列**：由於遠端出貨屬於高優先權操作，待執行指令應快取於 Redis 中，以確保機台呼叫 POST 時能即時回應。
|
|
||||||
* **異步處理**：機台 PUT 回報結果後，系統透過隊列更新 DB 狀態，並根據結果觸發後續邏輯（如扣除庫存、異動日誌）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 欄位定義與對照
|
|
||||||
|
|
||||||
| B055 欄位 | 資料庫對應 | 說明 |
|
|
||||||
|----------|------------|------|
|
|
||||||
| `command_id` | `remote_dispense_commands.id` | 指令唯一識別碼 |
|
|
||||||
| `slot_no` | `machine_slots.slot_no` | 目標貨道編號 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 業務邏輯細節建議
|
|
||||||
|
|
||||||
### 5.1 指令效期 (TTL)
|
|
||||||
* **建議設定**：**60 秒 (1 分鐘)**。
|
|
||||||
* **理由**：由於遠端出貨指令由管理員手動發起（通常用於現場故障排除或客訴處理），若機台因網路問題超過一分鐘未拉取指令，該次操作的情境通常已失效，應自動失效以防止後續無預警出貨。
|
|
||||||
|
|
||||||
### 5.2 失敗處理
|
|
||||||
* **機制**：機台回報出貨失敗時，系統僅需記錄結果並在後台顯示異常狀態。
|
|
||||||
* **處理原則**：考量目前僅供管理員手動發起，**不需執行自動退款**，由管理員依據日誌進行後續手動處理即可。
|
|
||||||
|
|
||||||
### 5.3 安全與權限
|
|
||||||
* **驗證機制**：維持 `api_token` 驗證，不需額外的加密簽名。
|
|
||||||
* **權限控制**：建議在 RBAC 權限系統中，限制僅「高級管理員」或「維修主管」具備發起遠端出貨的權限。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 待確認事項 (已結案)
|
|
||||||
|
|
||||||
所有關鍵決策已於 2026-03-12 完成確認。
|
|
||||||
@@ -1,60 +0,0 @@
|
|||||||
# B220 API (零錢機庫存變動) 技術規範與執行指南
|
|
||||||
|
|
||||||
本文件定義 B220 API 的技術實作規範，用於監控機台內的硬幣與鈔票庫存數量，並提供補幣紀錄與找零水位告警功能。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 業務情境與數據特性
|
|
||||||
|
|
||||||
### 1.1 數據採集
|
|
||||||
* **回報內容**：機台定期回報各面額（1, 5, 10, 50, 100, 500, 1000 元）的**當前累積總量 (Total Amount)**。
|
|
||||||
* **操作識別**：
|
|
||||||
* `account = 0`：消費者交易引起的庫存變動。
|
|
||||||
* `account != 0`：管理員或補貨員進行手動補幣或清空錢箱的操作。
|
|
||||||
|
|
||||||
### 1.2 報表與對帳
|
|
||||||
* **零錢庫存分析**：系統必須保留所有變動紀錄，以提供後台「分析報表 > 零錢庫存分析」選單顯示歷史庫存走勢與補幣紀錄。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 執行面優化與告警 (Execution & Alerts)
|
|
||||||
|
|
||||||
### 2.1 數據處理頻率
|
|
||||||
* **回報時機**：機台在**每次交易完成後**（包含消費者找零或管理員補幣）即時呼叫 B220 API 回報最新庫存。
|
|
||||||
* **快取策略**：機台各面額的最新總量應快取於 Redis 或更新至 `machines` 表的擴充欄位，供後台儀表板即時監看。
|
|
||||||
* **寫入過濾**：為節省儲存空間，僅在資料數值有實際變動時才寫入 `coin_inventory_logs`。
|
|
||||||
|
|
||||||
### 2.2 找零不足告警 (Low Inventory Warning)
|
|
||||||
|
|
||||||
當特定面額低於預設的水位閾值時，系統將觸發告警。
|
|
||||||
|
|
||||||
#### **建議水位告警計畫 (Threshold Plan)**
|
|
||||||
| 面額 | 告警閾值 (枚數) | 說明 |
|
|
||||||
|------|----------------|------|
|
|
||||||
| 1 元 | < 50 | 找零頻率高，需預留較快補幣空間 |
|
|
||||||
| 5 元 | < 40 | |
|
|
||||||
| 10 元| < 40 | 主要找零面額，需重點監控 |
|
|
||||||
| 50 元| < 20 | |
|
|
||||||
| 100 元以上 | — | 通常不作為找零面額，僅供庫存監控 |
|
|
||||||
|
|
||||||
* **通知管道**：
|
|
||||||
1. **後台儀表板**：在機台管理介面顯示顯眼的「紅字告警」。
|
|
||||||
2. **系統推播**：即時發送通知給相關營運或補貨人員。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 資料庫結構：`coin_inventory_logs`
|
|
||||||
|
|
||||||
| 欄位 | 說明 | 備註 |
|
|
||||||
|------|------|------|
|
|
||||||
| `machine_id` | 機台關聯 ID | |
|
|
||||||
| `value_x` | 各面額數量 | 包含 1, 5, 10, 50, 100, 500, 1000 |
|
|
||||||
| `account` | 操作人識別 | 0 為消費者，其餘為管理員 |
|
|
||||||
| `created_at` | 紀錄時間 | |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 待確認事項 (已結案)
|
|
||||||
|
|
||||||
所有關鍵決策已於 2026-03-12 完成確認並由系統規劃水位計畫。
|
|
||||||
|
|
||||||
@@ -1,62 +0,0 @@
|
|||||||
# B600 API (消費金流回傳) 技術規範與執行指南
|
|
||||||
|
|
||||||
本文件定義 B600 API 的技術實作規範，這是系統處理金流交易、訂單生成與跨 API 關聯的核心。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 交易生命週期與 `flow_id` 串聯
|
|
||||||
|
|
||||||
為確保一筆交易數據的完整性，系統採用 `flow_id` 串聯三個連續上報的 API：
|
|
||||||
|
|
||||||
1. **B600 (金流上報)**：
|
|
||||||
* 機台於支付成功後即時呼叫。
|
|
||||||
* 雲端收到後產出專屬的 `flow_id` 並回傳給機台。
|
|
||||||
2. **B601 (發票上報)**：
|
|
||||||
* 機台開立發票後，攜帶 B600 取得的 `flow_id` 呼叫。
|
|
||||||
* 系統根據 `flow_id` 將發票資訊與 `orders` 表關聯。
|
|
||||||
3. **B602 (出貨上報)**：
|
|
||||||
* 機台實體出貨後，攜帶 `flow_id` 呼叫。
|
|
||||||
* 系統根據 `flow_id` 更新訂單的出貨狀態。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 金流類型與標準化
|
|
||||||
|
|
||||||
### 2.1 類型定義
|
|
||||||
根據 B600 PDF 文件規範 (Req3)，系統優先採用以下預定義類型進行處理與對帳。
|
|
||||||
|
|
||||||
### 2.2 防重複上報 (Idempotency)
|
|
||||||
為防止網路不穩導致機台重複呼叫 B600，系統必須使用機台產生的 `order_no (tid)` 結合 `machine_id` 作為唯一鍵值校驗。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 執行面優化：異步隊列 (Async Queue)
|
|
||||||
|
|
||||||
在高併發環境下，為確保機台端不因等待資料庫寫入而時耗，B600 採以下流程：
|
|
||||||
|
|
||||||
1. **即時回應**：API 接收請求後，將原始 JSON 派發至 **Redis Queue**。
|
|
||||||
2. **背景處理**：由 `ProcessTransaction` 任務異步執行：
|
|
||||||
* 建立 `orders` 與 `order_items`。
|
|
||||||
* 計算並異動會員點數/優惠券。
|
|
||||||
* 同步更新儀表板統計數據。
|
|
||||||
3. **異步回傳**：機台呼叫 API 後會收到 `202 Accepted`，`flow_id` 則透過回應檔同步回傳。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 數據完整性與異常處理 (Integrity & Exceptions)
|
|
||||||
|
|
||||||
### 4.1 自動對帳機制 (Auto-Reconciliation)
|
|
||||||
* **機制**：系統後台需建立定期定時任務（Scheduled Task），比對同一 `flow_id` 下的以下數據：
|
|
||||||
- **B600 (收取金額)**：訂單總計金額。
|
|
||||||
- **B602 (出貨總價值)**：機台實際出貨商品之總價值。
|
|
||||||
* **異常標記**：若兩者金額不符（例如：付了 $50 但僅出貨 $0 或 $30），系統應自動將該訂單標記為 **「金額異常」**，並同步產出警示通知供營運人員手動稽核。
|
|
||||||
|
|
||||||
### 4.2 出貨失敗處理 (Dispense Failure)
|
|
||||||
* **原則**：若 B602 回報「出貨失敗」，系統**不觸發自動退款**程序。
|
|
||||||
* **處理流程**：系統僅記錄失敗狀態並維持訂單為「待處理/異常」，後續由客服或管理員介入，根據實際情況進行人工退款、補發指令或現場處理。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 待確認事項 (已結案)
|
|
||||||
|
|
||||||
所有關鍵決策已於 2026-03-12 完成確認。
|
|
||||||
@@ -1,49 +0,0 @@
|
|||||||
# B601 API (發票資訊回傳) 技術規範與執行指南
|
|
||||||
|
|
||||||
本文件定義 B601 API 的技術實作規範，用於紀錄每筆訂單對應的電子發票資訊。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 業務流程與角色定義
|
|
||||||
|
|
||||||
### 1.1 系統角色
|
|
||||||
* **機台端**：負責與電子發票系統對接、開立發票，並於取得發票號碼後將資訊回傳至雲端。
|
|
||||||
* **雲端 (Star Cloud)**：僅負責**紀錄 (Logging)** 發票資訊，不涉及上傳傳財政部平台或寄送中獎通知。
|
|
||||||
|
|
||||||
### 1.2 串聯機制
|
|
||||||
* **關聯 ID**：必須攜帶 B600 取得的 `flow_id`，以便將發票資訊正確掛載至對應的 `orders`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 資料庫結構：`invoices`
|
|
||||||
|
|
||||||
為符合台灣發票規範，除了原始 PDF 欄位外，本系統將擴充相關稅務欄位：
|
|
||||||
|
|
||||||
| 欄位 | 說明 | 備註 |
|
|
||||||
|------|------|------|
|
|
||||||
| `order_id` | 訂單關聯 ID | 透過 `flow_id` 對應 |
|
|
||||||
| `invoice_no` | 發票號碼 | 例：AB-12345678 |
|
|
||||||
| `invoice_date` | 發票日期 | |
|
|
||||||
| `random_number` | 隨機碼 | 4 位數 |
|
|
||||||
| `love_code` | 愛心碼 | 捐贈碼 |
|
|
||||||
| `business_tax_id` | **公司統編** | 8 位數 |
|
|
||||||
| `carrier_id` | **載具編號** | 手機條碼或自然人憑證 |
|
|
||||||
| `carrier_type` | **載具類型** | |
|
|
||||||
| `status` | **發票狀態** | 1:有效, 0:作廢 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 發票作廢機制 (Invoice Voiding)
|
|
||||||
|
|
||||||
* **需求確認**：當交易發生退款或特定失敗情境時，機台端需具備回報「發票作廢」的能力。
|
|
||||||
* **API 實作**：
|
|
||||||
* **方法一**：呼叫 B601 POST 時帶入 `status = 0`。
|
|
||||||
* **方法二**：新增 `/api/app/B601/void` 專屬端點（待後續細化）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 待確認事項 (已結案)
|
|
||||||
|
|
||||||
所有關於發票關聯邏輯與重試機制的技術決策已於 2026-03-12 完成確認：
|
|
||||||
1. **發票缺失標記**：系統不需針對 B600 與 B601 的到達時差進行「發票缺失」自動標記。
|
|
||||||
2. **重試機制**：機台端呼叫失敗時不需額外的緩存與重傳策略（維持基本回報邏輯）。
|
|
||||||
@@ -1,57 +0,0 @@
|
|||||||
# B602 API (出貨回傳) 技術規範與執行指南
|
|
||||||
|
|
||||||
本文件定義 B602 API 的技術實作規範，用於紀錄機台實體出貨結果，並作為訂單完結與庫存校準的依據。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 業務邏輯與交易完結
|
|
||||||
|
|
||||||
### 1.1 串聯機制
|
|
||||||
* **關聯 ID**：必須攜帶 B600 取得的 `flow_id`，以確保出貨紀錄正確鏈結至對應的 `orders`。
|
|
||||||
|
|
||||||
### 1.2 多品項交易處理 (Multi-item Orders)
|
|
||||||
* **一對多關係**：系統支持一筆訂單（同一個 `flow_id`）對應多筆 `dispense_records`。
|
|
||||||
* **上報方式**：機台每完成一個貨道之出貨即呼叫一次 B602。雲端後端將自動彙整所有關聯之出貨紀錄以計算該訂單之總體狀態。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 庫存一致性機制 (Stock Consistency)
|
|
||||||
|
|
||||||
為確保雲端與機台端的物理庫存同步，系統採以下策略：
|
|
||||||
|
|
||||||
1. **強制信任機制**：系統將「強制信任」機台在 B602 中回報的 `remaining_stock` (絕對值)，並直接更新資料庫中的貨道庫存。
|
|
||||||
2. **異常監控**：若機台回報的庫存與系統計算的預期值（原值 - 1）不符時，系統應於後台標記該次出貨為「庫存異動異常」，供管理員檢查是否發生卡貨或漏貨。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 資料庫結構：`dispense_records`
|
|
||||||
|
|
||||||
| 欄位 | 說明 | 備註 |
|
|
||||||
|------|------|------|
|
|
||||||
| `order_id` | 訂單 ID | 透過 `flow_id` 關聯 |
|
|
||||||
| `product_id` | 商品 ID | 出貨之商品 |
|
|
||||||
| `slot_no` | 貨道編號 | 出貨之貨道 |
|
|
||||||
| `dispense_status` | 出貨狀態 | 0: 成功, 1: 失敗 |
|
|
||||||
| `remaining_stock` | 剩餘庫存 | 機台回報之絕對值 |
|
|
||||||
| `source` | 來源標記 | `local` (B602), `remote` (B055) |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 數據完整性與異常處理 (Integrity & Exceptions)
|
|
||||||
|
|
||||||
### 4.1 出貨超時監控 (Dispense Timeout)
|
|
||||||
* **閾值建議**：若系統收到 B600 (金流) 超過 **5 分鐘** 仍未收到任何對應之 B602 (出貨回報)，雲端後台應自動將該訂單標記為 **「出貨超時」**。
|
|
||||||
* **用途**：此狀態主要用於輔助對帳，標記可能發生網路中斷或機台異常卡死之交易，需由管理員介入核實。
|
|
||||||
|
|
||||||
### 4.2 出貨失敗處理 (Dispense Failure)
|
|
||||||
* **狀態遷移**：當 B602 回報 `dispense_status = 1` (失敗) 時，訂單狀態應更新為 **「出貨失敗」**。
|
|
||||||
* **即時通知**：系統應立即產出 **「後台警示通知」** 並推播給營運人員，以便快速處理現場排礙或後續補償。
|
|
||||||
* **補償與維護策略 (現階段)**：
|
|
||||||
- **點數/優惠券**：目前不採自動退回機制，維持異常狀態由管理員人工處理。
|
|
||||||
- **營運維護**：目前暫不自動產出維護工單或推播給補貨員，僅紀錄於異常日誌並顯示於後台通知區。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 待確認事項 (已結案)
|
|
||||||
|
|
||||||
所有關於出貨流程與超時判定之技術決策已於 2026-03-12 完成確認。
|
|
||||||
@@ -1,46 +0,0 @@
|
|||||||
# [暫緩執行] B650 API (會員/點數/取貨碼驗證) 技術規範與執行指南
|
|
||||||
|
|
||||||
本文件定義 B650 API 的技術實作規範，用於處理會員驗證、點數折抵、優惠券兌換、取貨碼驗證以及線上訂單線下結帳等多元功能。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 業務功能與驗證類型 (req6)
|
|
||||||
|
|
||||||
根據 API 請求中的 `req6` 欄位，B650 提供以下驗證模式：
|
|
||||||
|
|
||||||
| req6 | 說明 | 核心流程 |
|
|
||||||
|------|------|----------|
|
|
||||||
| `0` | 點擊商品驗證 | 驗證會員資格與點數餘額 |
|
|
||||||
| `1` | 會員純驗證 | 僅確認會員身份是否有效 |
|
|
||||||
| `2` | 會員兌換商品清單 | 撈取該會員可使用的兌換券或贈品清單 |
|
|
||||||
| `3` | 線上訂單線下結帳 | 驗證取貨碼或訂單編號 |
|
|
||||||
| `4` | 會員贈品 | 處理行銷活動贈品領取 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 執行面機制 (Execution Strategy)
|
|
||||||
|
|
||||||
* **高可用性請求**：由於會員驗證通常發生在交易前夕，API 必須具備極速響應能力，建議與第三方系統（若有）採用高效能通訊協議。
|
|
||||||
* **Response 狀態碼校驗**：系統必須嚴格遵守 PDF 定義的狀態碼（如 `101` 全額折抵, `104` 線上訂單驗證成功, `30` 會員使用中等）進行前端反饋。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 待確認事項 (To-be-confirmed)
|
|
||||||
|
|
||||||
以下議題目前皆列為**待確認**，將於 Phase 2 或後續討論中釐清：
|
|
||||||
|
|
||||||
### 3.1 會員系統架構 (Architecture)
|
|
||||||
1. **資料主體**：Star Cloud 是直接管理會員資料庫，還是僅作為轉發請求至第三方 CRM 的代理伺服器？
|
|
||||||
|
|
||||||
### 3.2 安全與防雙重消費 (Security)
|
|
||||||
2. **鎖定機制**：是否需要在 Redis 實作「會員操作 Session」，防止同一帳號在多台機台同時扣點 (狀態碼 30)？
|
|
||||||
3. **Token 時效**：回傳之 `userToken` 的有效期與刷新機制。
|
|
||||||
|
|
||||||
### 3.3 線上/線下整合流程
|
|
||||||
4. **訂單轉換**：驗證取貨碼成功後，雲端是否應自動產出對應的銷售紀錄單？
|
|
||||||
|
|
||||||
### 3.4 扣點邏輯
|
|
||||||
5. **預扣 vs 實扣**：點數與優惠券應於 B650 驗證時預先鎖定，還是待 B602 出貨成功後才正式扣除？
|
|
||||||
|
|
||||||
### 3.5 界面展示需求
|
|
||||||
6. **商品資訊**：當 `req6 = 2` 時，回傳的產品清單是否需要包含圖片或詳細描述供機台屏幕顯示？
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user