メインコンテンツへスキップ
見出し画像

【クリーンアーキテクチャ_27】 Zustandなどの状態管理はどこに配置?

     Zustandの状態管理はどこに配置すべきか?
    ──ディレクトリ構成、責務分離、アーキテクチャの視点から


    1. Zustandの本質的な特徴とは?

    まず、「Zustandとは何か?」を理解しないと、どこに配置すべきかがわかりません。
    軽量
     Reduxのような冗長なボイラープレートが不要。Hooksベースで書ける。
    非依存型
     ContextやProvider不要。どこからでもアクセス可能。
    モジュール志向
     storeファイルは独立したJavaScript/TypeScriptモジュール。依存注入も自由自在。
    スケーラブル
     複数storeの分割管理やSelectorパターンにも対応。

    つまり、関数型のシングルトン的Storeモジュールとして切り出す設計が理想。


    2. Zustandストアの理想的な配置場所(ディレクトリ構成)

    Zustandは、ロジックと状態を「機能単位」か「ドメイン単位」で切り出して配置するのが基本です。

    代表的な構成(ドメイン駆動+機能分離)

    src/
    ├── stores/
    │   ├── userStore.ts
    │   ├── authStore.ts
    │   ├── uiStore.ts
    │   └── productStore.ts
    ├── features/
    │   ├── user/
    │   │   ├── components/
    │   │   ├── hooks/
    │   │   └── pages/
    │   └── product/
    ├── hooks/        // 共通カスタムフック(zustand selectorなど)
    ├── services/     // API通信層
    └── utils/        // 汎用ユーティリティ

    配置のポイント

    src/stores/
     Zustandは状態の「シングルトンモジュール」なので、Reduxよりも独立的に扱える。状態のみを集中管理。
    features/xxx/
     「ドメイン特化」構成の場合、user/store.tsのようにドメイン下に配置することも可。
    hooks/useXxx.ts
     storeへのアクセスHook(例:useUser)をこの層でラップし再利用性を高める。


    3. 状態の粒度とstore分離のルール

    Zustandは小さく、疎結合なストアの分離が最適です。以下の観点で分けましょう。

    状態の「性質」で分類

    ログイン・認証
     ユーザーの認証情報
     authStore
    ビジネスロジック
     商品、注文など
     productStore, orderStore
    UI状態
     モーダルの開閉、タブ状態
     uiStore, layoutStore
    一時キャッシュ
     サーバーデータの一時保持
     cacheStore

     状態のスコープがグローバル or ドメインローカルかで分離すると自然です。


    4. Zustandの状態管理とレイヤードアーキテクチャの統合

    Zustandを「アプリケーション層」に配置するのが基本です。

    ドメイン層(Entity / UseCase) ←アプリケーション層(Zustand)→ UI層(Reactコンポーネント)

    状態の流れ

    1. ユーザー操作 → UIコンポーネント

    2. UIがZustandのアクションを呼び出し

    3. Zustand内部でState変更(ドメイン知識を含むならUseCase経由)

    4. UIが状態を購読し再レンダリング


    5. TypeScriptとZustandの理想的な定義方法

    // src/stores/userStore.ts
    import { create } from 'zustand'
    
    type User = { id: string; name: string }
    
    type State = {
      user: User | null
      setUser: (user: User) => void
      clearUser: () => void
    }
    
    export const useUserStore = create<State>((set) => ({
      user: null,
      setUser: (user) => set({ user }),
      clearUser: () => set({ user: null }),
    }))
    
    // src/hooks/useUser.ts
    import { useUserStore } from '@/stores/userStore'
    
    export const useUser = () => {
      const user = useUserStore((state) => state.user)
      const setUser = useUserStore((state) => state.setUser)
      return { user, setUser }
    }

    hooks/useUser.tsのようにSelectorやラッパーHookに抽象化することで、再利用性とテスト容易性が向上します。


    6. UI状態(例:モーダル開閉)はどこに置く?

    ✅ Zustandに置くべきもの

    • 全体に関係するモーダル(ログインModalなど)

    • グローバルなナビゲーションやテーマ状態

    • 他ドメインからも開閉されうるUIフラグ

    各ページだけで閉じるなら useStateで十分


    まとめ:Zustandストア配置のゴールデンルール

    1. storeはsrc/stores/かfeatures/xxx/store.tsにまとめる
    2. ロジックと状態の分離を徹底(状態はZustand、処理はUseCase/Service)
    3. 状態の性質で分割(UI、ドメイン、セッション)
    4. 再利用性を意識しhooks/useXxx.tsでラップ
    5. 状態の読取はSelector、副作用はServiceやAPI層に追い出す
    6. 最小限の依存で設計し、Zustandを「単なるデータの入れ物」と見なす


    おまけ:Zustandの実戦Tips

    • persistミドルウェアでLocalStorage同期(ログイン情報などに最適)

    • subscribeWithSelectorでセレクター監視

    • immerと併用して状態の不変性維持

    • zustand-utilsでリセット可能なストア設計



     
     
    フロントエンド、バックエンドのエンジニアをやっております。 読むだけで複雑だったはずの技術が、すっと腑に落ちる。その静かな感動を届けたい。

    あなたへのおすすめ