
【クリーンアーキテクチャ_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コンポーネント)状態の流れ
ユーザー操作 → UIコンポーネント
UIがZustandのアクションを呼び出し
Zustand内部でState変更(ドメイン知識を含むならUseCase経由)
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でリセット可能なストア設計