子育て世帯向けSaaS「こどもログ」を開発中。Zustandで状態管理を整理した話
はじめに
授業の空き時間を使って、子育て世帯向けの育児記録・タスク管理サービス「こどもログ」を開発している。React 19とFirebase(Googleが提供するサーバー不要のデータ管理基盤)を組み合わせたWebアプリで、宿題・医療・持ち物といった育児まわりのタスクを家族で共有できる構成だ。
今回は、画面の状態管理(データをどの部品が持つか)をZustand(ズースタンド:Reactアプリ向けの軽量な状態管理ライブラリ)に移行したときの話を書く。
今日の作業内容
クイック追加パネルという機能がある。キーボードの`N`キーを押すとサイドから素早くタスクを入力できる機能で、これをどのコンポーネント(画面の部品)が「開いているか・閉じているか」の状態を持つかが問題になっていた。
もともとは親コンポーネントがその状態を持って子に渡す設計にしていたが、ページが増えるにつれてどこで開閉フラグを管理すればいいか分からなくなってきた。ヘッダーからも開けるようにしたかったし、`Esc`キーで閉じる処理もどこに書けばいいかで迷った。
Zustandを使ってUI状態だけをまとめたストア(状態置き場)を作り、どのコンポーネントからでも開閉を操作できるようにした。Firebaseに保存するデータとは分けて管理する設計にしている。
苦戦したこと
`Esc`キーの処理が二重に動くバグに30分ほど詰まった。モーダル(ポップアップ)が開いているときに`Esc`を押すとモーダルが閉じる処理と、クイック追加パネルが閉じる処理が同時に走ってしまって、画面がちらついた。
どちらも`Esc`のキーイベントを監視していたが、イベントの伝播(ひとつのキー操作が複数の処理に届く仕組み)を止め忘れていたのが原因だった。
解決方法
モーダルが開いているときはパネルのキーイベントを無視する条件を追加した。Zustandのストアにモーダルの開閉状態も入れたので、どちらが開いているかをどこからでも参照できて、この条件を書きやすくなった。
ストアを分けずに一箇所にまとめたのが効いた。複数の部品がバラバラに状態を持っていたときはこういう「ふたつが同時に起きたとき」の制御が書けなかった。
学んだこと
Firebaseに保存するデータと、UIの動き(開いてる・閉じてる・何を選んでいるか)は最初から分けて管理すべきだった。今回の整理で、Firestoreへの読み書きはサービス層に、UI状態はZustandに、という役割分担がはっきりした。
あと、ショートカットキーは思ったより複雑になる。`N`キーひとつとっても、テキスト入力欄にフォーカスが当たっているときは動かしたくない、モーダルが出ているときも動かしたくない、という条件が重なる。こういう細かいUXの詰めが一番時間を食う。
次回やること
スケジュール画面の2週間カレンダー表示の精度を上げる
- タスクに期限切れアラートを出す処理を実装する
- Firestoreのセキュリティルールを本番向けに見直す
現状、テスト用のアカウントで登録済みの子ども9人分、タスク27件を作って動作確認している。完了済みタスクは25件まで進んでいるので、タスクの完了フローは一通り動いている確認がとれた。
まとめ
状態管理の設計ミスは、機能が増えてから直そうとすると倍の時間がかかる。今回は早めに気づいて整理できたが、最初から役割を分けて設計していれば詰まらなかった箇所だった。
授業の合間に少しずつ触っているので進みは遅いが、子育て世帯が毎日使えるツールになるよう地道に作り続ける。