[Ken] デザインバージョンエレメント

**デザインバージョンエレメント（Design Version Elements）**は、デザインバージョンのマテリアルスロット内の個々のマテリアルオプションを表します。これらは、マテリアルスロットの定義、属性オプションの構成、および視覚的な順序付けメタデータを結合することによって生成されます。

🎨

重要な概念

デザインバージョンエレメントは、以下のテーブルを結合します：

Material Slots（デザインバージョンごとに定義され、material_typeを所有）
AAOJ（Attribute_Attribute_Option_Junction） - 中間テーブル
ForcegentoAttributeOptionVisualOrder（AV） - 実際のマテリアルを表す

AAOJにリンクされた新しいForcegentoAttributeOptionVisualOrderレコードを作成すると、対応するデザインバージョンエレメントが自動的にビューに表示されます。

デザインバージョンエレメントとは？

デザインバージョンエレメントは、Material Slot、AAOJ、ForcegentoAttributeOptionVisualOrderのデータを組み合わせて、各マテリアルスロットで利用可能なマテリアルオプションの全体像を提供します。これにより以下が可能になります：

マテリアルオプション - 各スロットで利用可能なマテリアルの選択肢（ファブリック、ペイントなど）
視覚設定 - 色の色合い（tint）、サムネイル、表示プロパティの制御
属性のリンク - 製品属性を特定のマテリアルオプションに接続
順序と表示 - マテリアルオプションごとの位置と可視性ルール
ローカリゼーション - エレメント名とラベルの多言語サポート

階層関係

Design Family → Design Version → Material Slot → Design Version Element(s)
                                       ↓
                                  Design Product Attribute Junction (DPJ)
                                       ↓
                    Attribute Attribute Option Junction (AAOJ) ←→ ForcegentoAttributeOptionVisualOrder (AV) ←→ Material
                                       ↓
                            (generates view records)
                                       ↓
                              Design Version Elements

データベース構造:

Material Slot - デザインバージョンレベルで定義され、material_type（ファブリック、ペイントなど）を所有
AAOJ (Attribute_Attribute_Option_Junction) - 属性と属性オプションをリンクする中間テーブル
ForcegentoAttributeOptionVisualOrder (AV) - 視覚的プロパティ、位置、メタデータを持つ実際のマテリアルを表す
Design Version Element - 上記のテーブルを結合するデータベースビュー

例：ソファのカスタマイズ

Design Family: "DANISH SOFA"
└── Design Version: "v2.0"
    ├── Material Slot: "Element0" (material_type: "fabric")
    │   └── Design Version Elements (view records):
    │       ├── Element: "Standard Gray Fabric" (AAOJ: #123)
    │       ├── Element: "Premium Navy Fabric" (AAOJ: #124)
    │       └── Element: "Luxury Velvet" (AAOJ: #125)
    │
    ├── Material Slot: "Element1" (material_type: "paint")
    │   └── Design Version Elements (view records):
    │       ├── Element: "White Oak" (AAOJ: #126)
    │       ├── Element: "Walnut Stain" (AAOJ: #127)
    │       └── Element: "Black Matte" (AAOJ: #128)
    │
    └── Material Slot: "Element2" (material_type: "wood")
        └── Design Version Elements (view records):
            ├── Element: "Natural Wood" (AAOJ: #129)
            └── Element: "Brushed Metal" (AAOJ: #130)

重要な洞察:

Material Slotは場所とタイプを定義します（例：「Element0」は「fabric」マテリアルを受け入れる）
AAOJは属性と属性オプションをリンクする中間テーブルです
ForcegentoAttributeOptionVisualOrder (AV) はマテリアルそのものを表します
AAOJを介してリンクされた各AVレコードは、デザインバージョンエレメント（特定のマテリアルオプション）を作成します

属性とメタデータ

デザインバージョンエレメントは、複数のテーブルから結合されたデータを公開するデータベースビューレコードです。属性は、基礎となるデータモデルの異なるソーステーブルから来ます。

⚠️

データベースビューの性質

デザインバージョンエレメントはビューであり（テーブルではない）、レコードを直接挿入/更新/削除することはできません。代わりに：

属性をリンクするためのAAOJレコードを作成/更新
マテリアルを表すForcegentoAttributeOptionVisualOrder（AV）レコードを作成/更新
ビューはこれらの変更を自動的に反映します

コアID

基本的な識別子と命名（AAOJおよび関連テーブルから）：

Attribute	Type	Description
`sfid`	String (18 chars)	Primary key, Salesforce ID format
`index_number`	Integer	Numeric identifier for 3D App
`name`	String (max 80)	Design version name
`element_name`	String (max 255)	AV value name
`element_label_name`	String (max 255)	material label name
`element_sfid`	String (18 chars)	AV sfid

Example:

sfid: "a80OQ000002A34BYAS"
index_number: 1
name: "v2.0"
element_name: "AV-xxxxxx"
element_label_name: "Burnt Orange Fabric"
element_sfid: "a81OQ000002A35CYAS"

リレーションシップ

親エンティティおよび属性構成へのリンク（これらがビューに表示されるものを定義します）：

Attribute	Type	Description
`design_family_sfid`	Foreign Key	Reference to parent Design Family
`design_product_attribute_junction_sfid`	Foreign Key	Junction to product attributes (links to Material Slot)
`attribute_attribute_option_junction_sfid`	Foreign Key	AAOJ - Junction table linking attribute to attribute option

データフロー:

Design Version
├── Defines Material Slots (via design_product_attribute_junction)
│   └── Each slot has material_type (fabric, paint, etc.)
│
AAOJ (Attribute_Attribute_Option_Junction)
├── Junction table: links Attribute ↔ Attribute Option
├── Does NOT contain material data
└── Referenced by: attribute_attribute_option_junction_sfid
    ↓
ForcegentoAttributeOptionVisualOrder (AV)
├── Represents the MATERIAL itself
├── Contains: material properties, visual settings, position, thumbnails, RGBA
├── Links to AAOJ via aaoj_sfid
└── This is the actual material record
    ↓
Design Version Element (VIEW)
└── Joins Material Slot + AAOJ + AV → Shows materials per slot

新しいマテリアルオプションの作成:

スロットに新しいマテリアルを追加するには：

AAOJが存在するか、作成する - 属性と属性オプションをリンクするジャンクション
ForcegentoAttributeOptionVisualOrder (AV) を作成する - これがマテリアルを表します
デザインバージョンエレメントが自動的にビューに表示されます

Example:

// Step 1: AAOJ junction (may already exist)
AAOJ Record #131
├── attribute_sfid: "element0_attribute" (links to Material Slot "Element0")
├── attribute_option_sfid: "burnt_orange_option"
└── Purpose: Junction linking attribute to option

// Step 2: ForcegentoAttributeOptionVisualOrder (THE MATERIAL)
AV Record #450
├── aaoj_sfid: #131 (references AAOJ)
├── sfid: "AV-xxxxxx"
├── name: "v2.0"
├── position: 10
├── thumbnail_on_app: "cloudinary.com/..."
├── r: 0.9, g: 0.5, b: 0.2, a: 1.0 (orange tint)
├── visibility_app_jp_ja: "Catalog, Search"
├── is_default: false
└── This IS the material record

// Step 3: Design Version Element appears automatically
Design Version Element (view record)
├── sfid: (computed from view)
├── attribute_attribute_option_junction_sfid: #131
├── name: "v2.0" (from AV)
├── material_slot: "Element0" (from Material Slot)
├── material_type: "fabric" (from Material Slot)
├── position: 10 (from AV)
├── thumbnail_on_app: "cloudinary.com/..." (from AV)
└── r, g, b, a: from AV

マテリアルプロパティ

マテリアルタイプとスロット情報（Material Slot定義から継承）：

Attribute	Type	Description	Source
`material_type`	String (Enum)	Type of material (fabric, paint, leather, etc.)	From Material Slot
`base_material_type`	String	Base material classification	From AV (ForcegentoAttributeOptionVisualOrder)
`replaceable_materials`	String/Array	Materials that can replace this element	From Material Slot configuration
`material_slot`	String	Slot identifier where material is applied	From Material Slot

マテリアルタイプの値:

material_typeは個々のエレメントではなく、Material Slotによって所有されます。同じスロット内のすべてのデザインバージョンエレメントは、同じmaterial_typeを共有します。

Type	Common Use Cases
`fabric`	Upholstery, cushions, curtains
`paint`	Wood frames, walls, metal finishes
`leather`	Premium upholstery, accents
`wood`	Natural wood finishes, flooring
`metal`	Hardware, legs, frames
`wallpaper`	Wall coverings
`hdri`	Environmental lighting
`floor`	Flooring materials
`picture`	Decorative images, artwork

設定例:

// Material Slot definition
Material Slot: "Element0"
├── material_type: "fabric"
├── material_slot: "cushion_main"
└── replaceable_materials: ["fabric", "leather", "velvet"]

// All materials (AV records) in this slot inherit the material_type
AV Record: "Gray Fabric" (material_type: "fabric" from slot)
AV Record: "Navy Fabric" (material_type: "fabric" from slot)
AV Record: "Beige Fabric" (material_type: "fabric" from slot)

// Separate slot with different material_type
Material Slot: "Element1"
├── material_type: "paint"
├── material_slot: "frame_surface"
└── replaceable_materials: ["paint", "stain", "lacquer"]

AV Record: "White Oak" (material_type: "paint" from slot)
AV Record: "Walnut" (material_type: "paint" from slot)

🎨

スロットレベルのマテリアルタイプ

material_typeはエレメントごとではなく、Material Slotレベルで定義されます。これにより一貫性が保たれます（すべてのファブリックオプションが一緒に、すべてのペイントオプションが一緒に、など）。

デフォルトマテリアルフラグ

このエレメントがどのデフォルトマテリアルカテゴリに属するかを示すブールフラグ：

Attribute	Type	Description
`default_fabric`	Boolean	Default fabric material element
`default_paint`	Boolean	Default paint material element
`default_leather`	Boolean	Default leather material element
`default_floor`	Boolean	Default floor material element
`default_curtain`	Boolean	Default curtain material element
`default_hdri`	Boolean	Default HDRI environment element
`default_wallpaper`	Boolean	Default wallpaper material element
`default_picture`	Boolean	Default picture/artwork element

使用パターン:

各デザインバージョンエレメントは通常、1つだけデフォルトフラグがtrueに設定されています：

// Cushion fabric element
default_fabric: true
default_paint: false
default_leather: false
// ... other flags: false

// Frame paint element
default_fabric: false
default_paint: true
default_leather: false
// ... other flags: false

// Premium leather option
default_fabric: false
default_paint: false
default_leather: true
// ... other flags: false

アプリケーションフロー:

初期ロード - システムがデフォルトフラグをチェック
マテリアル割り当て - フラグが立てられたマテリアルタイプを適用
ユーザーオーバーライド - replaceable_materialsが許可する場合、顧客は変更可能
レンダリング - 3Dエンジンが指定されたmaterial_slotにマテリアルを適用

⚠️

デフォルトマテリアルの優先順位

エレメントごとにtrueに設定すべきデフォルトフラグは1つだけです。複数のフラグをtrueに設定すると、マテリアル適用で未定義の動作が発生する可能性があります。

視覚プロパティ

外観、色の色合い、サムネイル表示を制御します（ForcegentoAttributeOptionVisualOrder - マテリアルレコードから）：

Attribute	Type	Description	Source
`thumbnail_on_app`	URL	Thumbnail image URL for app display	AV (ForcegentoAttributeOptionVisualOrder)
`element_thumbnail_url`	URL	Element-specific thumbnail	AV (ForcegentoAttributeOptionVisualOrder)
`r`	Float (0-1)	Red channel for texture tinting	AV (ForcegentoAttributeOptionVisualOrder)
`g`	Float (0-1)	Green channel for texture tinting	AV (ForcegentoAttributeOptionVisualOrder)
`b`	Float (0-1)	Blue channel for texture tinting	AV (ForcegentoAttributeOptionVisualOrder)
`a`	Float (0-1)	Alpha channel for transparency	AV (ForcegentoAttributeOptionVisualOrder)
`original_h`	Integer	Original texture height in pixels	AV (ForcegentoAttributeOptionVisualOrder)
`original_w`	Integer	Original texture width in pixels	AV (ForcegentoAttributeOptionVisualOrder)

RGBAカラーティンティング:

RGBA値により、新しいテクスチャを作成せずにランタイムの色調整が可能です：

// Pure white (no tint)
r: 1.0, g: 1.0, b: 1.0, a: 1.0

// Red tint (25% red overlay)
r: 1.0, g: 0.75, b: 0.75, a: 1.0

// Blue tint (50% blue overlay)
r: 0.5, g: 0.5, b: 1.0, a: 1.0

// Semi-transparent (50% opacity)
r: 1.0, g: 1.0, b: 1.0, a: 0.5

サムネイルURL:

両方のサムネイルフィールドは異なる目的で使用されます：

thumbnail_on_app: アプリ/ウェブのマテリアル選択UIで使用
element_thumbnail_url: カタログおよびプレビューコンテキストで使用

Example:

thumbnail_on_app: "https://res.cloudinary.com/.../cushion_fabric_thumb.jpg"
element_thumbnail_url: "https://res.cloudinary.com/.../cushion_fabric_preview.jpg"

r: 1.0
g: 1.0
b: 1.0
a: 1.0

original_h: 1024
original_w: 1024

カラーティンティングワークフロー:

アセットシステムからベーステクスチャをロード
シェーダーでRGBA乗数を適用
結果：新しいテクスチャファイルなしで色付きマテリアル
パフォーマンス：高速でメモリ効率の良い色のバリエーション

配置と表示

エレメントの順序と可視性を制御します（ForcegentoAttributeOptionVisualOrder - マテリアルレコードから）：

Attribute	Type	Description	Source
`position`	Integer	Sort order position in UI lists	AV (ForcegentoAttributeOptionVisualOrder)
`is_default`	Boolean	Whether this is the default element for its slot	AV (ForcegentoAttributeOptionVisualOrder)
`visibility_app_jp_ja`	String (Enum)	Visibility settings for Japanese app	AV (ForcegentoAttributeOptionVisualOrder)
`visibility_limited`	Boolean	Whether visibility is restricted	AV (ForcegentoAttributeOptionVisualOrder)

位置ソート:

position値が低いほど、UIリストの最初に表示されます。これらの値はForcegentoAttributeOptionVisualOrder（AV - マテリアルレコード）から来ます：

Material Slot: "Element0"
├── Material (AV): "Standard Gray" (position: 1, AAOJ: #123) ← Shown first
├── Material (AV): "Premium Navy" (position: 2, AAOJ: #124)
├── Material (AV): "Luxury Beige" (position: 3, AAOJ: #125)
└── Material (AV): "Exclusive Velvet" (position: 10, AAOJ: #126) ← Shown last

デフォルトエレメント:

material_slotごとに1つのマテリアルのみがis_default: trueを持つべきです。これはForcegentoAttributeOptionVisualOrder（AV）レコードで設定されます：

// Element0 slot - multiple material options
Material (AV): "Standard Fabric" (is_default: true, AAOJ: #123) ← Selected by default
Material (AV): "Premium Fabric" (is_default: false, AAOJ: #124)
Material (AV): "Leather Option" (is_default: false, AAOJ: #125)

可視性制御:

Visibility Setting	Behavior
`"Catalog, Search"`	Visible in both catalog and search
`"Catalog"`	Catalog only, hidden from search
`"Exclusive Custom Catalog"`	Custom/curated collections only
`"Don't Show in App"`	Hidden from all UI

可視性制限（Visibility Limited）:

visibility_limited: trueの場合：

エレメントは特定のユーザーグループに制限されます
特別な権限が必要な場合があります
通常、プレミアム/排他的なオプションに使用されます

ローカリゼーション

エレメント名とラベルの多言語サポート（さまざまなソーステーブルから）：

Attribute	Type	Description	Source
`japanese`	String (max 50)	Japanese element name	AAOJ/Attribute Option
`color_palette_tab_label`	String	English label for color palette UI	AV (ForcegentoAttributeOptionVisualOrder)
`color_palette_tab_label_ja`	String	Japanese label for color palette UI	AV (ForcegentoAttributeOptionVisualOrder)

ローカリゼーション例:

// Element configuration
name: "Seat Cushion Fabric"
japanese: "座面生地"
color_palette_tab_label: "Cushion Colors"
color_palette_tab_label_ja: "クッションカラー"

UI表示フロー:

User Language: Japanese (ja-JP)
├── Element Name: Use 'japanese' field
│   └── Fallback: Use 'name' if japanese is empty
│
└── Color Palette Tab: Use 'color_palette_tab_label_ja'
    └── Fallback: Use 'color_palette_tab_label' if _ja is empty

User Language: English (en-US)
├── Element Name: Use 'name' field
└── Color Palette Tab: Use 'color_palette_tab_label'

ベストプラクティス:

常に英語を提供する（name, color_palette_tab_label）
日本市場向けに日本語を提供する（japanese, color_palette_tab_label_ja）
翻訳を簡潔に保つ（日本語名は50文字制限）
文化的に適切な用語を使用する

🌐

ローカリゼーションの優先順位

日本市場のカスタマイズUIは常にローカライズされたフィールドを最初にチェックします。翻訳がない場合は、UIの機能を確保するために英語にフォールバックします。

基本的なソファのカスタマイズ

複数のマテリアルスロットを持つシンプルな家具：

例：ツートンカラーのソファ

Design Family: "NORDIC SOFA"
└── Design Version: "1.0"
    ├── Material Slot: "Element0" (material_type: "fabric")
    │   └── Materials (AV records):
    │       ├── AV: "Gray Linen" (AAOJ: #110, position: 1, is_default: true)
    │       ├── AV: "Navy Cotton" (AAOJ: #111, position: 2)
    │       └── AV: "Brown Leather" (AAOJ: #112, position: 3)
    │
    ├── Material Slot: "Element1" (material_type: "paint")
    │   └── Materials (AV records):
    │       ├── AV: "White Oak" (AAOJ: #120, position: 1, is_default: true)
    │       ├── AV: "Walnut Stain" (AAOJ: #121, position: 2)
    │       └── AV: "Black Matte" (AAOJ: #122, position: 3)
    │
    └── Material Slot: "Element2" (material_type: "wood")
        └── Materials (AV records):
            ├── AV: "Natural Wood" (AAOJ: #130, position: 1, is_default: true)
            ├── AV: "Dark Walnut" (AAOJ: #131, position: 2)
            └── AV: "Brushed Metal" (AAOJ: #132, position: 3)

舞台裏のデータ構造:

Material Slot Table:
├── "Element0" → material_type: "fabric"
├── "Element1" → material_type: "paint"
└── "Element2" → material_type: "wood"

AAOJ Table (9 junction records):
├── #110, #111, #112 → linked to "Element0" attribute
├── #120, #121, #122 → linked to "Element1" attribute
└── #130, #131, #132 → linked to "Element2" attribute

ForcegentoAttributeOptionVisualOrder (AV) Table (9 material records):
├── Each AV record IS a material
├── Contains: name, thumbnails, position, visibility, RGBA, dimensions
├── References AAOJ via aaoj_sfid
└── These ARE the actual materials

Design Version Element VIEW:
└── Joins Material Slot + AAOJ + AV → Shows 9 materials across 3 slots

カスタマイズフロー:

顧客がカタログからソファを選択
UIがマテリアルスロット（座面、フレーム、脚）を表示
各スロットはposition順にデザインバージョンエレメントを表示
デフォルトエレメント（is_default: true）が事前に選択される
顧客は各スロット内の他のオプションに変更可能
3Dプレビューがリアルタイムでマテリアルを更新

複雑なマルチエレメントデザイン

複数のスロットにまたがる多くのカスタマイズオプションを持つ家具：

例：モジュラーセクショナルソファ

Design Family: "MODULAR SECTIONAL"
└── Design Version: "3.0"
    ├── Material Slot: "main_cushion" (material_type: "fabric")
    │   └── Design Version Elements (view records):
    │       ├── "Standard Linen" (AAOJ: #200, position: 1, is_default: true)
    │       ├── "Premium Cotton" (AAOJ: #201, position: 2)
    │       ├── "Velvet Luxury" (AAOJ: #202, position: 3)
    │       └── "Leather Premium" (AAOJ: #203, position: 4)
    │
    ├── Material Slot: "accent_cushion" (material_type: "fabric")
    │   └── Design Version Elements (view records):
    │       ├── "Matching Accent" (AAOJ: #210, position: 1, is_default: true)
    │       ├── "Contrast Blue" (AAOJ: #211, position: 2, r: 0.3, g: 0.5, b: 0.9)
    │       └── "Contrast Red" (AAOJ: #212, position: 3, r: 0.9, g: 0.3, b: 0.3)
    │
    ├── Material Slot: "back_panel" (material_type: "fabric")
    │   └── Design Version Elements (view records):
    │       ├── "Standard Fabric" (AAOJ: #220, position: 1, is_default: true)
    │       └── "Leather Back" (AAOJ: #221, position: 2)
    │
    ├── Material Slot: "frame_finish" (material_type: "paint")
    │   └── Design Version Elements (view records):
    │       ├── "Natural Oak" (AAOJ: #230, position: 1, is_default: true)
    │       ├── "Walnut Stain" (AAOJ: #231, position: 2)
    │       └── "Black Lacquer" (AAOJ: #232, position: 3)
    │
    ├── Material Slot: "leg_hardware" (material_type: "metal")
    │   └── Design Version Elements (view records):
    │       ├── "Brushed Steel" (AAOJ: #240, position: 1, is_default: true)
    │       ├── "Polished Chrome" (AAOJ: #241, position: 2)
    │       └── "Matte Black" (AAOJ: #242, position: 3)
    │
    ├── Material Slot: "piping" (material_type: "fabric")
    │   └── Design Version Elements (view records):
    │       ├── "Standard Piping" (AAOJ: #250, position: 1, is_default: true)
    │       └── "Contrast Piping" (AAOJ: #251, position: 2, visibility_limited: true)
    │
    └── Material Slot: "throw_pillow" (material_type: "fabric")
        └── Design Version Elements (view records):
            ├── "Matching Pillow" (AAOJ: #260, position: 1, is_default: true)
            ├── "Velvet Pillow" (AAOJ: #261, position: 2)
            └── "Pattern Pillow" (AAOJ: #262, position: 3)

データベースレコード数:

Material Slots: 7
AAOJ Records: 20 (links to attribute options)
ForcegentoAttributeOptionVisualOrder Records: 20 (visual properties)
Design Version Elements (VIEW): 20 (automatically generated)

利点:

✅ すべてのマテリアル表面に対する詳細な制御
✅ 各スロットが関連するマテリアルオプションをグループ化
✅ スロット間でのミックスアンドマッチ
✅ アクセントエレメントのカラーティンティング（RGB値）
✅ visibility_limitedによるプレミアムオプション
✅ スロットごと、次にスロット内のposition順に整理

ルームシーン構成

複数のマテリアルスロットを持つ3Dルームシーンの環境要素：

例：完全なルームデザイン

Design Family: "LIVING ROOM SCENE"
└── Design Version: "2.0"
    ├── Material Slot: "sofa_upholstery" (material_type: "fabric")
    │   └── Design Version Elements:
    │       ├── "Gray Linen" (AAOJ: #300)
    │       ├── "Navy Cotton" (AAOJ: #301)
    │       └── "Beige Velvet" (AAOJ: #302)
    │
    ├── Material Slot: "wall_surface" (material_type: "paint")
    │   └── Design Version Elements:
    │       ├── "Warm White" (AAOJ: #310)
    │       ├── "Light Gray" (AAOJ: #311)
    │       └── "Sage Green" (AAOJ: #312)
    │
    ├── Material Slot: "accent_wall" (material_type: "wallpaper")
    │   └── Design Version Elements:
    │       ├── "No Wallpaper" (AAOJ: #320, is_default: true)
    │       ├── "Geometric Pattern" (AAOJ: #321)
    │       ├── "Floral Design" (AAOJ: #322)
    │       └── "Solid Color" (AAOJ: #323)
    │
    ├── Material Slot: "floor_surface" (material_type: "floor")
    │   └── Design Version Elements:
    │       ├── "Oak Hardwood" (AAOJ: #330)
    │       ├── "Marble Tile" (AAOJ: #331)
    │       └── "Beige Carpet" (AAOJ: #332)
    │
    ├── Material Slot: "window_treatment" (material_type: "fabric")
    │   └── Design Version Elements:
    │       ├── "Sheer White" (AAOJ: #340, default_curtain: true)
    │       ├── "Linen Drapes" (AAOJ: #341)
    │       └── "Blackout Curtain" (AAOJ: #342)
    │
    ├── Material Slot: "artwork_frame" (material_type: "picture")
    │   └── Design Version Elements:
    │       ├── "Abstract Art 1" (AAOJ: #350, original_h: 1920, original_w: 1080)
    │       ├── "Abstract Art 2" (AAOJ: #351, original_h: 1920, original_w: 1080)
    │       └── "Landscape Photo" (AAOJ: #352, original_h: 1920, original_w: 1080)
    │
    └── Material Slot: "environment_light" (material_type: "hdri")
        └── Design Version Elements:
            ├── "Daylight Soft" (AAOJ: #360, default_hdri: true)
            ├── "Sunset Warm" (AAOJ: #361)
            └── "Studio Bright" (AAOJ: #362)

シーン構成:

この構成により、7つのマテリアルスロットを通じて完全なルームカスタマイズが可能になります：

Slot	Material Type	Purpose	Elements
sofa_upholstery	fabric	Furniture materials	3 options
wall_surface	paint	Wall finishes	3 options
accent_wall	wallpaper	Feature wall	4 options
floor_surface	floor	Flooring materials	3 options
window_treatment	fabric	Curtains/drapes	3 options
artwork_frame	picture	Wall decorations	3 options
environment_light	hdri	Lighting atmosphere	3 options

合計: 7つのマテリアルスロット、22のデザインバージョンエレメント（ビューレコード）

プレミアムマテリアルオプション

ForcegentoAttributeOptionVisualOrderを通じて管理される可視性制御を持つ排他的なマテリアル：

例：ラグジュアリーアームチェアコレクション

Design Family: "LUXURY ARMCHAIR"
└── Design Version: "1.0"
    └── Material Slot: "upholstery" (material_type: "fabric")
        └── Design Version Elements (view records from different tiers):
            ├── "Standard Fabric" (Public Tier)
            │   ├── AAOJ: #400
            │   ├── position: 1
            │   ├── is_default: true
            │   ├── visibility_app_jp_ja: "Catalog, Search"
            │   └── visibility_limited: false
            │
            ├── "Premium Linen" (Public Tier)
            │   ├── AAOJ: #401
            │   ├── position: 2
            │   ├── is_default: false
            │   ├── visibility_app_jp_ja: "Catalog, Search"
            │   └── visibility_limited: false
            │
            ├── "Premium Leather" (Limited Tier)
            │   ├── AAOJ: #402
            │   ├── position: 3
            │   ├── is_default: false
            │   ├── visibility_app_jp_ja: "Catalog"
            │   └── visibility_limited: true
            │
            ├── "Exclusive Velvet" (Exclusive Tier)
            │   ├── AAOJ: #403
            │   ├── position: 4
            │   ├── is_default: false
            │   ├── visibility_app_jp_ja: "Exclusive Custom Catalog"
            │   └── visibility_limited: true
            │
            └── "Italian Leather" (Hidden)
                ├── AAOJ: #404
                ├── position: 5
                ├── is_default: false
                ├── visibility_app_jp_ja: "Don't Show in App"
                └── visibility_limited: true

可視性設定:

すべての可視性設定はForcegentoAttributeOptionVisualOrderレコードから来ます：

AAOJ ID	Material Option	Visibility Setting	Limited?	Who Sees It
#400	Standard Fabric	`"Catalog, Search"`	false	Everyone
#401	Premium Linen	`"Catalog, Search"`	false	Everyone
#402	Premium Leather	`"Catalog"`	true	Registered users
#403	Exclusive Velvet	`"Exclusive Custom Catalog"`	true	VIP/Partners
#404	Italian Leather	`"Don't Show in App"`	true	Admin only

データフロー図

┌─────────────────┐
│ Design Version  │
│                 │
└────────┬────────┘
         │ has many
         ▼
┌─────────────────┐      owns      ┌──────────────┐
│ Material Slot   │─────────────────│material_type │
│                 │                 └──────────────┘
└────────┬────────┘
         │ defines attribute
         ▼
┌─────────────────────────┐
│ Attribute               │
│                         │
└────────┬────────────────┘
         │ linked by
         ▼
┌────────────────────────────┐        ┌──────────────────┐
│ AAOJ                       │◄───────│ AttributeOption  │
│ (junction table)           │  links │ (japanese name)  │
└────────┬───────────────────┘        └──────────────────┘
         │ referenced by
         ▼
┌──────────────────────────────────┐
│ ForcegentoAttributeOption        │
│ VisualOrder (AV)                 │
│ **THIS IS THE MATERIAL**         │
│                                  │
│ Contains:                        │
│ - name, thumbnails               │
│ - position, visibility           │
│ - RGBA color values              │
│ - dimensions (h, w)              │
│ - localization labels            │
│ - base_material_type             │
└──────────────────────────────────┘
         │
         │ all joined into
         ▼
┌──────────────────────────────────┐
│ DesignVersionElement             │
│ (DATABASE VIEW - read only)      │
│ Shows materials per slot         │
└──────────────────────────────────┘

ビューでの作業

⚠️

読み取り専用ビュー

デザインバージョンエレメントのレコードを直接挿入、更新、削除することはできません。すべての変更は、基礎となるソーステーブルに対して行う必要があります。

[Ken] デザインバージョンID Salesforce概要