02. 設計仕様ポータル

アーキテクチャ、データモデリング、API設計など、構成設計に関わる資料のナビゲーションハブです。新旧システムの差分や意思決定履歴を素早く辿れるように整理しています。

🔑 主要導線

🎯 ゴール	🔗 ドキュメント	📝 補足
システム全体像を把握する	hosting-platform-selection.md	ネットワーク構成、ホスティング比較、冗長化方針
UI指針を確認する	storefront-style-guide.md	Storefront のデザイン原則
購入フローを確認する	checkout-purchase-story.md	チェックアウト〜購入完了の Page Story
マイページの情報設計を確認する	mypage-information-architecture.md	表示導線、権限、会員状態による見え方
購入制限ポリシーを確認する	../specifications/2026-04-quantity-limit-scope-boundary.md	PurchaseLimitRule 正本の月次集計と購入導線ごとの判定設計
旧ロジックの継承範囲を知る	legacy-pricing-algorithm.md	price_chk() 関数の詳細と移行ポイント
データ構造を確認する	data-model.md	ER 図、モジュール別テーブル、インデックス方針

🧱 セクション別カード

アーキテクチャ (architecture/)

🔗 ドキュメント	内容	目的
hosting-platform-selection.md	Fly.io, Railway, Render 等の比較	プラットフォーム選定統合資料とリンクして意思決定を追跡
platform-comparison-detailed.md	技術・コスト観点の比較表	仲介者向け説明資料への参照元

データベース設計 (database/)

• data-model.md
• モジュール別のER図、テーブル定義書、インデックス戦略を格納
• Vendure標準スキーマと拡張テーブルの差分を明記する

API設計 (api/)

カテゴリ	主な内容	代表資料
境界方針	REST / GraphQL の使い分け、consumer 別の判断	rest-graphql-boundary.md
GraphQL	スキーマ、カスタムフィールド、アクセス制御	graphql-schema.md
REST	外部連携用エンドポイント、レート制限ポリシー	03-implementation/ 配下の各プラグイン文書
認証/認可	SSO、管理者ロール、APIキー運用	関連設計資料を参照

🧭 ドキュメント更新のヒント

• 設計資料は実装仕様（03-implementation/）との整合性を常に確認する。
• 技術プラットフォームの議論は、重複を避けつつ /docs/プラットフォーム選定統合資料.md に一本化する。
• 旧システム資料を参照する場合は、用途（移行検証、リスク洗い出し等）を明記する。

✅ チェックリスト

• 新規資料追加時にナビゲーションへのリンクをこのポータルに追記した。
• 技術選定や比較表は統合資料に重複させず、参照リンクで連携した。
• 更新内容を共有するためのレビューログ（更新者・日付・概要）を各ドキュメント先頭に追記した。