B-055: 設計ドキュメント作成完了報告

成果物

設計ドキュメントを docs/design/directory-restructure-i18n.md に作成しました（859行）。

設計ドキュメントの概要

含まれる内容

1. 概要: 変更の目的（ディレクトリ整理 + i18n）と背景
2. URL設計: 旧URL→新URLの完全なマッピング表（全パターン網羅）
3. 技術設計:
   • Next.js 16 の proxy.ts（旧middleware）の設計: 言語未指定URLの302リダイレクト担当
   • ルートレイアウトの再設計: 方式Cを採用（ルートlayoutは最小限、[lang]/layoutでHeader/Footer/辞書提供）
   • 辞書システム: Next.js公式推奨のJSONベース自前実装（外部ライブラリ不要）
   • hreflang: HTMLタグ + サイトマップ方式の併用、双方向リンク必須
   • リダイレクト: next.config.tsのredirects()で旧→新の全301リダイレクトを一元管理
   • generateStaticParamsの更新方針
   • SEOヘルパー関数の更新方針
4. コンテンツ分類: 現在の全コンテンツ（14種類）の新5カテゴリへの割り当て詳細
5. 一覧ページの設計: 各カテゴリ一覧のフィルター・検索・ページング方針
6. 移行計画: 3フェーズ構成
   • フェーズ1+2（同時実施推奨）: i18nインフラ + ディレクトリ整理 + SEO移行
   • フェーズ3: 英語版追加
   • 各フェーズの手順・成果物・チェックポイント
7. リスクと対策: SEO・技術・ユーザー影響・デプロイ戦略の全リスク分析

主要な設計判断

• proxy.ts: 言語未指定URLの302リダイレクトのみを担当（Googleの非推奨に従い302を使用）
• 翻訳ライブラリ: next-intl等は不使用、自前JSONベース実装（サイト規模に対して過剰なため）
• レイアウト方式: ルートlayoutにをデフォルト配置し、[lang]/layoutでコンテンツの言語対応を行う
• フェーズ1+2の一括デプロイ: リダイレクトなしにページを移動するとSEO損失が発生するため

補足事項

• Next.js 16のproxy.ts APIを公式ドキュメントで確認済み（middleware→proxyの名称変更を反映）
• Next.js公式i18nガイド（PageProps/LayoutProps型ヘルパー、hasLocale関数等）の最新パターンを反映
• server-only パッケージの追加インストールが必要（package.jsonに未登録）
• 移行完了後にdocs/architecture.mdの更新が必要

次のアクション

このドキュメントに基づいて、実装者がフェーズ1+2の作業を開始できます。作業は以下の2つの作業単位に分割することを推奨します:

• 作業単位A: i18n基盤 + レイアウト再構築（辞書、proxy.ts、[lang]/layout.tsx）
• 作業単位B: ページ移動 + ディレクトリ整理 + リダイレクト + SEO更新（一括デプロイ必須）