Star Cloud 智能販賣機管理平台
專案簡介 (Project Description)
Star Cloud 是一個專為智能販賣機設計的後台管理系統，旨在提供全方位的機台監控、庫存管理、銷售分析與會員管理功能。透過此平台，管理者可以即時掌握機台運營狀態，優化補貨流程，並透過數據分析提升營運效益。
技術棧 (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 官網 下載 Installer，或使用 XAMPP / Laragon 等整合環境。
1. 下載專案 (Clone Repository)
git clone <repository_url>
cd star-cloud
2. 安裝依賴套件 (Install Dependencies)
安裝後端 PHP 套件：
composer install
安裝前端 Node.js 套件：
npm install
3. 環境變數設定 (Environment Setup)
複製範例環境設定檔：
cp .env.example .env
請開啟 .env 檔案，並依照您的本地環境設定資料庫連線資訊：
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)：
php artisan key:generate
4. 資料庫遷移 (Database Migration)
執行 Migration 以建立資料庫結構：
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
或編譯生產環境檔案：
npm run build
6. 啟動伺服器 (Start Server)
啟動 Laravel 開發伺服器：
php artisan serve --port=8001
預設網址為：http://localhost:8001
主要功能模組
- 儀錶板 (Dashboard): 銷售數據概覽、機台狀態監控
- 機台管理 (Machine Management): 機台列表、遠端控制、日誌查詢
- 商品與庫存 (Inventory): 商品管理、進銷存、補貨單
- 銷售管理 (Sales): 交易紀錄、營收報表
- 權限設定 (Permissions): 角色與權限分配
© Star Cloud. All Rights Reserved.