dramaling-app/docs/04_technical/06_development
鄭沛軒 f8b47bdf5a refactor: rename web-native to web and complete architecture documentation
- Renamed /apps/web-native to /apps/web for cleaner project structure
- Updated all documentation references to use new path
- Completed architecture documentation review and standardization:
  - Updated all 5 architecture files to 2025 version
  - Ensured consistent frontend-backend separation strategy
  - Aligned multi-platform API design across all documents

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-10 18:22:25 +08:00
..
environment refactor: complete project structure reorganization and SOP implementation 2025-09-09 23:53:01 +08:00
README.md refactor: rename web-native to web and complete architecture documentation 2025-09-10 18:22:25 +08:00
issues-tracking.md refactor: complete project structure reorganization and SOP implementation 2025-09-09 23:53:01 +08:00

README.md

🔧 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 開發團隊