1. ER 概略
  2. エンティティ定義
  3. 主要リレーション
  4. マルチテナント方針
  5. インデックス・保持期間
  6. 未決事項
CS Agentic AI が扱う主要エンティティとその関係を定義する。`phase1-screens.html` / 各 `customer/*.html` で前提にしている概念をスキーマとして固定する。

ステータス: テンプレート（未着手） — セクション枠だけ用意。Phase 1 着手前に中身を埋める。

ER 概略

TODO: 主要エンティティとリレーションの ER 図を1枚。

エンティティ定義

TODO: 各エンティティの目的・主要フィールド・型・制約を表で列挙。最低限以下:

  • Shop — テナント単位（Shopify ショップ）
  • User — 事業者側ユーザー（管理画面ログイン主体）
  • Customer — エンドユーザー（買い物客）
  • Conversation — 会話セッション
  • Message — 会話内の発言（user / assistant / tool）
  • KnowledgeSource — ナレッジ取り込み元（URL/PDF/手入力）
  • KnowledgeArticle — 正規化されたナレッジ単位
  • KnowledgeChunk — 埋め込み対象のチャンク
  • EscalationTicket — 人間エスカレーション記録
  • WidgetSettings / AgentSettings — 事業者設定

主要リレーション

TODO: 1:N / N:M の依存関係、外部キー方針、カスケード削除の扱い。

マルチテナント方針

TODO: テナント分離方式（Row-Level Security / スキーマ分離 / DB分離）と選定理由。`Shop.id` を全テーブルに伝搬させるルール等。

インデックス・保持期間

TODO: 検索パターンと必要インデックス。会話ログ・ナレッジの保持期間（GDPR / 個人情報保護法対応）。

未決事項

TODO: RDB と ベクトルDB の責務境界、Customer の同定方法（Shopify Customer ID 連携 vs 独立）等。