[Ken] カテゴリー

R.Designのデザインファミリーは、ユーザーが効率的にアセットを閲覧、フィルタリング、発見できるようにする包括的なカテゴリーシステムを使用して整理されています。

属性とメタデータ

カテゴリーには、R.Designカタログシステム内での動作、可視性、組織を制御するメタデータが含まれています。

プライマリキー

例: a48100000008VTKAA2

基本情報

コア識別子と表示名：

例:

• name: "Wall"
• name_ja: "壁紙"
• url_key: "wall-coverings"

目的:

• name / name_ja - カタログナビゲーションとフィルターに表示
• url_key - /catalog/wall-coveringsのようなURLで使用

カテゴリー階層

カテゴリーは階層的組織をサポート：

階層の例:

家具（ルート）
└── 座席（親: 家具）
    └── 椅子（親: 座席）
        └── ダイニングチェア（親: 椅子）

• root_category: "家具"
• parent_category: "a4fOQ000000seatingYAA"（座席のsfid）

アプリ構成

カテゴリーがR.Designアプリケーションにどのように表示されるかを制御：

表示制御:

表示されるカテゴリー:

• for_app: true
• is_active: "true"
• include_in_navigation_menu: "true"
• order: 1.0（最初に表示）

非表示カテゴリー:

• for_app: false
• is_active: "false"
• include_in_navigation_menu: "false"

サムネイルパスの例:

• thumbnail_for_app: "/images/categories/furniture-thumb.jpg"

コンテンツタイプ分類

このカテゴリーに含まれるコンテンツのタイプを定義：

使用例:

3Dオブジェクトカテゴリー（家具、照明、装飾）:

• is_non_mesh: false - 3Dメッシュを含む
• exclude_from_app_items_catalog: false - アイテムカタログに表示

マテリアルカテゴリー（ファブリック、ペイント、壁、床）:

• is_non_mesh: true - マテリアルを含み、3Dオブジェクトではない
• exclude_from_app_items_catalog: true - アイテムカタログに表示せず、マテリアルに表示

なぜこれが重要か:

• どのカタログビューにアイテムを表示するかを決定
• 検索動作とフィルタリングロジックに影響
• 利用可能なユーザーインタラクションを制御（配置 vs 適用）

カスタムリンク

カスタムナビゲーションと外部リンクを有効化：

カスタムリンクの例:

外部ブランドページ:

• custom_link: "https://brand.example.com/collection"
• open_link_in_new_tab: true

内部特別ビュー:

• custom_link: "/catalog/special-promo"
• open_link_in_new_tab: false

クエリカテゴリー名: 検索とフィルタリング操作に使用：

• to_query_category_name: "座席,椅子,ダイニングチェア"（カンマ区切りの階層）

システムメタデータ

内部システム構成：

タイムスタンプの使用:

• カテゴリーライフサイクルの追跡
• キャッシュ無効化
• 監査ログ
• 外部システムとの同期

主要カテゴリー

デザインファミリーは階層的なカテゴリー構造に整理されています。以下に示すカテゴリーは、カタログAPIから取得されたR.Designで使用される実際のカタログ構造を表しています。

すべてのアイテム（3Dオブジェクト）

3D家具、什器、装飾オブジェクトの主要コレクション。

テーブル

テーブルと作業面。

サブカテゴリー:

• ダイニングテーブル - ダイニングテーブル
• コーヒーテーブル - コーヒーテーブル
• サイドテーブル - サイドテーブル
• デスク - 机
• ミーティングテーブル - 会議テーブル
• こたつ - こたつ
• 壁掛けテーブル - 壁掛けテーブル
• 天板 - 天板
• 脚 - 脚

カテゴリーID: a48100000008VRiAAM

座席

椅子、ソファ、座席家具。

サブカテゴリー:

• ダイニングチェア - ダイニング・チェア
• スツール - スツール
• ベンチ - ベンチ
• 1人掛けソファ - 1人掛けソファ
• 造作ベンチ - 造作ベンチ
• その他のソファバリエーション（2人掛け、3人掛け、セクショナル）

カテゴリーID: a48100000008VREAA2

使用:

• ルーム内に3Dオブジェクトとして配置
• 多くはファブリックカスタマイゼーションをサポート
• 構成可能なバリアント（サイズ、張り地、仕上げ）

収納

収納家具とキャビネット。

種類に含まれるもの:

• キャビネットと棚ユニット
• ドレッサーとワードローブ
• 本棚
• メディア収納
• オフィスファイリング

使用:

• ルームレイアウトを整理
• 機能的な収納を追加
• 装飾アイテムを展示

ベッド

寝室家具。

種類に含まれるもの:

• ベッド（シングル、ダブル、クイーン、キング）
• ナイトスタンド
• 寝室収納
• ヘッドボード

照明

シーンを機能的に照らす照明器具とランプ。

種類に含まれるもの:

• 天井照明（ペンダント、シャンデリア、フラッシュマウント）
• テーブルランプ
• フロアランプ
• ウォールスコンス
• アクセント照明

使用:

• ルーム内に3Dオブジェクトとして配置
• 光を放つ（シーン照明に影響）
• 動的な影を投影
• 調整可能な強度と色温度

キッチン

キッチン専用の家具と什器。

種類に含まれるもの:

• キッチンキャビネット
• 電化製品
• 什器
• キッチンアイランド
• ハードウェア

バス

バスルームの什器と家具。

種類に含まれるもの:

• シンクと洗面台
• トイレ
• バスタブとシャワー
• 蛇口とハードウェア
• バスアクセサリー

装飾

装飾オブジェクトとアクセサリー。

種類に含まれるもの:

• アートワークと壁装飾
• 花瓶と陶器
• 書籍と雑誌
• 植物（鉢植え、アレンジメント）
• 彫刻とフィギュア
• 装飾アクセサリー

使用:

• ルームに仕上げのタッチを追加
• 視覚的な興味を創出
• 棚や表面をスタイリング
• スペースに個性を追加

アウトドア

外部と屋外要素。

種類に含まれるもの:

• パティオ家具
• ガーデン座席
• 屋外照明
• ランドスケープ要素
• プランター

ラグ

床ラグとカーペット。

種類に含まれるもの:

• エリアラグ
• ランナーラグ
• 円形ラグ
• さまざまなサイズとスタイル

使用:

• ルーム内でスペースを定義
• テクスチャと温かみを追加
• 家具と調和

マテリアルカテゴリー

表面と仕上げのための非メッシュマテリアル。

ファブリック

張り地とソフトファーニッシング用のテキスタイルマテリアル。

カテゴリーID: a48100000008VTKAA2

種類に含まれるもの:

• 張り地ファブリック
• パフォーマンスファブリック
• 天然繊維（コットン、リネン、ウール）
• 合成マテリアル
• レザーとフェイクレザー

使用:

• 家具の張り地に適用
• 構成可能なアイテムをカスタマイズ
• 調和したマテリアルパレットを作成

壁

壁紙、壁装材、壁処理。

カテゴリーID: a48100000008VTPAA2

サブカテゴリー:

• タイル
• 外壁

種類に含まれるもの:

• パターン壁紙
• テクスチャ壁装材
• 壁画とアクセントウォール
• タイルパターン
• 木材パネル
• 外壁仕上げ

使用:

• 壁面に適用
• アクセントウォールを作成
• ペイントと重ねて効果を出す
• 建築スタイルを定義

床

床材と仕上げ。

カテゴリーID: a48100000008VTPAA2

種類に含まれるもの:

• 硬木（オーク、メープル、ウォールナットなど）
• タイル（セラミック、磁器、石）
• カーペット
• ビニール/LVT
• コンクリート
• 特殊床材（竹、コルク）

使用:

• 床面に適用
• 異なる床材でルームゾーンを定義
• 巾木処理と合わせる

専門カテゴリー

巾木

巾木とトリム要素。

カテゴリーID: a4810000000LD82AAG

天井

天井仕上げと処理。

カテゴリーID: a4810000000LD83AAG

カーテン & ブラインド

窓装飾と覆い。

カテゴリーID: a4810000000UkIdAAK

サブカテゴリー:

• ドレープカーテン - ドレープカーテン
• レースカーテン - レースカーテン
• ブラインド - ブラインド

絵画

壁用のアートワークと写真。

カテゴリーID: a4810000000dtiPAAQ

サブカテゴリー:

• ペインティング
• 写真

使用:

• 壁にアートワークを追加
• ギャラリーウォールを作成
• スペースをパーソナライズ

HDRI

環境照明と背景用の高ダイナミックレンジ画像。

カテゴリーID: a488400000000HfAAI

サブカテゴリー:

• 空
• 屋外
• スタジオ
• 都市
• 正午
• 日の出/日の入り
• 夜

使用:

• 環境照明を設定
• リアルな反射を作成
• 製品レンダリングの背景
• 大気効果

背景

シーン用の背景要素。

カテゴリーID: a4810000000UlaIAAS

カテゴリー階層

R.Designのカテゴリーは、ネストされたナビゲーション、ブレッドクラム、整理された閲覧を可能にする階層構造を使用します。構造はparent_categoryおよびroot_category属性によって定義される親子関係に従います。

カテゴリー階層の理解

各カテゴリーは以下を持つことができます：

• ルートカテゴリー - トップレベルカテゴリー（例：「3D App Default」）
• 親カテゴリー - 直近の親（sfidで参照）
• 子 - 下にネストされたサブカテゴリー
• カテゴリークエリ - 階層を示す完全パス

APIからの例:

{
  "name": "Dining Chair",
  "name_ja": "ダイニング・チェア",
  "sfid": "a48100000008VRJAA2",
  "category_query": "3D App Default/All Items/SEATING/Dining Chair"
}

これは：ルート → すべてのアイテム → 座席 → ダイニングチェアを示します

完全な階層構造

カタログAPIに基づく、完全なカテゴリーツリー：

3D App Default（ルート）

3D App Default
├── すべてのアイテム
│   ├── テーブル
│   │   ├── ダイニングテーブル
│   │   ├── コーヒーテーブル
│   │   ├── サイドテーブル
│   │   ├── デスク
│   │   ├── ミーティングテーブル
│   │   ├── こたつ
│   │   ├── 壁掛けテーブル
│   │   ├── 天板
│   │   └── 脚
│   │
│   ├── 座席
│   │   ├── ダイニングチェア
│   │   ├── スツール
│   │   ├── ベンチ
│   │   ├── 1人掛けソファ
│   │   ├── 2人掛けソファ
│   │   ├── 3人掛けソファ
│   │   ├── セクショナルソファ
│   │   └── 造作ベンチ
│   │
│   ├── 収納
│   │   ├── 棚
│   │   ├── キャビネット
│   │   ├── 引き出し
│   │   └── ...
│   │
│   ├── ベッド
│   ├── 照明
│   ├── キッチン
│   ├── バス
│   ├── 装飾
│   ├── アウトドア
│   └── ラグ
│
├── ファブリック
│
├── 壁
│   ├── タイル
│   └── 外壁
│
├── 床
│
├── 巾木
│
├── 天井
│
├── カーテン & ブラインド
│   ├── ドレープカーテン
│   ├── レースカーテン
│   └── ブラインド
│
├── 絵画
│   ├── ペインティング
│   └── 写真
│
├── HDRI
│   ├── 空
│   ├── 屋外
│   ├── スタジオ
│   ├── 都市
│   ├── 正午
│   ├── 日の出/日の入り
│   └── 夜
│
└── 背景

アプリでの階層の動作

ナビゲーション

ブレッドクラムトレイル:

ホーム > すべてのアイテム > テーブル > ダイニングテーブル

フィルター:

• 「すべてのアイテム」を選択 → すべての3Dオブジェクトを表示
• 「テーブル」を選択 → テーブルのみに絞り込み
• 「ダイニングテーブル」を選択 → ダイニングテーブルのみを表示

カテゴリークエリパス

category_queryフィールドは完全パスを保存：

• "3D App Default/All Items/TABLE/Dining Table"
• フィルタリングと検索に使用
• 「親カテゴリー」ナビゲーションを有効化

APIレスポンス構造

{
  "name": "TABLE",
  "sfid": "a48100000008VRiAAM",
  "parent_category": "a48100000008VR9AAM",
  "root_category": "3D App Default",
  "children": [
    {
      "name": "Dining Table",
      "sfid": "a48100000008VRnAAM",
      "parent_category": "a48100000008VRiAAM"
    }
  ]
}

カテゴリー間の関係

一部のデザインファミリーは異なるカテゴリーブランチ間で関連：

例: 完全なダイニングルーム

主要アイテム（すべてのアイテムブランチ）:

• テーブル → ダイニングテーブル
• 座席 → ダイニングチェア
• 照明 → ペンダントライト
• 装飾 → センターピース
• ラグ → エリアラグ

マテリアル（マテリアルブランチ）:

• ファブリック → 椅子の張り地
• 壁 → 壁紙
• 床 → 木製フローリング

階層ナビゲーションパターン

トップダウン閲覧

広範囲から始めて絞り込む：

1. ルートレベル → 「3D App Default」
2. 主要カテゴリー → 「すべてのアイテム」または「ファブリック」
3. カテゴリー → 「座席」
4. サブカテゴリー → 「ダイニングチェア」

カテゴリーコンテキストでの検索

検索はカテゴリー階層を理解：

クエリ: 「オークダイニングチェア」

• 自動フィルター：すべてのアイテム → 座席 → ダイニングチェア
• マテリアルフィルターを適用：木材 → オーク

関連カテゴリー

アプリは関連カテゴリーを提案：

閲覧中: ダイニングテーブル 提案:

• ダイニングチェア（同じルームコンテキスト）
• テーブルランプ（補完機能）
• プレースマット（関連装飾）

特別な階層ケース

フラットカテゴリー

一部のカテゴリーには子がない：

• ファブリック - すべてのファブリックが同じレベル
• 床 - すべての床材が同じレベル
• 背景 - 単一レベルカテゴリー

深い階層

一部のカテゴリーは3+レベルの深さ：

• すべてのアイテム → テーブル → ダイニングテーブル → （潜在的なバリアント）
• HDRI → 屋外 → （特定のHDRIタイプ）

複数のパス

一部のアイテムは複数のカテゴリーパスに表示される場合があります：

• セクショナルソファは「座席」と「ソファ」サブカテゴリーの両方にある可能性
• カテゴリーシステムで重複を防止

ベストプラクティス

ユーザー向け

効率的な閲覧:

• 主要カテゴリーから開始
• サブカテゴリーで絞り込む
• 必要に応じてマテリアルタイプフィルターを追加
• 最終的な絞り込みにスタイル/ブランドを使用

コレクションの整理:

• カテゴリーだけでなくプロジェクトでグループ化
• 完全なルームセットのためにカテゴリーを混在
• クイックアクセスのためにお気に入りをタグ付け
• カテゴリーフィルター付きカタログを共有

コンテンツクリエイター向け

適切なカテゴリー化:

• ✅ 最も具体的な適用可能なカテゴリーを選択
• ✅ 正確なマテリアルタイプタグを追加
• ✅ 関連サブカテゴリーを含める
• ✅ スタイルタグを適切に使用
• ❌ 可視性のために間違ったカテゴリーに無理に入れない

メタデータ品質:

• 正確な説明を提供
• すべての関連タグを含める
• マテリアルタイプを明確に指定
• 特別機能を文書化