フロントエンド・バックエンド・インフラが分離されたプロジェクトでは、API仕様変更時の型不整合、スキーマ定義の重複管理、デプロイ時の仕様ズレなどが発生します。
CDKを独立管理すると「Zodスキーマを定義してもフロントエンドは手動型定義」「API Gatewayスキーマも手動で重複定義」「OpenAPI生成が動作しない」など悩みがつきません。
CDKをmonorepoに組み込み、@app/coreのZod-OpenAPIスキーマを唯一の真実の源として、フロントエンド型定義自動生成、CDK API Gatewayスキーマ自動生成、OpenAPI仕様書自動出力する設計を実装について考えます。
Zodスキーマ変更がフロントエンド・CDK・ドキュメントに反映される型安全な開発体験を実現した具体的手法と、ライブラリバージョン問題の解決策をお伝えします。