ステータス: テンプレート(未着手) — セクション枠だけ用意。Phase 1 着手前に中身を埋める。
全体像
TODO: 構成図 (顧客ブラウザ ↔ ウィジェット ↔ バックエンド ↔ LLM / ベクトルDB / Shopify Admin API / 管理画面) を1枚で示す。
採用スタック
TODO: フロントエンド / バックエンド / LLM / ベクトルDB / RDB / ホスティング / 認証 / 観測基盤 の採用候補と決定を表で記載。
コンポーネント責務
TODO: 各コンポーネント(ウィジェット、Admin UI、API サーバ、エージェントランナー、ナレッジパイプライン、Webhookハンドラ等)の責務境界を記載。
デプロイ・インフラ構成
TODO: 環境分離(dev / staging / prod)、シークレット管理、CI/CD、スケーリング方針。Phase 1 では最小構成、Phase 2 以降の発展余地も併記。
主要データフロー
TODO: (1) 顧客が話しかけてから応答が返るまで、(2) ナレッジが取り込まれて検索可能になるまで、(3) エスカレーションが発火してから人間に届くまで、の3フローをシーケンスで示す。
未決事項
TODO: 解決前提だが現時点で結論が出ていない論点を列挙。確定したものは `pending-decisions.md` から移してくる、もしくはこちらで解消したら向こうから消す。