iOS Clean Architecture

iOSアプリのクリーンアーキテクチャに基づくパッケージ構成と設計原則。

パッケージ依存図

                    ┌─────────────────┐
                    │  Presentation   │  SwiftUI Views, Components
                    └────────┬────────┘
                             │
    ┌───────────┬────────────┼────────────┬───────────┐
    ▼           ▼            ▼            ▼           ▼
┌────────┐ ┌────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐
│ State  │ │UseCases│ │Repository│ │ Services │ │  External    │
│        │ │        │ │          │ │          │ │  SPM (4)     │
└────┬───┘ └────┬───┘ └────┬─────┘ └────┬─────┘ └──────────────┘
     │          │    ↘     │      ↙     │
     │          └─────┬────┴──────┬─────┘
     │                ▼           │
     │       ┌──────────────┐     │
     └──────►│    Domain    │◄────┘
             └──────────────┘

注: UseCasesはRepository・Servicesの両方に依存可能。ServicesはDomainのみに依存。

ローカルパッケージ（6つ）

パッケージ	責務	依存先
Domain	ドメインモデル・値オブジェクト・列挙型	なし
Services	再利用可能なアプリケーションサービス（外部SDK連携等）	Domain のみ
Repository	API通信・データ永続化	Domain, APIClient
State	@Observable状態管理	Domain, Authentication
UseCases	ビジネスロジック（Protocol定義）	Domain, Repository, Services
Presentation	SwiftUI View・コンポーネント	全て

Services層の原則

• Domainのみに依存: Repositoryや他のパッケージへの依存は禁止
• 再利用可能: 複数のUseCaseから利用される共通機能を提供
• 外部SDK連携: HealthKit, CoreLocation, Analytics等のラッパー

no problem製外部SPM（4つ）

パッケージ	モジュール名	用途	使用レイヤー
swift-design-system	DesignSystem	テーマ・色・スペーシング・UIコンポーネント	Presentation
swift-authentication	Authentication	Firebase Auth統合（Google/Apple Sign-In）	State, Presentation
swift-ui-routing	UIRouting	型安全ナビゲーション（Router, TabPresenter）	Presentation
swift-api-client	APIClient	HTTP通信クライアント	Repository

依存ルール（厳守）

許可される依存

// ✅ Presentation → 全て（最上層）
import Domain
import State
import UseCases
import Repository
import DesignSystem
import UIRouting
import Authentication

// ✅ UseCases → Domain + Repository + Services
import Domain
import Repository
import Services

// ✅ State → Domain + Authentication
import Domain
import Authentication

// ✅ Repository → Domain + APIClient
import Domain
import APIClient

// ✅ Services → Domain（外部サービス連携）
import Domain

// ✅ Domain → なし（最下層）
// 外部依存ゼロ（Foundationのみ許可）

禁止される依存

// ❌ Domain層での外部import
import Foundation  // ✅ OK（標準ライブラリ）
import UIKit       // ❌ 禁止
import SwiftUI     // ❌ 禁止
import DesignSystem // ❌ 禁止

// ❌ 下位レイヤーから上位への参照
import Presentation // ❌ 循環依存

// ❌ UseCases → State
import State // ❌ 状態管理は上位レイヤーの責務

// ❌ Services → Repository（Servicesは独立性を保つ）
import Repository // ❌ ServicesはDomainのみに依存

設計違反チェックリスト

実装前に確認：

• Domain層にUI依存を追加していないか？
• Repositoryから直接Viewを参照していないか？
• UseCaseがStateを直接操作していないか？
• ServicesがRepositoryに依存していないか？
• 外部SPMを適切なレイヤーでのみ使用しているか？

詳細は REFERENCE.md を参照。