育児タスク管理SaaSを作っている話——Zustandで画面バグと格闘した1日【こどもログ #3】
はじめに
子育て世帯が抱える「家族間での育児情報の分断」を解決したくて、こどもログという育児記録・タスク管理のWebサービスを開発している。React(Webサイトを作るライブラリ)とFirebase(Googleが提供するサーバーいらずのデータ管理サービス)を組み合わせた構成で、授業の合間にコツコツ進めている。
今日は状態管理(アプリ内のデータをどこで・どう持つかの設計)を整理していたら想定外のバグに時間を溶かしたので、その記録を残す。
今日の作業内容
タスク追加パネルの動作確認と、ダッシュボード画面の表示ロジックの修正を進めた。こどもログには「クイック追加」という機能があって、キーボードのNキーを押すとタスク入力パネルがすぐ開く。この操作感にこだわって実装したのだが、パネルを閉じた後にダッシュボードの件数表示が古い値のまま残るという問題が出ていた。
苦戦したこと
ダッシュボードの数字が更新されない。 パネルでタスクを追加してFirestore(Googleのデータベースサービス)に保存したのに、画面の「今週のタスク」カウントが変わらない。
リロードすると正しい値になる。つまりデータは保存できているのに、画面だけ古い状態を持ち続けていた。
最初はFirebaseのリアルタイム購読(データが変わると自動で画面に反映される仕組み)の設定ミスを疑って、そちらをひたすら見ていた。1時間近く追いかけて間違いがなかったので、次にZustand(アプリ全体で状態を共有するライブラリ)側を調べたら、UIの開閉状態とタスクデータの更新タイミングが噛み合っていないのが原因だった。
要するに、自分でデータの流れを分断する設計をしていた。
解決方法
UIの状態(パネルが開いているかどうか)とタスクの一覧データを、別の場所で管理するように整理し直した。Zustandで持つのはUIの状態だけにして、タスクデータはFirebaseのリアルタイム購読だけが更新する流れに統一した。
この変更でパネルを閉じた瞬間にダッシュボードの数字が切り替わるようになった。動いた瞬間は単純に気持ちよかった。
学んだこと
状態の「置き場所」を曖昧にすると、こういう表示ズレが起きる。データを誰が持つかを最初に決めておかないと、後から追うのがしんどい。ZustandはUIの操作感を制御するために使い、サーバーから来るデータはFirebaseに任せる、という役割分担を崩さないことが大事だと今回で身にしみた。
XSS対策(悪意のあるスクリプトをページに埋め込まれる攻撃への対策)でDOMPurify(入力文字列から危険なHTMLを取り除くライブラリ)を使っているのだが、これも今日の整理で改めてフォーム入力の処理を確認した。子どもの名前やタスクのメモ欄は全部サニタイズ(浄化・無害化)を通している。
次回やること
スケジュール画面の2週間カレンダーで期日切れタスクのアラート表示が崩れているのを直す
- 家族共有機能の招待フロー部分のUX(使い勝手)を見直す
- TypeScriptの型定義ファイルを整理する(いつか詰まる前にやっておく)
まとめ
今日は半日でバグ1個しか潰せなかったけど、状態管理の設計を見直せたのは後々効いてくると思う。こどもログはまだ開発中で、子育て世帯の課題を本当に解決できるものにしたい。機能はひとつひとつ丁寧に動かしていく。