star-erp/CLAUDE.md

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。