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 を参照。