DDD 架構輔助技能

描述

確保前後端程式碼遵循 DDD 架構與 DAL 分離原則。

觸發條件

• 「建立新功能」「新增模組」
• 「架構檢查」
• 建立新檔案時自動檢查
• 「前端架構」「後端架構」

法規依據

• 憲法：CONSTITUTION.md 第 1、2 條
• 子法：.github/bylaws/ddd-architecture.md

---

🔧 後端 DDD 結構 (Python/Go/Rust)

新功能腳手架

當建立新功能時，自動生成 DDD 結構：

「新增 Order 領域」

生成：
src/
├── Domain/
│   ├── Entities/Order.py
│   ├── ValueObjects/OrderId.py
│   ├── Aggregates/OrderAggregate.py
│   └── Repositories/IOrderRepository.py
├── Application/
│   ├── UseCases/CreateOrder.py
│   └── DTOs/OrderDTO.py
└── Infrastructure/
    └── Persistence/Repositories/OrderRepository.py

層級職責

層級	職責	可依賴
Domain	業務規則、Entity、Value Object	無外部依賴
Application	Use Case、DTO、編排	Domain
Infrastructure	Repository 實作、外部 API	Domain
Presentation	API、CLI、UI	Application

---

⚛️ 前端 DDD 結構 (React/Vue)

React 專案結構

「新增 User 管理功能 (React)」

生成：
src/
├── domain/
│   ├── models/
│   │   └── User.ts              # Entity 類型定義
│   ├── types/
│   │   └── UserTypes.ts         # Value Object 類型
│   └── rules/
│       └── userValidation.ts    # 純業務規則（無框架依賴）
│
├── application/
│   ├── hooks/
│   │   └── useUser.ts           # 業務邏輯 Hook
│   ├── stores/
│   │   └── userStore.ts         # 狀態管理 (Zustand/Redux)
│   └── services/
│       └── UserService.ts       # 應用服務（編排）
│
├── infrastructure/
│   ├── api/
│   │   └── userApi.ts           # API Client (fetch/axios)
│   ├── storage/
│   │   └── userStorage.ts       # LocalStorage/SessionStorage
│   └── adapters/
│       └── userAdapter.ts       # API Response → Domain Model
│
└── presentation/
    ├── components/
    │   └── UserCard.tsx         # UI 元件
    ├── pages/
    │   └── UserListPage.tsx     # 頁面
    └── layouts/
        └── UserLayout.tsx       # 佈局

Vue 3 專案結構

「新增 Product 管理功能 (Vue)」

生成：
src/
├── domain/
│   ├── models/
│   │   └── Product.ts
│   ├── types/
│   │   └── ProductTypes.ts
│   └── rules/
│       └── productValidation.ts
│
├── application/
│   ├── composables/
│   │   └── useProduct.ts        # Composition API
│   ├── stores/
│   │   └── productStore.ts      # Pinia Store
│   └── services/
│       └── ProductService.ts
│
├── infrastructure/
│   ├── api/
│   │   └── productApi.ts
│   └── adapters/
│       └── productAdapter.ts
│
└── presentation/
    ├── components/
    │   └── ProductCard.vue
    ├── views/
    │   └── ProductListView.vue
    └── layouts/
        └── ProductLayout.vue

前端層級對照

層級	React	Vue 3	職責
Domain	models/, types/, rules/	同左	純 TypeScript，無框架
Application	hooks/, stores/	composables/, stores/	業務邏輯封裝
Infrastructure	api/, adapters/	同左	外部服務對接
Presentation	components/, pages/	components/, views/	UI 元件

---

🔍 架構違規檢查

後端違規

偵測並警告：

• ❌ Domain 層導入 Infrastructure
• ❌ 直接在 Domain 操作資料庫
• ❌ Application 層直接操作資料庫
• ❌ Repository 實作放在 Domain 層

前端違規

偵測並警告：

• ❌ Domain 層導入 React/Vue（應為純 TypeScript）
• ❌ 元件直接呼叫 API（應透過 hooks/composables）
• ❌ 將業務邏輯寫在元件內
• ❌ API Response 直接用於 UI（應經過 adapter 轉換）

依賴方向驗證

✅ Presentation → Application → Domain
✅ Infrastructure → Domain (實作介面)
❌ Domain → Infrastructure
❌ Domain → Application
❌ Domain → React/Vue/框架

---

📋 檢查範本

後端輸出

🏗️ DDD 架構檢查 (Backend)

✅ 依賴方向正確
✅ DAL 正確分離
⚠️ 警告：
  - src/Domain/Services/UserService.py:15
    導入了 Infrastructure 模組

建議：
  將資料庫操作移至 Repository

前端輸出

🏗️ DDD 架構檢查 (Frontend - React)

✅ Domain 層無框架依賴
✅ API 呼叫正確封裝於 infrastructure/
⚠️ 警告：
  - src/presentation/components/UserCard.tsx:23
    直接呼叫 fetch()，應使用 useUser hook

建議：
  將 API 呼叫移至 src/application/hooks/useUser.ts

---

🎯 快速生成指令

「建立後端 Order 領域」    → 生成 Python DDD 結構
「建立前端 User 功能」     → 詢問 React/Vue，生成對應結構
「架構檢查」               → 掃描全專案違規
「前端架構檢查」           → 僅掃描前端