[Xcode/Swift] iOSアーキテクチャ完全入門、有名どころの概念をざっくり理解する

MyApp
│
├── Model                ← アプリのデータ構造・状態（ビジネスロジックも含むことあり）
│   └── SampleEntity.swift
│
├── View                 ← UI画面（SwiftUI View / UIKit View）
│   └── SampleView.swift
│
├── Controller           ← 入力処理・状態更新・画面遷移など
│   └── SampleViewController.swift  （UIKit中心）
│
├── Service              ← API通信、永続化、その他外部依存処理
│   └── SampleService.swift
│
├── Resource             ← Assets, Localizable.strings, 設定ファイルなど
│   └── ...

// Model
struct Counter {
    var value = 0
}

// Controller
final class CounterViewController: UIViewController {
    private var counter = Counter()
    @IBOutlet private weak var label: UILabel!

    @IBAction private func plusTapped(_ sender: UIButton) {
        counter.value += 1
        label.text = "\(counter.value)"
    }
}

MyApp
│
├── Model                  ← データ構造。ビジネスルールを含む場合もあり
│   └── SampleEntity.swift
│
├── View                   ← 画面表示（SwiftUI View）
│   └── SampleView.swift
│
├── ViewModel              ← ユーザー操作・状態管理・画面ロジック
│   └── SampleViewModel.swift
│
├── Service                ← APIアクセス、DB操作などの外部連携処理
│   └── SampleService.swift
│
├── Resource               ← ローカライズ、画像、設定ファイルなど
│   └── ...

import SwiftUI

// Model、今回はシンプルなので省略
struct Counter {
    var value = 0
}

// ViewModel
final class CounterViewModel: ObservableObject {
    @Published private(set) var value = 0

    func increment() {
        value += 1
    }
    func decrement() {
        value -= 1
    }
}

// View
struct CounterView: View {
    @StateObject private var vm = CounterViewModel()

    var body: some View {
        VStack(spacing: 16) {
            Text("\(vm.value)").font(.largeTitle.monospacedDigit())
            HStack {
                Button("−") {
                    vm.decrement()
                }
                Button("+") {
                    vm.increment()
                }
            }
            .buttonStyle(.borderedProminent)
        }
        .padding()
    }
}

MyApp
│
├── Presentation                 ← UIレイヤー（SwiftUI / UIKit）
│   ├── View                     ← 画面UI（HomeView, DetailView など）
│   │   └── SampleView.swift
│   ├── ViewModel                ← ユーザー操作や状態管理
│   │   └── SampleViewModel.swift
│   └── UIComponent              ← 共通UIパーツ（カスタムButton等）
│       └── SampleRow.swift
│
├── Domain                       ← ビジネスロジック層
│   ├── Model                    ← Entity。アプリ内部のデータ型
│   │   └── SampleEntity.swift
│   ├── UseCase                  ← ユースケース（処理の本体）
│   │   └── FetchSampleUseCase.swift
│   └── Repository               ← データ取得の抽象インターフェース
│       └── SampleRepository.swift
│
├── Data                         ← 実装層（API・DBなど）
│   ├── RepositoryImpl           ← Repository の具象実装
│   │   └── SampleRepositoryImpl.swift
│   ├── APIClient                ← ネットワーク通信
│   │   └── SampleAPIClient.swift
│   └── DTO                      ← APIレスポンス等の中間データ
│       └── SampleResponseDTO.swift
│
├── Core / Shared                ← 共通機能（エラー, DI, 拡張など）
│   ├── AppError.swift
│   ├── DIContainer.swift
│   └── DateFormatter+Ext.swift

import SwiftUI
import Foundation

// Entity
struct Todo: Identifiable, Equatable {
    let id: UUID
    var title: String
    var done: Bool
}

// UseCase の境界
protocol AddTodoUseCase {
    func add(title: String) async throws -> Todo
}

// Repository の境界
protocol TodoRepository {
    func create(title: String) async throws -> Todo
}

// UseCase 実装（ドメイン層）
struct AddTodoInteractor: AddTodoUseCase {
    let repo: TodoRepository

    func add(title: String) async throws -> Todo {
        // ビジネスルールをここに
        guard !title.trimmingCharacters(in: .whitespaces).isEmpty else {
            throw ValidationError.emptyTitle
        }
        return try await repo.create(title: title)
    }
}

enum ValidationError: Error {
    case emptyTitle
}

// Infra 実装（データ層）
final class InMemoryTodoRepository: TodoRepository {
    private var storage: [Todo] = []
    func create(title: String) async throws -> Todo {
        let todo = Todo(id: UUID(), title: title, done: false)
        storage.append(todo)
        return todo
    }
}

// Presenter/ViewModel（UI 境界）
@MainActor
final class TodoViewModel: ObservableObject {
    @Published var todos: [Todo] = []
    @Published var error: String?

    private let addTodo: AddTodoUseCase

    init(addTodo: AddTodoUseCase) {
        self.addTodo = addTodo
    }

    func add(title: String) {
        Task {
            do {
                let new = try await addTodo.add(title: title); todos.append(new)
            }
            catch {
                self.error = "\(error)"
            }
        }
    }
}

// SwiftUI View（Frameworks 層）
struct TodoView: View {
    @StateObject private var vm: TodoViewModel
    @State private var title = ""

    init() {
        let repo = InMemoryTodoRepository()
        let uc = AddTodoInteractor(repo: repo)
        _vm = StateObject(wrappedValue: TodoViewModel(addTodo: uc))
    }

    var body: some View {
        VStack {
            HStack {
                TextField("何する？", text: $title)
                Button("追加") { vm.add(title: title); title = "" }
            }
            List(vm.todos) { Text($0.title) }
        }
        .padding()
    }
}

MyApp
│
├── Feature                ← 各画面・機能単位のロジック（State / Action / Reducer / View）
│   ├── SampleFeature.swift
│   └── AnotherFeature.swift
│
├── View                   ← 必要に応じて View だけ分離（スタイルや共通UI向け）
│   └── SharedButton.swift
│
├── Model                  ← 共通データ構造（Entity 的なもの）
│   └── SampleEntity.swift
│
├── APIClient              ← 副作用（Effect）として扱う外部依存（API/DBなど）
│   └── SampleAPIClient.swift
│
├── Dependency             ← DI設定（live/testの差し替え）
│   └── SampleDependency.swift
│
├── Resource               ← Assets, strings, config 等
│   └── ...

import SwiftUI
import ComposableArchitecture

@Reducer
struct CounterFeature {
    struct State: Equatable { var value = 0 }
    enum Action: Equatable {
        case increment
        case decrement
    }

    var body: some ReducerOf<Self> {
        Reduce { state, action in
            switch action {
            case .increment:
                state.value += 1
                return .none
            case .decrement:
                state.value -= 1
                return .none
            }
        }
    }
}

struct CounterView: View {
    let store: StoreOf<CounterFeature>
    var body: some View {
        WithPerceptionTracking {
            let state = store.state
            VStack(spacing: 16) {
                Text("\(state.value)").font(.largeTitle.monospacedDigit())
                HStack {
                    Button("−") { store.send(.decrement) }
                    Button("+") { store.send(.increment) }
                }
                .buttonStyle(.borderedProminent)
            }
            .padding()
        }
    }
}

// どこかのエントリポイント
// CounterView(store: Store(initialState: .init()) { CounterFeature() })

MyApp
│
├── Module
│   └── SampleFeature                  ← 機能・画面単位のモジュール
│       ├── View                       ← UI表示（SwiftUI / UIKit）
│       │   └── SampleView.swift
│       ├── Presenter                  ← Viewとの橋渡し。状態管理・画面ロジック
│       │   └── SamplePresenter.swift
│       ├── Interactor                 ← ビジネスロジック処理
│       │   └── SampleInteractor.swift
│       ├── Entity                     ← データ構造
│       │   └── SampleEntity.swift
│       ├── Router                     ← 遷移処理
│       │   └── SampleRouter.swift
│       └── Protocol                   ← 各パーツのインターフェース定義
│           └── SampleProtocols.swift
│
├── Shared
│   └── Component                      ← 共通UIパーツなど
│       └── SharedButton.swift
│
├── Resource                           ← Assets、strings、設定ファイルなど
│   └── ...

import SwiftUI

// MARK: - Entity
struct CounterEntity {
    var value = 0
}

// MARK: - Interactor
protocol CounterUseCase {
    func increment(_ entity: inout CounterEntity)
}
struct CounterInteractor: CounterUseCase {
    func increment(_ entity: inout CounterEntity) {
        entity.value += 1
    }
}

// MARK: - Router
protocol CounterRouterInput {
    func routeToResult(value: Int)
}
final class CounterRouter: CounterRouterInput, ObservableObject {
    @Published var isShowingResult = false
    var passedValue: Int = 0

    func routeToResult(value: Int) {
        passedValue = value
        isShowingResult = true
    }
}

// MARK: - Presenter
@MainActor
final class CounterPresenter: ObservableObject {
    @Published var displayText: String = "0"

    private var entity = CounterEntity()
    private let interactor: CounterUseCase
    private let router: CounterRouterInput

    init(interactor: CounterUseCase, router: CounterRouterInput) {
        self.interactor = interactor
        self.router = router
    }

    func didTapPlus() {
        interactor.increment(&entity)
        displayText = "\(entity.value)"
    }

    func didTapShowResult() {
        router.routeToResult(value: entity.value)
    }
}

// MARK: - View
struct CounterVIPERView: View {
    @StateObject private var router = CounterRouter()
    @StateObject private var presenter: CounterPresenter

    init() {
        let router = CounterRouter()
        _router = StateObject(wrappedValue: router)
        _presenter = StateObject(wrappedValue: CounterPresenter(
            interactor: CounterInteractor(),
            router: router
        ))
    }

    var body: some View {
        NavigationStack {
            VStack(spacing: 16) {
                Text(presenter.displayText)
                    .font(.largeTitle.monospacedDigit())
                Button("+") {
                    presenter.didTapPlus()
                }
                Button("結果を見る") {
                    presenter.didTapShowResult()
                }

                NavigationLink(
                    destination: ResultView(value: router.passedValue),
                    isActive: $router.isShowingResult
                ) {
                    EmptyView()
                }
            }
            .padding()
        }
    }
}

// MARK: - 遷移先 View（Result）
struct ResultView: View {
    let value: Int
    var body: some View {
        VStack(spacing: 20) {
            Text("最終カウント")
            Text("\(value)")
                .font(.largeTitle.monospacedDigit())
        }
        .navigationTitle("結果")
    }
}