[REFACTOR] 實作側邊欄與儀表板多語系化,修復 UI 位移與樣式優化
All checks were successful
star-cloud-deploy-demo / deploy-demo (push) Successful in 52s

This commit is contained in:
2026-03-12 17:42:57 +08:00
parent 8ee14eaa29
commit 773396fc90
43 changed files with 1928 additions and 650 deletions

View File

@@ -343,9 +343,10 @@ Spatie 預設的 roles 表必須加上多租戶設計,確保留戶只能管理
|------|------|------|------|
| `id` | BIGINT PK | — | — |
| `machine_id` | BIGINT FK | → machines | — |
| `command_type` | VARCHAR(20) | 指令類型 | B010 response status |
| `command_type` | VARCHAR(50) | 指令類型 (reboot, lock, stock_update, dispense...) | B010, B017, B055 |
| `status` | ENUM | pending/sent/success/failed | — |
| `payload` | JSON NULL | 指令附加資料 | — |
| `payload` | JSON NULL | 指令參數 (如: `{"slot_no": "A01", "num": 50}`) | — |
| `ttl` | INT DEFAULT 60 | 指令失效秒數 (尤其針對遠端出貨) | — |
| `executed_at` | TIMESTAMP NULL | 執行時間 | — |
| `timestamps` | — | — | — |
@@ -503,76 +504,15 @@ Route::prefix('v1/app')->middleware(['throttle:iot'])->group(function () {
## 八、實作路線圖與預估時程
> **總結報告**:為確保開發品質與應對突發狀況,本專案預計總開發時程擴展為 **16 - 18 週**。以 1 人天 = 8 小時純開發時間計算,預估總投入約 **80 - 90 個工作天**
> [!NOTE]
> 為了保持規劃書的簡潔,詳細的開發時程、甘特圖、子選單拆解與 Phase 任務清單已獨立至專屬文件。
### 🗓️ 專案開發甘特圖 (自動排除週末)
👉 **[查看詳細開發時程規劃 (development_schedule.md)](file:///home/mama/projects/star-cloud/docs/development_schedule.md)**
```mermaid
gantt
title Star Cloud 實作時程規劃
dateFormat YYYY-MM-DD
excludes weekends
section 第一階段 MVP
Phase 1 基礎設施與資料表 :active, p1, 2026-03-11, 14d
Phase 2 IoT API 與異步管線 :p2, after p1, 24d
Phase 3 後台 MVP 頁面整合 :p3, after p2, 18d
section 第二階段 進階
Phase 4 進階功能與報表分析 :p4, after p3, 30d
```
### 📅 詳細時程對照表
| 階段 (Phase) | 關鍵任務摘要 | 預估天數 | 預計工作日期 | 狀態 |
| :--- | :--- | :---: | :---: | :---: |
| **Phase 1** | 基礎架構、28張表設計、資料遷移基礎 | 14 工作天 | 03/11 ~ 03/30 | 準備啟動 |
| **Phase 2** | B010~B710 核心 API、Redis 異步 Job、Service | 24 工作天 | 03/31 ~ 05/01 | 規劃中 |
| **Phase 3** | 儀表板、機台/銷售/遠端管理 MVP 介面 | 18 工作天 | 05/04 ~ 05/27 | 規劃中 |
| **Phase 4** | 數據分析統計圖表、補貨演算法、自動對帳模組 | 30 工作天 | 05/28 ~ 07/08 | 規劃中 |
---
### 🔵 第一階段MVP 營運核心 (最優先上線)
**目標**:確保機台金流與指令能穩定連通,完成基礎營運管理功能。
#### Phase 1基礎設施與核心資料表 (預計: 14 工作天)
- [ ] 擴充 `machines`serial_no, model 等欄位)
- [ ] 建立 多租戶與權限基礎表 (`companies`, `spatie/laravel-permission` 相關表)
- [ ] 將 `company_id` 欄位加入 `users`, `machines`, `roles` 等核心表
- [ ] 建立 `translations` 多語系字典表,並擴充 `products` 語系關聯
- [ ] 新增 `products` + `product_categories`
- [ ] 新增 `machine_slots`
- [ ] 新增 `orders` + `order_items`
- [ ] 新增 `invoices` + `dispense_records`
- [ ] 新增 `remote_commands` 表 (遠端管理與對接用)
- [ ] 新增 `payment_types` 表 + Seeder
#### Phase 2核心營運 IoT API 與異步管線 (預計: 24 工作天)
- [ ] 實作 **B010** API (心跳上報 + 狀態更新 + 遠端管理)
- [ ] 實作 **B017 / B055** API (遠端改庫存/出貨)
- [ ] 實作 **B600 / B601 / B602** API (金流/發票/出貨紀錄)
- [ ] 實作 **B650** API (會員驗證 + 點數折抵)
- [ ] 建立上述對應的 **Redis Queue Job + Service** 異步處理邏輯
#### Phase 3後台 MVP 頁面整合 (預計: 18 工作天)
- [ ] **多租戶權限與身份切換機制 (Middleware & Views)**
- [ ] 儀表板 Dashboard即時數據看板 (營收、機台數,依據租戶隔離資料)
- [ ] 機台管理 Machines連線狀態、貨道庫存、指令操作 UI
- [ ] 銷售管理 Sales訂單列表、出貨/發票追蹤
- [ ] 系統基礎設定:帳號與權限設定 (RBAC UI)、商品建檔、金流代碼設定、**多語系字典維護介面**
---
### 🟢 第二階段:進階營運與智慧分析 (持續優化)
**目標**:強化報表分析能力與自動化稽核。
#### Phase 4進階功能與報表分析模組 (預計: 30 工作天)
- [ ] **分析管理 Analysis**:趨勢圖、商品熱銷分析、機台產能報表
- [ ] **倉庫管理 Warehouses**:補貨建議、入/出庫流程優化
- [ ] **擴充支持**B220 (零錢機) + B710 (計時器) 支援
- [ ] **自動化稽核 Audit**:對帳機制、異常提醒
- [ ] **行銷模組**Line 聯動、預約系統、UI 動態設定
本專案預計總開發時程為 **17 ~ 18 週** (約 85 個工作天),分為三個主要階段:
1. **Phase 1 (5天)**:基礎建設與 IoT API 串接。
2. **Phase 2 (50天)**:後台核心營運管理介面 (含遠端與倉庫管理)。
3. **Phase 3 (30天)**:進階分析報表與垂直功能模組。
---