sky121113
a898873211
All checks were successful
ERP-Deploy-Production / deploy-production (push) Successful in 1m19s
34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
# 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)。
|