dramaling-app/docs/04_technical/06_development/README.md

96 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🔧 Development Tools & Processes
## 📁 目錄用途
`06_development` 資料夾專門存放**開發過程管理**相關的工具和文檔,與技術規格不同,這裡著重於:
- **開發過程中的問題追蹤和管理**
- **開發環境的設定和配置**
- **開發工具和流程的標準化**
## 📂 目錄結構
```
06_development/
├── README.md # 本目錄說明文檔
├── issues-tracking.md # 問題追蹤系統
└── environment/ # 開發環境設定
├── README.md # 環境設定總覽
└── xcode_setup_guide.md # Xcode 設定指南
```
## 📋 文檔說明
### 🎯 issues-tracking.md
**用途**: 專案開發過程中的問題追蹤和管理系統
**包含內容**:
- 問題分類和優先級定義
- 問題追蹤工作流程
- 開放問題的記錄和狀態追蹤
- 問題解決方案和決議記錄
**使用時機**:
- 發現規格衝突或不確定性
- 開發過程中遇到技術問題
- 需要團隊討論的技術決策
- 跨模組整合出現問題
### 🔧 environment/
**用途**: 開發環境設定和配置指南
**包含內容**:
- 開發環境統一標準
- 特定平台設定指南(如 Xcode
- 開發工具配置說明
- 環境問題排除方法
**使用時機**:
- 新成員加入專案
- 開發環境出現問題
- 需要統一開發工具設定
- 平台特定配置需求
## 🚀 文檔創建原則
### ✅ 應該創建的文檔
- **問題追蹤記錄**: 開發過程中遇到的具體問題
- **環境設定指南**: 開發環境配置和問題解決
- **工具配置文檔**: 開發工具的標準化設定
- **流程改進文檔**: 開發流程的優化和標準化
### ❌ 不應該放在此處的內容
- **技術規格文檔** → 應放在 `04_technical/` 的其他子目錄
- **用戶流程規格** → 應放在 `01_requirement/``02_design/`
- **API文檔** → 應放在 `04_technical/02_api/`
- **架構設計** → 應放在 `04_technical/01_architecture/`
## 🔄 與其他目錄的關係
| 目錄關係 | 說明 |
|---------|------|
| **vs `/sop/`** | SOP定義「如何工作」的規範06_development管理「開發中遇到的具體問題」 |
| **vs `03_development/`** | 03_development包含開發指南和標準06_development處理執行過程中的問題 |
| **vs `04_technical/其他`** | 其他技術目錄定義規格06_development管理實施過程中的障礙 |
## 📊 工作流程
### 問題發現 → 記錄追蹤
1. 在開發過程中發現問題
2.`issues-tracking.md` 中記錄
3. 分類、設定優先級和負責人
4. 追蹤解決進度
5. 記錄解決方案和結果
### 環境問題 → 文檔化解決
1. 遇到開發環境問題
2. 創建或更新環境設定文檔
3. 提供詳細的解決步驟
4. 確保其他開發者可以參考
---
**用途總結**: 此目錄是開發過程中的「實戰記錄」,專注於解決開發執行階段遇到的實際問題和環境配置需求。
**最後更新**: 2025-09-10
**維護者**: Drama Ling 開發團隊