contract.yml 一枚から Firebase 全レイヤーの型を生成する
Data Connect・Firestore・Zod・API DTO で同じモデルを多重管理する drift を、YAML 契約を single source of truth にしたコード生成で構造的に消す設計。
Architecture Notes
設計判断、検証結果、技術思想の発信。日々の実装からあがってくる 具体的な問題と、その背景にある抽象的な議論を残す。
Data Connect・Firestore・Zod・API DTO で同じモデルを多重管理する drift を、YAML 契約を single source of truth にしたコード生成で構造的に消す設計。
複数リポジトリを横断する AI エージェントの作業を、スコープと権限の宣言ファイルで強制する。セッション単位のガードレール設計と、権限定義そのものを触らせない自己制約、push を物理的に固める二重防御。
GCP / Firebase を設定から払い出した先に残る「DNS・認証・配信証明書・env 値」を、同じ source of truth に追従させる CI パイプラインの設計。
サービスごとの設定ファイルを SoT に、GCP Project 作成から Firebase Platform 構築までを keyless で自動連鎖させる基盤の設計。
1 つの GCP プロジェクトに複数サービスを同居させた開発環境を、「どう動くか(ランタイム)」と「どう届けるか(デリバリ)」の 2 断面から紹介します。
Cloud SQL を SoT、Firestore を読み取り投影面と位置づけたときに見えてくる設計上の利点と、その代償。