TypeScriptとFirebaseでSaaSの骨格を組んで気づいた、設計の優先順位|こどもログ#60
はじめに
前回はFirestoreのセキュリティルールを書き終えた。今回は、これまで書いてきたコードをリポジトリに整理して初回コミットを入れた。
今日の作業内容
こどもログ(子育て世帯向けの育児記録SaaSプロダクト)の現状をひとつのリポジトリにまとめた。React 19とTypeScript(JavaScriptに型の仕組みを加えた言語)、Firebase(Googleのサーバーレスインフラ)、そしてStripe(決済サービス)を組み合わせた構成になっている。
機能の軸は5つ。複数の子どものプロフィール管理、宿題・持ち物・医療など5カテゴリーのタスク管理、2週間表示のカレンダー、進捗をまとめたダッシュボード、そして`N`キーで即時起動するクイック追加パネルだ。
有料プランはPROとMAXの2段階で、それぞれ月払いと年払いがある。合計4つの価格設定をStripeで管理する形にした。決済機能は後から差し込もうとすると設計を壊しやすいと聞いていたので、開発の早い段階から組み込んでいる。
苦戦したこと
TypeScriptの型定義がコンポーネント(画面部品)ごとにバラバラで、値を渡したときに型がずれた。画面は動いているのに表示される値がおかしくなるパターンだった。エラーが出ないぶん原因の特定に時間がかかって、2時間ほど溶かした。
原因を追っていくと、同じ意味のデータが場所によって微妙に違う形で定義されていた。最初に型定義を雑に書いたツケがここで出た形だ。
解決方法
型定義を専用のフォルダに集約して、全体から参照する構成に整理した。コンポーネントごとに似た型を別々に書いていた状態から、一か所にまとめることで値のずれが消えた。TypeScriptを使っているのに、最初の書き方が甘かったせいで余計に遠回りした。
学んだこと
型定義とフォルダ構成は最初に固めないと、後で直すコストが跳ね上がる。
今回は汎用の画面部品と機能固有の部品を分けた構成にした。この境界線が後から修正するときに効いた。「ここは共通部品か、機能固有か」の判断が最初から整理されていると、手を入れる場所を迷わない。
セキュリティ面では、前回書いたFirestoreのルールに加えて、ユーザーが入力した文字から危険なコードを除去する処理(DOMPurify、XSS対策ライブラリ)を全入力に通す設計にした。保存側と入力側の両方に対策を入れておくと、どちらかを変えたときに穴が開きにくい。
次回やること
Stripeのwebhook(決済が完了したときにこちら側のシステムへ通知が届く仕組み)の動作確認が残っている。サーバーレス関数を使って受け取る実装は書いたが、まだ本番でテストしていない。決済まわりは詰まるポイントが多いと聞いているので、ここで時間がかかりそうだと見ている。
まとめ
初回コミットでこどもログの全体構成を整えた。TypeScriptの型定義を後回しにしかけたが、集約したことで見通しが良くなった。次は決済フローが本番で動くかどうかの確認に入る。
──────────
前回(第59話)はこちら