1. 全体像
  2. 採用スタック
  3. コンポーネント責務
  4. デプロイ・インフラ構成
  5. 主要データフロー
  6. 未決事項
CS Agentic AI のシステム全体構成・採用スタック・コンポーネント責務・デプロイ構成を1枚で俯瞰するためのドキュメント。Phase 1 着手前の合意材料。

ステータス: テンプレート(未着手) — セクション枠だけ用意。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` から移してくる、もしくはこちらで解消したら向こうから消す。