Kotlin Coroutines Flows

# Kotlin コルーチン & Flow

Android および Kotlin Multiplatform プロジェクトにおける構造化並行性、Flow ベースのリアクティブストリーム、コルーチンテストのパターン。

## アクティベートするタイミング

- Kotlin コルーチンで非同期コードを書く
- リアクティブデータに Flow、StateFlow、または SharedFlow を使用する
- 並行操作を処理する（並列読み込み、デバウンス、リトライ）
- コルーチンと Flow をテストする
- コルーチンスコープとキャンセルを管理する

## 構造化並行性

### スコープ階層

```
Application
  └── viewModelScope (ViewModel)
        └── coroutineScope { } (構造化された子)
              ├── async { } (並行タスク)
              └── async { } (並行タスク)
```

常に構造化並行性を使用してください — `GlobalScope` は絶対に使わない:

```kotlin
// NG
GlobalScope.launch { fetchData() }

// OK — ViewModel ライフサイクルにスコープ
viewModelScope.launch { fetchData() }

// OK — コンポーザブルライフサイクルにスコープ
LaunchedEffect(key) { fetchData() }
```

### 並列分解

並列作業には `coroutineScope` + `async` を使用:

```kotlin
suspend fun loadDashboard(): Dashboard = coroutineScope {
    val items = async { itemRepository.getRecent() }
    val stats = async { statsRepository.getToday() }
    val profile = async { userRepository.getCurrent() }
    Dashboard(
        items = items.await(),
        stats = stats.await(),
        profile = profile.await()
    )
}
```

### SupervisorScope

子の失敗が兄弟をキャンセルしてはならない場合は `supervisorScope` を使用:

```kotlin
suspend fun syncAll() = supervisorScope {
    launch { syncItems() }       // ここでの失敗は syncStats をキャンセルしない
    launch { syncStats() }
    launch { syncSettings() }
}
```

## Flow パターン

### コールドフロー — ワンショットからストリームへの変換