Koori ERP

本專案是一個基於 Laravel 12, Inertia.js (React) 與 Tailwind CSS 開發的 ERP 系統。

開發環境需求

• WSL2 (Windows 建議環境)
• Docker Desktop 或 Docker Engine
• PHP 8.5+ (本地端若需執行基礎 composer 指令，或直接使用 Sail 容器)
• Node.js 20+

啟動步驟

本專案使用 Laravel Sail 作為 Docker 開發環境。

1. 安裝依賴 (初次啟動)

如果您是第一次 clone 專案，請先安裝 PHP 與 JS 依賴：

# 安裝 PHP 依賴 (透過暫時的容器)
docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -w /var/www/html \
    laravelsail/php84-composer:latest \
    composer install --ignore-platform-reqs

# 初始化 .env 檔案
cp .env.example .env

# 生成 App Key
./vendor/bin/sail artisan key:generate

2. 啟動 Docker 容器

在專案根目錄執行：

# 背景執行容器
./vendor/bin/sail up -d

3. 資料庫遷移與初始化

./vendor/bin/sail artisan migrate
# (選填) 如果有種子資料
# ./vendor/bin/sail artisan db:seed

4. 啟動前端開發伺服器 (Vite)

./vendor/bin/sail npm install
./vendor/bin/sail npm run dev

啟動後，您可以透過以下連結瀏覽專案：

• 後台網址: http://localhost
• Vite 伺服器: http://localhost:5174

常用 Sail 指令

• 停止服務: ./vendor/bin/sail stop
• 執行 Artisan 指令: ./vendor/bin/sail artisan ...
• 執行 Composer 指令: ./vendor/bin/sail composer ...
• 執行測試: ./vendor/bin/sail test

技術棧

• Backend: Laravel 12
• Frontend: React (Functional Components) via Inertia.js
• Styling: Tailwind CSS
• Database: MySQL 8.0
• Cache/Session: Redis

開發規範

請參考專案內的開發文件或 AI 指導規則，確保 UI/UX 元件與後端邏輯符合專案架構。