開発仕様書
08Section

システム構成

顧客 Web、社内 AI 管制塔、外部統合 (本国卸 / 通関 / 物流) を含む全体構成。

コアコンセプトは「外部の複雑性を AI 管制塔が抽象化し、顧客 UI と社内オペレーションには 統一されたモデルだけを露出する」こと。

5.1 全体ブロック図

┌────────────────────────┐    ┌─────────────────────────┐
│  顧客 Web / PWA         │    │  プロ向け / クライアント │
│  Next.js (Edge SSR)     │    │  共有閲覧 URL            │
└──────────┬─────────────┘    └────────────┬────────────┘
           │                                │
           ▼                                ▼
┌─────────────────────────────────────────────────────────┐
│  API Gateway (BFF) — GraphQL / tRPC                     │
│  · 認証 / 認可 (顧客 / プロ / 社内ロール)               │
│  · ストリーミング (進捗イベント)                        │
└──────────┬──────────────────────────────────────────────┘
           │
           ▼
┌─────────────────────────────────────────────────────────┐
│  社内 AI 管制塔 (Control Tower)                          │
│                                                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐      │
│  │ ソーシング   │  │ 物流オペ     │  │ 職人配分    │      │
│  │ Engine       │  │ Engine       │  │ Engine       │      │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘      │
│         └────────────────┴────────────────┘              │
│                    │                                     │
│                    ▼                                     │
│        ┌──────────────────────┐                          │
│        │  オーケストレーター   │  ← LLM / エージェント   │
│        │  + ナレッジグラフ     │                          │
│        └──────────┬───────────┘                          │
└───────────────────┼──────────────────────────────────────┘
                    │
        ┌───────────┴───────────┐
        ▼                       ▼
┌────────────────┐       ┌──────────────────┐
│ 外部統合        │       │ 内部統合          │
│ · 欧州本国卸 API │       │ · 通関業者        │
│ · 廃業在庫データ │       │ · 国内倉庫 WMS    │
│ · 物流 (DHL等)  │       │ · 提携職人 CRM    │
│ · 為替 API      │       │ · 決済 / 会計     │
└────────────────┘       └──────────────────┘

5.2 技術スタック (推奨)

レイヤー採用候補理由
Web フロントNext.js (App Router) + TypeScript + Tailwind CSSSSR / ISR の選択、Edge 配置、多言語 / SEO に強い
BFF / APItRPC または GraphQL (Apollo)TS 型共有、リアルタイムは Subscription / SSE
データベースPostgreSQL (主) + Redis (キャッシュ) + Pinecone (ベクトル)取引データの ACID、LLM 検索のベクトル
ファイル / 画像Cloudflare R2 + Image Resizingコスト効率、グローバル CDN
AIAnthropic Claude / OpenAI GPT-4 + 専用 Fine-tuned モデルLLM オーケストレーション、検品 / 価格判断
認証Auth0 または Clerk (顧客) + SSO (社内)プロ向けマルチテナント、社内 SSO
決済Stripe + 銀行振込 + リース高額帯への対応
監視Datadog + Sentryマルチサービスの一元監視
ホスティングVercel または Cloudflare Pages + Workersグローバル Edge、コスト効率

5.3 主要な外部統合

欧州本国卸の在庫 / 価格 API

  • 主要卸 50 社と業務提携契約、優先在庫アクセス権を確保
  • 未提携卸は Web スクレイピング (robots.txt 準拠) + 営業日次更新
  • 廃業在庫はオークションサイト・清算業者の API / RSS フィードを集約

通関 / 物流

  • 独・伊の現地 3PL 倉庫と契約 (集約倉庫)
  • DHL Freight / Kuehne+Nagel のコンソリ便枠を月次予約
  • 日本通関業者と EDI 接続 (HS コード自動付与は LLM)

国内倉庫 / 配送 / 設置

  • 関東 1 拠点 + 関西 1 拠点を直営または専属契約
  • 家具便配送業者 (アクト・ベルクなど) と専属契約、ハンドリング訓練

職人 / 工房ネットワーク

  • 関東 20 / 関西 10 名の独占契約職人を Phase 1 で確保
  • カテゴリ別 (張替え / 木部 / 金物 / 革) スコアリング

5.4 セキュリティ・コンプライアンス

  • 個人情報: 改正個人情報保護法 + APPI 同等対応
  • 決済: PCI DSS 準拠 (Stripe 経由で直接保管しない)
  • 輸入関連書類: 7 年保存 (法定)
  • 顧客データ転送 (本国卸への発注時) は最小限の項目のみ、暗号化必須
設計原則
外部統合はすべて「Anti-Corruption Layer」を経由させ、内部モデル (Product / Order / Member / Repair) は外部仕様の変化から守る。 スクレイピング層は失敗を許容し、必ず複数ソースで冗長化する。