機能仕様書: RoomCraft（ルームクラフト）

プロジェクト名: RoomCraft バージョン: 1.0.0 作成日: 2026-03-19 ステータス: Phase 2 設計中 参照: docs/requirements/requirements.md

---

目次

1. 画面遷移図
2. 消費者向け画面仕様
3. メーカー向け画面仕様
4. プラットフォーム管理画面仕様
5. API仕様
6. データモデル（ER図）
7. ビジネスロジック仕様
8. 状態遷移仕様
9. エラーコード一覧

---

1. 画面遷移図

1.1 消費者向け画面遷移

flowchart TD
    LP[ランディングページ] --> |未ログイン| GUEST[ゲストモード]
    LP --> |ログイン/登録| AUTH[認証画面\nCC-Auth]
    AUTH --> |成功| MY[マイルーム一覧]
    GUEST --> |間取り作成| FLOOR_G[間取りエディタ\nゲストモード]
    MY --> |新規作成| FLOOR[間取りエディタ]
    MY --> |既存選択| SIM[3Dシミュレーション]
    FLOOR --> |保存/完了| SIM
    FLOOR_G --> |保存しようとする| AUTH
    SIM --> |家具検索| CAT[家具カタログ]
    CAT --> |商品選択| PROD[家具詳細]
    PROD --> |配置| SIM
    PROD --> |カート追加| CART[カート]
    SIM --> |AIコーディネート| AI[AIコーディネート画面]
    AI --> |適用| SIM
    SIM --> |投稿| COM_POST[コミュニティ投稿]
    COM_POST --> COM[コミュニティ一覧]
    COM --> COM_DETAIL[投稿詳細]
    COM_DETAIL --> |参考コピー| SIM
    CART --> |チェックアウト| CHECKOUT[チェックアウト]
    CHECKOUT --> |完了| ORDER_CONFIRM[注文確認]
    ORDER_CONFIRM --> MY
    LP --> MYPAGE[マイページ]
    MY --> MYPAGE
    MYPAGE --> |ログアウト| LP

1.2 メーカー向け画面遷移

flowchart TD
    MAKER_LP[メーカー向けLP] --> |申請| APPLY[メーカー申請フォーム]
    APPLY --> |審査中| WAIT[審査待ち画面]
    WAIT --> |承認| MAKER_LOGIN[メーカーログイン\nCC-Auth]
    MAKER_LOGIN --> |成功| DASH[ダッシュボード]
    DASH --> PROD_LIST[商品管理一覧]
    DASH --> ORDER_LIST[注文管理一覧]
    DASH --> ANALYTICS[アナリティクス]
    DASH --> BRAND_STORE[ブランドストア設定]
    DASH --> ACCOUNT[アカウント設定]
    PROD_LIST --> |新規登録| PROD_CREATE[商品登録]
    PROD_LIST --> |編集| PROD_EDIT[商品編集]
    PROD_CREATE --> MODEL_UPLOAD[3Dモデル管理]
    PROD_EDIT --> MODEL_UPLOAD
    MODEL_UPLOAD --> |アップロード| MODEL_PREVIEW[3Dモデルプレビュー]
    MODEL_UPLOAD --> |AI変換| MODEL_CONVERT[写真→3D変換]
    ORDER_LIST --> ORDER_DETAIL[注文詳細]
    ORDER_DETAIL --> |発送処理| SHIP[配送情報入力]
    ACCOUNT --> PLAN[プラン変更]
    ACCOUNT --> BILLING[請求・決済管理]

1.3 プラットフォーム管理画面遷移

flowchart TD
    ADMIN_LOGIN[管理者ログイン] --> ADMIN_DASH[管理ダッシュボード]
    ADMIN_DASH --> MAKER_REVIEW[メーカー審査管理]
    ADMIN_DASH --> USER_MANAGE[ユーザー管理]
    ADMIN_DASH --> CAT_MANAGE[カテゴリマスタ管理]
    ADMIN_DASH --> CONTENT_MOD[コンテンツモデレーション]
    ADMIN_DASH --> NOTICE[システム通知配信]
    ADMIN_DASH --> REVENUE[売上・決済管理]
    MAKER_REVIEW --> |承認/却下| MAKER_NOTIFY[メーカーへ通知]
    CONTENT_MOD --> |削除/警告| USER_ACTION[ユーザーへアクション]

---

2. 消費者向け画面仕様

2.1 ランディングページ（/）

概要: サービス紹介、人気コーディネート、提携メーカー一覧を表示するトップページ。

入力

出力

バリデーション

エラーハンドリング

---

2.2 認証画面（/login, /register, /auth/callback）

概要: CC-Auth（Cognito）を利用したSSO認証。外部IdPにリダイレクトして認証後、コールバックでセッションを確立する。

入力

出力

• JWT（アクセストークン）: HttpOnly Cookie、有効期間1時間
• リフレッシュトークン: HttpOnly Cookie、有効期間30日
• ユーザープロフィール: Zustand store に格納

バリデーション

エラーハンドリング

ゲストモード

• セッションIDをlocalStorageに保存
• 間取りデータをIndexedDBに一時保存（最大1件）
• ゲストで作成したデータは会員登録後に引き継ぎ可能

---

2.3 マイルーム一覧（/rooms）

概要: ユーザーが作成した部屋（ルーム）の一覧管理画面。

入力

出力

バリデーション

エラーハンドリング

---

2.4 間取りエディタ（/rooms/new, /rooms/[id]/floor）

概要: 部屋の形状（間取り）を2D平面図で作成・編集する画面。

機能詳細

入力

出力

• FloorPlanオブジェクト（JSON）がIndexedDB/APIに保存
• サムネイル画像（PNG、400x300px）を自動生成

エラーハンドリング

---

2.5 3Dシミュレーション（/rooms/[id]/simulate）

概要: 作成した間取りに家具を配置・編集するメイン画面。Three.js + React Three Fiberで描画。

レイアウト

┌─────────────────────────────────────────────────┐ │ ToolBar [Undo/Redo | 2D/3D切替 | 視点 | 共有] │ ├──────────────┬──────────────────────────────────┤ │ │ │ │ サイドパネル │ 3Dビューポート（メイン） │ │ ・家具検索 │ │ │ ・配置済み │ [Three.js Canvas] │ │ 家具リスト │ │ │ ・AIコーデ │ │ │ │ │ ├──────────────┴──────────────────────────────────┤ │ BottomBar [選択家具情報 | 合計金額 | カート] │ └─────────────────────────────────────────────────┘

操作仕様

パフォーマンス仕様

バリデーション

エラーハンドリング

---

2.6 家具カタログ（/catalog）

概要: 複数メーカーの家具を検索・フィルタリング・閲覧する画面。OpenSearchを使った全文検索対応。

検索・フィルタ仕様

ソート

ページネーション

• 1ページ24件表示
• 無限スクロール（モバイル）/ ページネーション（デスクトップ）

出力（商品カード）

---

2.7 家具詳細（/catalog/[productId]）

概要: 個別商品の詳細情報・3Dプレビュー・購入アクション画面。

入力

出力

バリデーション

---

2.8 AIコーディネート（/rooms/[id]/ai-coordinate）

概要: ユーザーの入力条件をもとにClaudeAPIがコーディネート提案を生成する画面。

入力フォーム

処理フロー

1. フォーム送信 → POST /api/ai/coordinate
2. WebSocketで生成進捗を受信（ストリーミング）
3. 最低3パターン生成（約5秒以内に初回パターン表示）
4. 各パターン: 配置家具リスト + 合計金額 + コーディネート解説

出力（コーディネートカード）

エラーハンドリング

---

2.9 コミュニティ（/community）

概要: ユーザーがルームデザインを投稿・閲覧・交流する画面。

一覧画面

投稿詳細（/community/[postId]）

投稿フォーム（/community/new）

---

2.10 カート・チェックアウト（/cart, /checkout）

概要: カート管理・購入手続きの画面。メーカーをまたぐ複数商品を一括管理。

カート画面

チェックアウト画面

バリデーション

エラーハンドリング

---

2.11 マイページ（/mypage）

概要: ユーザーのアカウント情報・注文履歴・お気に入り管理画面。

サブページ構成

---

3. メーカー向け画面仕様

3.1 メーカー申請フォーム（/maker/apply）

概要: メーカーとして出店申請を行うフォーム。審査ワークフローの起点。

入力

エラーハンドリング

---

3.2 ダッシュボード（/maker/dashboard）

概要: メーカーの主要KPI・通知・クイックアクションを表示するホーム画面。

KPIカード（本日/今月/累計）

通知一覧

---

3.3 商品管理（/maker/products）

概要: 商品の登録・編集・公開管理を行う画面。

商品一覧

商品登録フォーム（/maker/products/new, /maker/products/[id]/edit）

基本情報

価格・在庫

寸法・素材

バリエーション

画像・3Dモデル

バリデーション（共通）

---

3.4 3Dモデル管理（/maker/models）

概要: 3Dモデルのアップロード・変換・プレビュー・バージョン管理画面。

アップロード仕様

自動品質チェック

写真→3D変換ツール（AI変換）

---

3.5 注文管理（/maker/orders）

概要: プラットフォーム経由の注文を管理する画面。

注文一覧フィルタ

注文詳細（/maker/orders/[orderId]）

ステータス変更ルール

詳細は 8.1 注文ステータス遷移 を参照。

---

3.6 アナリティクス（/maker/analytics）

概要: 商品パフォーマンス・ユーザー行動の詳細分析ダッシュボード。

グラフ・指標一覧

エクスポート

• CSV形式でダウンロード可能
• 全指標のRAWデータを対象期間で出力

---

4. プラットフォーム管理画面仕様

4.1 メーカー審査管理（/admin/makers）

概要: メーカー申請の審査・承認・却下を行う管理画面。

審査フロー

1. 申請受付 → ステータスPENDING
2. 担当者アサイン → ステータスREVIEWING
3. 審査実施（書類確認・サイト確認）
4. 承認 → ステータスAPPROVED + メーカーへ通知メール
5. 却下 → ステータスREJECTED + 却下理由メール

審査チェックリスト

---

4.2 カテゴリマスタ管理（/admin/categories）

概要: 商品カテゴリの階層管理（3階層まで）。

カテゴリツリー（初期データ）

リビング ├── ソファ │ ├── 1人掛け │ ├── 2人掛け │ ├── 3人掛け │ └── コーナー/L字 ├── テレビ台・ローボード ├── センターテーブル/ローテーブル ├── シェルフ・棚 └── ラグ・カーペット ダイニング ├── ダイニングテーブル ├── ダイニングチェア └── 食器棚・キッチン収納 寝室 ├── ベッド・寝具 │ ├── シングル │ ├── セミダブル │ ├── ダブル │ └── クイーン/キング ├── マットレス ├── 枕・寝具 ├── ドレッサー └── チェスト・たんす 書斎・ワークスペース ├── デスク ├── チェア・ワークチェア ├── 本棚・ブックシェルフ └── 収納ボックス・ファイルケース 収納・クローゼット ├── ワードローブ・洋服タンス ├── チェスト ├── シューズラック └── ハンガーラック その他・インテリア小物 ├── 照明・ライト ├── ミラー・鏡 ├── 観葉植物 └── インテリア雑貨

---

5. API仕様

5.1 認証

全APIエンドポイント（/api/public/を除く）は、リクエストヘッダーに有効なJWTトークンが必要です。

Authorization: Bearer <access_token>

または HttpOnly Cookie rc_access_token。

---

5.2 共通レスポンス形式

成功

{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "limit": 24,
    "total": 100
  }
}

エラー

{
  "success": false,
  "error": {
    "code": "PRODUCT_NOT_FOUND",
    "message": "商品が見つかりませんでした",
    "details": {}
  }
}

---

5.3 消費者向けAPI

認証

ルーム管理

POST /api/rooms リクエスト

{
  "name": "リビングルーム",
  "floorPlan": {
    "width": 500,
    "depth": 400,
    "height": 240,
    "shape": "rectangle",
    "walls": [
      { "x1": 0, "y1": 0, "x2": 500, "y2": 0 },
      ...
    ],
    "doors": [{ "wallIndex": 0, "offset": 100, "width": 80, "direction": "left" }],
    "windows": [{ "wallIndex": 2, "offset": 50, "width": 160 }]
  },
  "furnitures": []
}

PUT /api/rooms/:roomId/furnitures リクエスト

{
  "furnitures": [
    {
      "productId": "prod_abc123",
      "variantId": "var_def456",
      "position": { "x": 100, "y": 0, "z": 150 },
      "rotation": { "x": 0, "y": 90, "z": 0 },
      "scale": { "x": 1, "y": 1, "z": 1 }
    }
  ]
}

家具カタログ

GET /api/products クエリパラメータ

AIコーディネート

POST /api/ai/coordinate リクエスト

{
  "roomId": "room_abc123",
  "budget": 500000,
  "styles": ["natural", "nordic"],
  "colorTone": "warm",
  "familyType": "couple",
  "priorityCategories": ["sofa", "dining_table"],
  "excludeMakerIds": [],
  "freeText": "北欧ナチュラルな雰囲気で、木の温もりを感じる空間にしたい"
}

SSEレスポンス（event-stream）

event: progress data: {"step": 1, "message": "部屋の情報を分析中..."} event: pattern data: {"patternIndex": 1, "name": "スカンジナビアンナチュラル", "furnitures": [...], "totalPrice": 480000, "comment": "..."} event: complete data: {"totalPatterns": 3}

カート・注文

POST /api/orders リクエスト

{
  "cartId": "cart_abc123",
  "shippingAddress": {
    "name": "山田 太郎",
    "postalCode": "1500001",
    "prefecture": "東京都",
    "city": "渋谷区",
    "line1": "神南1-2-3",
    "line2": "マンション101",
    "phone": "09012345678"
  },
  "paymentMethodId": "pm_stripe_xxx",
  "couponCode": "SUMMER2026"
}

コミュニティ

---

5.4 メーカー向けAPI

全エンドポイントは /api/maker/ プレフィックス。メーカーアカウントでのログインが必要。

商品管理

3Dモデル管理

注文管理

アナリティクス

ブランドストア

---

5.5 プラットフォーム管理API

全エンドポイントは /api/admin/ プレフィックス。管理者アカウント必須。

---

5.6 Webhook（外部サービス連携）

---

6. データモデル（ER図）

erDiagram
    User {
        uuid id PK
        string email UK
        string name
        string ccAuthUserId UK
        string avatarUrl
        enum userType "consumer | maker_staff | admin"
        date birthdate
        timestamp createdAt
        timestamp updatedAt
        timestamp deletedAt
    }

    Maker {
        uuid id PK
        string companyName
        string brandName
        string email UK
        string phone
        string postalCode
        string address
        enum businessType "individual | corporation"
        string corporateNumber
        enum revenueScale "tiny | small | medium | large"
        enum plan "starter | growth | professional | enterprise"
        enum status "pending | reviewing | approved | rejected | suspended"
        string logoUrl
        string brandDescription
        string websiteUrl
        decimal commissionRate
        timestamp approvedAt
        timestamp createdAt
        timestamp updatedAt
    }

    MakerStaff {
        uuid id PK
        uuid userId FK
        uuid makerId FK
        enum role "owner | admin | editor | viewer"
        timestamp createdAt
    }

    Category {
        uuid id PK
        uuid parentId FK
        string name
        string slug UK
        int depth "1-3"
        int sortOrder
        boolean isActive
    }

    Product {
        uuid id PK
        uuid makerId FK
        uuid categoryId FK
        string name
        string description
        string skuCode UK
        int priceBase "税抜定価（円）"
        int priceSale "税抜販売価格（円）"
        int taxRate "8 or 10"
        enum shippingType "free | fixed | by_region | by_weight"
        int shippingFee
        float widthCm
        float depthCm
        float heightCm
        float weightKg
        enum status "draft | reviewing | published | unpublished | deleted"
        string[] styleTags
        string[] materialTags
        timestamp publishedAt
        timestamp createdAt
        timestamp updatedAt
    }

    ProductVariant {
        uuid id PK
        uuid productId FK
        string variantType "color | size"
        string variantLabel
        string colorHex
        int priceAdjust "差額（円）"
        int stockCount
        date restockDate
        boolean isDefault
    }

    ProductImage {
        uuid id PK
        uuid productId FK
        uuid variantId FK
        string url
        int sortOrder
        boolean isMain
    }

    Model3D {
        uuid id PK
        uuid productId FK
        uuid variantId FK
        string s3Key
        string cdnUrl
        string format "glb | gltf | obj | fbx"
        int polygonCount
        int fileSizeMb
        enum status "processing | ready | error"
        string errorMessage
        int version
        timestamp createdAt
    }

    Room {
        uuid id PK
        uuid userId FK
        string name
        jsonb floorPlan "間取りデータ（JSON）"
        jsonb furnitures "配置家具リスト（JSON）"
        string thumbnailUrl
        boolean isPublic
        timestamp createdAt
        timestamp updatedAt
    }

    Cart {
        uuid id PK
        uuid userId FK
        uuid guestSessionId
        timestamp expiresAt
        timestamp createdAt
        timestamp updatedAt
    }

    CartItem {
        uuid id PK
        uuid cartId FK
        uuid productId FK
        uuid variantId FK
        int quantity
        int priceSnapshot "追加時点の価格"
        timestamp addedAt
    }

    Order {
        uuid id PK
        uuid userId FK
        string orderNumber UK
        enum status "pending | confirmed | processing | shipped | delivered | cancelled | refunded"
        jsonb shippingAddress
        string paymentIntentId UK
        int subtotal
        int shippingFee
        int tax
        int total
        string couponCode
        int discountAmount
        timestamp orderedAt
        timestamp updatedAt
    }

    OrderItem {
        uuid id PK
        uuid orderId FK
        uuid makerId FK
        uuid productId FK
        uuid variantId FK
        string productNameSnapshot
        int priceSnapshot
        int quantity
        int subtotal
        enum status "confirmed | processing | shipped | delivered | cancelled | return_requested | returned"
        string trackingNumber
        string shippingCarrier
        timestamp shippedAt
        timestamp deliveredAt
    }

    CommunityPost {
        uuid id PK
        uuid userId FK
        uuid roomId FK
        string title
        string description
        string thumbnailUrl
        string[] styleTags
        enum visibility "public | limited | private"
        int likeCount
        int bookmarkCount
        boolean isOfficialStylist
        timestamp createdAt
        timestamp updatedAt
    }

    PostLike {
        uuid id PK
        uuid postId FK
        uuid userId FK
        timestamp createdAt
    }

    PostBookmark {
        uuid id PK
        uuid postId FK
        uuid userId FK
        timestamp createdAt
    }

    PostComment {
        uuid id PK
        uuid postId FK
        uuid userId FK
        string content
        timestamp createdAt
    }

    ContentReport {
        uuid id PK
        uuid reporterId FK
        string targetType "post | comment | user"
        uuid targetId
        enum reason "spam | inappropriate | copyright | other"
        string description
        enum status "pending | reviewed | resolved"
        timestamp createdAt
    }

    WishlistItem {
        uuid id PK
        uuid userId FK
        uuid productId FK
        uuid variantId FK
        timestamp addedAt
    }

    AICoordinateRequest {
        uuid id PK
        uuid userId FK
        uuid roomId FK
        int budget
        string[] styles
        string colorTone
        string familyType
        string[] priorityCategories
        string[] excludeMakerIds
        string freeText
        jsonb results "生成結果（3パターン）"
        int tokenUsed
        enum status "pending | processing | completed | failed"
        timestamp createdAt
        timestamp completedAt
    }

    MakerApplication {
        uuid id PK
        uuid makerId FK
        uuid reviewerId FK
        string[] checklistItems
        string reviewNote
        enum status "pending | reviewing | approved | rejected"
        timestamp submittedAt
        timestamp reviewedAt
    }

    User ||--o{ Room : "creates"
    User ||--o{ Cart : "has"
    User ||--o{ Order : "places"
    User ||--o{ CommunityPost : "posts"
    User ||--o{ WishlistItem : "saves"
    User ||--o{ AICoordinateRequest : "requests"
    User ||--o{ MakerStaff : "belongs to"
    Maker ||--o{ MakerStaff : "has"
    Maker ||--o{ Product : "owns"
    Maker ||--o{ OrderItem : "fulfills"
    Product ||--o{ ProductVariant : "has"
    Product ||--o{ ProductImage : "has"
    Product ||--o{ Model3D : "has"
    Product ||--o{ CartItem : "added to"
    Product ||--o{ OrderItem : "ordered as"
    Product ||--o{ WishlistItem : "saved as"
    Category ||--o{ Product : "contains"
    Category ||--o{ Category : "has children"
    Cart ||--o{ CartItem : "contains"
    Order ||--o{ OrderItem : "has"
    CommunityPost ||--o{ PostLike : "receives"
    CommunityPost ||--o{ PostBookmark : "receives"
    CommunityPost ||--o{ PostComment : "has"
    Room ||--o{ CommunityPost : "featured in"

---

7. ビジネスロジック仕様

7.1 販売手数料計算

メーカーのプランに応じて、プラットフォームへの手数料が異なる。

計算式

売上 = 商品価格（税込）× 数量 手数料 = 売上 × 手数料率 メーカー受取額 = 売上 - 手数料

精算サイクル: 月末締め翌月末払い（Stripe Connect経由）

---

7.2 商品掲載数制限

プランごとに掲載できる商品数の上限を管理する。

判定タイミング: 商品を「公開」状態に変更しようとした時点で判定。上限超過時はエラーを返す。

エラーコード: PRODUCT_LIMIT_EXCEEDED メッセージ: "現在のプラン（Starter）では最大20点まで掲載できます。プランをアップグレードしてください"

---

7.3 AIコーディネート生成ロジック

Claude API（claude-3-7-sonnet）を使用して、以下のフローで家具提案を生成する。

入力コンテキスト

1. 部屋の間取り情報（サイズ、形状、開口部）
2. ユーザー設定（予算、スタイル、家族構成等）
3. 利用可能な家具DB（予算・カテゴリでフィルタ後、上位100件）

生成プロンプト構造

System: あなたはプロのインテリアスタイリストです...（スタイルガイドライン） User: 以下の条件でインテリアコーディネートを3パターン提案してください。 - 部屋: {width}cm × {depth}cm、{style}間取り - 予算: ¥{budget} - 好みのスタイル: {styles} - 利用可能な家具リスト: {furnitureList} JSON形式で回答してください: { patterns: [...] }

パターン選定基準

• パターン1: 予算内で最も人気の組み合わせ（配置回数スコア優先）
• パターン2: スタイル一致度優先（埋め込みベクトル類似度）
• パターン3: 価格パフォーマンス優先（評価/価格比）

家具配置アルゴリズム

1. 部屋の重心を計算
2. 主要家具（ソファ、ダイニングテーブル等）を先に配置（壁際スナップ）
3. 副次家具をルールベースで配置（サイドテーブルはソファ横、等）
4. 衝突チェック→修正
5. 寸法の最終確認

---

7.4 在庫管理ロジック

楽観的ロックを使用して在庫を管理する。注文確定時に以下の処理を行う。

1. BEGIN TRANSACTION 2. SELECT stock_count FROM product_variants WHERE id = ? FOR UPDATE 3. IF stock_count < quantity THEN ROLLBACK → エラー返却 4. UPDATE product_variants SET stock_count = stock_count - quantity WHERE id = ? 5. CREATE order_item (...) 6. COMMIT

在庫ステータス判定

---

7.5 コミュニティモデレーション

自動フィルタ

• 投稿テキストに不適切ワードが含まれる場合、自動で審査保留状態にする
• 24時間以内に管理者が確認・判定

通報後処理

---

7.6 検索スコアリング

OpenSearchを使用した商品検索スコアは以下の重み付けで計算する。

---

8. 状態遷移仕様

8.1 注文ステータス遷移

stateDiagram-v2
    [*] --> pending : 注文作成（決済処理中）
    pending --> confirmed : Stripe決済完了Webhook受信
    pending --> cancelled : 決済失敗 or タイムアウト（30分）
    confirmed --> processing : メーカーが受注確認
    confirmed --> cancelled : メーカーがキャンセル or 在庫切れ
    processing --> shipped : メーカーが発送処理（追跡番号登録）
    shipped --> delivered : 配送完了（追跡APIまたは手動更新）
    shipped --> return_requested : ユーザーが返品申請
    delivered --> return_requested : ユーザーが返品申請（配送完了後14日以内）
    return_requested --> returned : メーカーが返品承認・着荷確認
    returned --> refunded : Stripe返金処理完了
    cancelled --> refunded : 決済済みの場合、Stripe返金

OrderItemの独立ステータス遷移

各OrderItemは独立してステータスを持ち、異なるメーカーの商品は別々に処理される。OrderのステータスはOrderItem全体の集約で決定する。

---

8.2 メーカー審査ステータス遷移

stateDiagram-v2
    [*] --> pending : メーカー申請フォーム送信
    pending --> reviewing : 管理者が担当者アサイン
    reviewing --> approved : 審査合格
    reviewing --> rejected : 審査不合格
    approved --> suspended : 規約違反・料金未払い等
    suspended --> approved : 問題解消・再審査合格
    rejected --> pending : 再申請（修正後）

---

8.3 商品ステータス遷移

stateDiagram-v2
    [*] --> draft : 商品新規作成
    draft --> reviewing : 公開申請（初回のみ。2回目以降はdraft→publishedへ）
    reviewing --> published : 審査合格（初回登録時）
    reviewing --> draft : 審査不合格（修正要求）
    draft --> published : 再編集後の公開（審査不要）
    published --> unpublished : メーカーが非公開設定
    unpublished --> published : メーカーが再公開
    published --> deleted : 削除（論理削除）
    unpublished --> deleted : 削除（論理削除）

---

8.4 3Dモデル処理ステータス遷移

stateDiagram-v2
    [*] --> uploading : S3アップロード開始
    uploading --> processing : アップロード完了→自動処理開始
    processing --> ready : 品質チェック合格・LOD生成完了
    processing --> error : 品質チェック不合格 or 変換エラー
    error --> uploading : 再アップロード
    ready --> [*] : 商品に紐付け完了

---

9. エラーコード一覧

9.1 認証エラー（AUTH_XXX）

9.2 商品エラー（PRODUCT_XXX）

9.3 注文エラー（ORDER_XXX）

9.4 AIエラー（AI_XXX）

9.5 ファイルエラー（FILE_XXX）

9.6 メーカーエラー（MAKER_XXX）

---

Generated by CCAGI SDK v3.14.4 - Phase 2: Design (spec.md) 作成日: 2026-03-19