API設計
SSRではGraphQLよりREST APIが自然に機能する場面がある SSRは“ページ生成処理”である REST APIは「まとめて取得」に強い SSRとGraphQLで発生しやすいボトルネック キャッシュ戦略が大きく違う セキュリティ面の違い 実務でよく起きる現象 REST APIが向くSSR…
SPAでは「必要なデータだけ欲しい」ためGraphQLが選ばれやすい REST APIは“画面”ではなく“資源”を返す Overfetch問題とは何か SPAは“画面中心設計”のアプリケーション GraphQLは「画面が欲しい形でデータを取得する」 Underfetch問題も同時に解決する それで…
SPAでAPI設計が重要になる理由とBFF（Backend For Frontend）の役割 サーバレンダリング時代のデータの流れ SPAでは何が変わるのか なぜAPI設計がUIを壊すのか BFF（Backend For Frontend）とは何か BFFが必要になる具体的な場面 GraphQLとの関係 注意点：BF…
SDDにおけるSpecificationは「仕様書」ではない なぜドキュメントでは不十分なのか Specificationはインターフェース契約になる テストとの違い 実際の現場で起きる変化 なぜ契約という考え方が重要なのか 注意点 ― Specificationを書きすぎる問題 変更と破…
REST APIは「通信方式」ではなく仕様の表現です リソース設計はドメイン理解の鏡 状態遷移とHTTPメソッド ステータスコードも仕様の一部 よくある誤解：RESTに合わせて仕様を変える REST APIとドメインモデルの対応 注意点：HTTPに依存しすぎない テスト観点…
実装より先にAPI設計をすると設計が安定します APIは画面のためのものではない API設計で見える仕様の不足 ドメインモデルはAPIから逆算できる よくある失敗：テーブル設計から始める HTTPメソッドと仕様の関係 注意点：APIを外部公開前提にしすぎる テスト…
AIの回答が「少しずつ表示」される理由 通常のAPIレスポンスとの違い なぜこんな仕組みになるのか 実際に送られているデータ ユーザー体験が改善する理由 開発側のメリット 実装の仕組み（概念） なぜ一気に送らないのか 注意点 結局、何が起きているのか AI…
