
Next.js を作るガイドライン解説 ― 10本の実践アプリで学ぶ App Router 時代の設計指針
Next.js 15 App Router は、Server Components / Server Actions / Route Handler / Middleware といった機能を組み合わせて使う前提のフレームワークです。公式ドキュメントは機能ごとには丁寧でも、「これらをどう組み合わせて実務アプリを設計するか」を体系的に解説する資料は不足しています。 本書では、SNS・学習記録・ブログ・画像共有・ポッドキャスト・読書会・ノート・EC・チャット・ホワイトボードという 10本のサンプルアプリ を題材に、Next.js のガイドライン適用の勘所を読み解きます。 章構成は 「基礎編19章 + 応用編10章」のハイブリッド構成 を採用しました。 - 基礎編: 環境構築・DB 設計・セキュリティ・Server Actions・IDOR 防止・Request ID トレーシング・レート制限・構造化ロギング・NextAuth.js 認証・テスト・アクセシビリティ・パフォーマンスを、横断テーマとしてアプリ非依存に解説します。 - 応用編: 各アプリで基礎編の概念がどう具現化されているかを、ファイルパス付きのコード抜粋とともに読み解きます。 ■本書で学べること - Next.js 15 App Router のレンダリング境界(Server / Client)の引き方 - Server Actions による型安全な実装パターンと楽観的更新 - OWASP Top 10 に対する Next.js 上の多層防御 - IDOR・CSRF・XSS・レート制限・Request ID トレーシングの実装 - NextAuth.js v5 による認証システムと OAuth 統合 - Prisma によるデータモデル設計とパフォーマンス最適化 - アクセシビリティ・テスト・観測性の組み込み方 - 10本のアプリでの設計判断と落とし穴 ■対象読者 - Next.js App Router で実務レベルのアプリを書きたい初級〜中級エンジニア - フレームワーク機能ごとの使い方は分かるが「組み合わせ」で詰まっている方 - セキュリティ・観測性・テストを後付けでなく最初から組み込みたい方 - 自分のチームに「ガイドライン」を整備したい方
📘はじめに ― 本書の歩き方
📘環境構築と基礎 ― プロジェクトの土台をつくる
📘環境変数とランタイム設定 ― Zod による起動時バリデーション
📘Docker ローカル環境構築戦略 ― 依存サービスを使い捨てで揃える
📘データベース設計と Prisma ― 正規化・リレーション・マイグレーション
📘Edge と Node のランタイム境界 ― 二重実装パターン
📘Server Actions の実践パターン ― 型安全・合成・楽観的更新
📘エラーカタログと例外変換 ― ERROR_CODES と ActionResult の設計
📘セキュリティの基礎 ― OWASP Top 10 と多層防御
📘IDOR 脆弱性の防止 ― リソースオーナーチェックと行レベル認可
📘NextAuth.js 認証システム ― v5 (Auth.js) の設計判断
📘課金とサブスクリプション基盤 ― Stripe Webhook と認証セッションの連動
📘Request ID トレーシング ― 1リクエストを一気通貫で追う
📘構造化ロギングと観測性 ― Pino で運用に効くログを設計する
📘レート制限の実装 ― スパムと DoS を Server Actions の層で止める
📘テストと品質管理 ― ピラミッドの再解釈と CI 設計
📘アクセシビリティの実装 ― 後付けが効かない領域を最初から組み込む
📘国際化(i18n)の基礎 ― Middleware ベースのロケール切替
📘パフォーマンス最適化 ― Web Vitals を起点に優先順位を決める
📘静的アセットとオブジェクトストレージ ― S3 / R2 と next/image の連携
📘next-app-post ― フォーム・バリデーション・画像アップロード
📘next-app-studytracker ― Server Actions・データ集計・グラフ可視化
📘next-app-blog ― SSG / ISR・SEO・メタデータ・Markdown
📘next-app-photohub ― 画像最適化・Next/Image・ストレージ設計
📘next-app-podcast ― 音声ストリーミング・Route Handler・フィード
📘next-app-bookclub ― 認証・グループ・ソーシャル・権限モデル
📘next-app-note ― Markdown エディタ・履歴管理・共有権限
📘next-app-shop ― Stripe 決済・カート状態・API Route
📘next-app-chat ― WebSocket / SSE・通知・既読管理
📘next-app-whiteboard ― カスタムサーバー・リアルタイム共同編集
📘まとめ ― 10本の横断比較と「選ぶガイドライン」の育て方
AI/LLM開発の「なぜ」を構造と実測から解説しています。TypeScript / Next.js / MCP / Anthropic API。 🔗 AI駆動開発導入診断 yunbow.github.io/ai-dev-readiness/