# Star ERP 開發手冊

## 專案概述
- 技術棧：Laravel 12, React, Inertia.js, Tailwind CSS.
- 架構：模組化單體架構 (Modular Monolith).

## Git 分支管理規範 (嚴格遵守)
為了確保專案穩定性，請遵循以下分支流程：

1.  **Main 分支限制**：
    - `main` 分支僅限 Bug 修正 (`hotfix/*`) 與版本發布。
    - **禁止直接在 `main` 開發新功能**。
2.  **開發流程**：
    - **新功能**：一律在 `feature/*` 分支開發，合併至 `dev` 測試。
    - **修復 Bug (開發中)**：在 `bugfix/*` 分支開發。
    - **緊急修復 (生產環境)**：從 `main` 建立 `hotfix/*` 分支，修復後合併回 `main` 與 `dev`。
3.  **提交前標籤**：
    - `[FIX]`：Bug 修正
    - `[FEAT]`：新功能
    - `[DOCS]`：文件更新

## 開發指令
- 啟動環境：`./vendor/bin/sail up -d`
- 執行測試：`./vendor/bin/sail artisan test`
- 執行 Artisan 命令：`./vendor/bin/sail artisan ...`
- 前端編譯：`./vendor/bin/sail npm run dev`

## 程式碼風格
- PHP：遵循 PSR-12 規範。
- React：使用 Functional Components 與 Hooks，統一使用 Lucide-react。
- 翻譯：所有的說明、註解與 docstring 請使用**繁體中文**。

詳情請參閱 [GIT_WORKFLOW.md](./GIT_WORKFLOW.md)。