TypeScriptとFirebaseで子育てSaaSを設計してわかった、コード構造を最初に固める理由|こどもログ#62
はじめに
前回はFirebaseとStripeで本番デプロイした直後、セキュリティ設計の甘さに気づいた話を書いた。今回はその反省を踏まえて、コードベースを整理し直して初回コミットとして記録した作業の話だ。
今日の作業内容
React 19 + TypeScript + Firebase の構成でプロジェクトの骨格を固め直した。状態管理にはZustand(Reactで使えるシンプルな状態管理ライブラリ)を採用し、ページ・コンポーネント・カスタムフック・サービス層に分けた構成にした。
サービス層(Firestoreとのデータのやり取りを担当する部分)を切り出したことで、UIのコンポーネントがデータの取得方法を知らなくて済む形になった。子どもプロフィールの管理、宿題や持ち物などのタスク管理、2週間カレンダー、ダッシュボードが一通り動いている状態だ。
苦戦したこと
ログインしているユーザーが自分のデータだけを見られる仕組みを、Firestoreのルール(データベースのアクセス制御を記述する設定)で実現しようとして、詰まり続けた。条件の書き方がよくわからず、最初はとりあえず動く状態から出発してしまった。
後からルールを厳しくしようとしたら、データ構造そのものを変えなければいけない場面が出てきた。前回のセキュリティの反省が、別の形でまた繰り返された。
解決方法
Firestoreルールの条件を先に決め、それに合わせてデータ構造を設計する順序に変えた。「動いてからルールを合わせる」手順が混乱の原因だったとわかった。
環境変数の管理は、サンプルファイルを用意して実際の設定値はそこに書かない方式を最初から徹底した。入力値のXSS(不正なスクリプトを埋め込む攻撃手法)対策は、DOMPurifyというライブラリを全フォームに組み込んで対処した。
学んだこと
設計の順序が結果を決めると感じた回だった。ルールを先に書いてコードをそれに合わせる。この順序を崩して後から修正しようとすると、変更の影響が思ったより広い範囲に出る。
現時点で4人が使い始め、子ども9人分のプロフィールを立てて27件のタスクを登録している。25件は完了マークがついていて、1人が有料プランを選んだ。数字は小さいが、自分の設計判断の上に積み上がっているのを見るのは、率直に言って悪くない。
次回やること
Stripeによる課金フローの詳細実装が残っている。無料プランと有料プランで機能の出し分けをする部分が、認証の仕組みと絡んで複雑になりそうな予感がある。そこをどう設計するかが次の課題だ。
まとめ
整理した回だったが、学びのほとんどは「順序」の話に収束した。動かしてから固めるより、固めてから動かす方が後が楽になる。授業の合間に少しずつ作っていると、一度崩すと取り戻すのに時間がかかるのが身に染みる。
──────────
前回(第61話)はこちら