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 CSS | SSR / ISR の選択、Edge 配置、多言語 / SEO に強い |
| BFF / API | tRPC または GraphQL (Apollo) | TS 型共有、リアルタイムは Subscription / SSE |
| データベース | PostgreSQL (主) + Redis (キャッシュ) + Pinecone (ベクトル) | 取引データの ACID、LLM 検索のベクトル |
| ファイル / 画像 | Cloudflare R2 + Image Resizing | コスト効率、グローバル CDN |
| AI | Anthropic 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) は外部仕様の変化から守る。 スクレイピング層は失敗を許容し、必ず複数ソースで冗長化する。