ALPS大規模マルチベンダーEコマースプラットフォーム

このALPS定義は、AmazonのようなマルチベンダーEコマースプラットフォームに必要な主要コンポーネントをカバーしています。ユーザー管理、製品カタログ、注文処理、在庫管理、マーケットプレイス機能、フルフィルメント、アフィリエイトプログラム、サブスクリプションサービスなど、現代の複雑なEコマースシステムの主要機能を網羅しています。（遷移図はユーザーサイドのみ）

View:
Tags:

Semantic Descriptors

Semantic
Safe
Unsafe
Idempotent

Address

id type title
street semantic 通り名と番号
city semantic 都市名
state semantic 州または県名
postalCode semantic 郵便番号
country semantic 国名
phoneNumber semantic 電話番号

address

Affiliate

id type title
affiliateId semantic アフィリエイトの一意の識別子
name semantic 名前（製品名、カテゴリー名など）
email semantic ユーザーのメールアドレス
website semantic ウェブサイト
earnings semantic 収益
clickCount semantic クリック数
conversionRate semantic コンバージョン率

affiliateId

altText

amount

autoRenew

availableQuantity

baseCost

billingAddress

businessAddress

capacity

Cart

id type title
userId semantic ユーザーの一意の識別子
CartItem semantic カート項目
totalAmount semantic 合計金額
updatedAt semantic 更新日時

CartItem

id type title
productId semantic 製品の一意の識別子
quantity semantic 数量
price semantic 価格

Category

id type title
name semantic 名前（製品名、カテゴリー名など）
description semantic 説明
parentCategory semantic 親カテゴリー
isActive semantic アクティブかどうか

category

city

clickCount

comment

commissionRate

confirmNewPassword

contactInfo

conversionRate

country

couponCode

createdAt

currency

currentPassword

description

dimensions

Discount

id type title
discountId semantic 割引の一意の識別子
name semantic 名前（製品名、カテゴリー名など）
description semantic 説明
discountType semantic 割引の種類
discountAmount semantic 割引額
validFrom semantic 有効開始日
validTo semantic 有効終了日
couponCode semantic クーポンコード

discountAmount

discountId

discountType

doAddReview

id type title
productId semantic 製品の一意の識別子
rating semantic 評価
comment semantic コメント

doAddToCart

id type title
productId semantic 製品の一意の識別子
quantity semantic 数量

doDeleteReview

id type title
reviewId semantic レビューの一意の識別子

doLogin

id type title
email semantic ユーザーのメールアドレス
currentPassword semantic 現在のパスワード

doLogout

doPlaceOrder

id type title
shippingAddress semantic 配送先住所
paymentMethod semantic 支払い方法

doRegister

id type title
name semantic 名前（製品名、カテゴリー名など）
email semantic ユーザーのメールアドレス
currentPassword semantic 現在のパスワード
confirmNewPassword semantic 新しいパスワードの確認

doRemoveCartItem

id type title
productId semantic 製品の一意の識別子

doRequestRefund

id type title
orderId semantic 注文の一意の識別子
reason semantic 理由

doRequestReturn

id type title
orderId semantic 注文の一意の識別子
reason semantic 理由

doUpdateCartItem

id type title
productId semantic 製品の一意の識別子
quantity semantic 数量

doUpdateReview

id type title
reviewId semantic レビューの一意の識別子
rating semantic 評価
comment semantic コメント

doUpdateUserProfile

id type title
name semantic 名前（製品名、カテゴリー名など）
email semantic ユーザーのメールアドレス
phoneNumber semantic 電話番号
address semantic 一般住所

earnings

email

endDate

estimatedDeliveryDate

expiryDate

format

freeShippingThreshold

FulfillmentCenter

id type title
name semantic 名前（製品名、カテゴリー名など）
address semantic 一般住所
capacity semantic 容量
operatingHours semantic 営業時間

fullName

goPaginateOrders

id type title
pageNumber semantic ページ番号
pageSize semantic ページ番号

goPaginateProducts

id type title
pageNumber semantic ページ番号
pageSize semantic ページ番号

goSearchProducts

id type title
searchKeyword semantic 検索キーワード
category semantic カテゴリー
subcategory semantic サブカテゴリー

goToLogin

goToRegister

goToUserCart

goToUserCheckout

goToUserHome

goToUserOrderDetail

goToUserOrderHistory

goToUserProductDetail

goToUserProductList

goToUserProfile

goToUserReturnRefund

goToUserReview

height

helpfulVotes

Image

id type title
imageId semantic 画像の一意の識別子
url semantic URL
altText semantic 代替テキスト
width semantic 幅
height semantic 高さ
size semantic サイズ
format semantic フォーマット

imageId

Inventory

id type title
productId semantic 製品の一意の識別子
quantity semantic 数量
isInStock semantic 在庫があるかどうか
lowStockThreshold semantic 在庫低下警告のしきい値
reservedQuantity semantic 予約済みの数量
availableQuantity semantic 利用可能な数量
updatedAt semantic 更新日時

inventory

isActive

isCustomizable

isDefault

isInStock

isRead

leadTime

Login

id type title
goToRegister safe 登録ページへ移動
doLogin idempotent ログイン

lowStockThreshold

Marketplace

id type title
marketplaceId semantic マーケットプレイスの一意の識別子
name semantic 名前（製品名、カテゴリー名など）
description semantic 説明
commissionRate semantic 手数料率

marketplaceId

message

minimumOrderQuantity

Money

id type title
amount semantic 金額
currency semantic 通貨

name

newPassword

Notification

id type title
notificationId semantic 通知の一意の識別子
userId semantic ユーザーの一意の識別子
message semantic メッセージ
isRead semantic 既読かどうか
createdAt semantic 作成日時

notificationId

operatingHours

Order

id type title
orderId semantic 注文の一意の識別子
userId semantic ユーザーの一意の識別子
OrderItem semantic 注文項目
totalAmount semantic 合計金額
status semantic 状態（注文状態など）
shippingAddress semantic 配送先住所
billingAddress semantic 請求先住所
paymentMethod semantic 支払い方法
ShippingMethod semantic 配送方法
trackingNumber semantic 追跡番号
createdAt semantic 作成日時
updatedAt semantic 更新日時

orderId

OrderItem

id type title
productId semantic 製品の一意の識別子
quantity semantic 数量
price semantic 価格
discountId semantic 割引の一意の識別子

pageNumber

pageSize

parentCategory

PaymentMethod

id type title
paymentMethod semantic 支払い方法
name semantic 名前（製品名、カテゴリー名など）
description semantic 説明

paymentMethod

paymentTerms

performanceMetrics

phoneNumber

plan

postalCode

price

Product

id type title
productId semantic 製品の一意の識別子
name semantic 名前（製品名、カテゴリー名など）
description semantic 説明
price semantic 価格
category semantic カテゴリー
subcategory semantic サブカテゴリー
inventory semantic 在庫数
weight semantic 重量
dimensions semantic 寸法
isCustomizable semantic カスタマイズ可能かどうか
createdAt semantic 作成日時
updatedAt semantic 更新日時

productId

profileImage

Promotion

id type title
name semantic 名前（製品名、カテゴリー名など）
description semantic 説明
discountType semantic 割引の種類
discountAmount semantic 割引額
validFrom semantic 有効開始日
validTo semantic 有効終了日
couponCode semantic クーポンコード
isActive semantic アクティブかどうか

quantity

Rating

id type title
rating semantic 評価
reviewCount semantic レビューカウント

rating

reason

Register

id type title
goToLogin safe ログインページへ移動
doRegister idempotent ユーザー登録

registrationDate

reservedQuantity

Review

id type title
reviewId semantic レビューの一意の識別子
userId semantic ユーザーの一意の識別子
productId semantic 製品の一意の識別子
rating semantic 評価
comment semantic コメント
reviewDate semantic レビュー日
helpfulVotes semantic 役立つ投票数
verifiedPurchase semantic 確認済み購入

reviewCount

reviewDate

reviewId

role

searchKeyword

Seller

id type title
sellerId semantic 販売者の一意の識別子
name semantic 名前（製品名、カテゴリー名など）
email semantic ユーザーのメールアドレス
phoneNumber semantic 電話番号
businessAddress semantic 事業所住所
taxInformation semantic 税務情報
performanceMetrics semantic パフォーマンス指標
createdAt semantic 作成日時

sellerId

shippingAddress

ShippingMethod

id type title
name semantic 名前（製品名、カテゴリー名など）
description semantic 説明
baseCost semantic 基本コスト
estimatedDeliveryDate semantic 予想配達日
freeShippingThreshold semantic 送料無料の閾値
isActive semantic アクティブかどうか

size

startDate

state

status

street

subcategory

Subscription

id type title
subscriptionId semantic サブスクリプションの一意の識別子
userId semantic ユーザーの一意の識別子
plan semantic プラン
startDate semantic 開始日
endDate semantic 終了日
status semantic 状態（注文状態など）
autoRenew semantic 自動更新
price semantic 価格

subscriptionId

Supplier

id type title
supplierId semantic 供給者の一意の識別子
name semantic 名前（製品名、カテゴリー名など）
contactInfo semantic 連絡先情報
rating semantic 評価
paymentTerms semantic 支払い条件
leadTime semantic リードタイム
minimumOrderQuantity semantic 最小注文数量

supplierId

taxInformation

totalAmount

trackingNumber

updatedAt

url

User

id type title
userId semantic ユーザーの一意の識別子
username semantic ユーザーのユーザー名
email semantic ユーザーのメールアドレス
fullName semantic ユーザーのフルネーム
profileImage semantic ユーザーのプロファイル画像URL
role semantic システムにおけるユーザーの役割
createdAt semantic 作成日時
updatedAt semantic 更新日時

UserCart

id type title
goToUserCheckout safe ユーザーチェックアウトへ移動
goToUserHome safe ユーザーホームへ移動
doUpdateCartItem idempotent カート内アイテム更新
doRemoveCartItem idempotent カート内アイテム削除

UserCheckout

id type title
goToUserCart safe ユーザーカートへ移動
goToUserHome safe ユーザーホームへ移動
doPlaceOrder idempotent 注文確定

UserHome

id type title
goToUserProductList safe ユーザー製品リストへ移動
goToUserCart safe ユーザーカートへ移動
goToUserOrderHistory safe ユーザー注文履歴へ移動
goToUserProfile safe ユーザープロフィールへ移動
doLogout idempotent ログアウト

userId

username

UserOrderDetail

id type title
goToUserOrderHistory safe ユーザー注文履歴へ移動
goToUserHome safe ユーザーホームへ移動
goToUserReturnRefund safe 返品/払い戻しページへ移動

UserOrderHistory

id type title
goToUserOrderDetail safe ユーザー注文詳細へ移動
goToUserHome safe ユーザーホームへ移動
goPaginateOrders safe 注文リストのページネーション

UserProductDetail

id type title
goToUserProductList safe ユーザー製品リストへ移動
goToUserCart safe ユーザーカートへ移動
goToUserReview safe ユーザーレビューページへ移動
doAddToCart unsafe カートに追加

UserProductList

id type title
goToUserProductDetail safe ユーザー製品詳細へ移動
goToUserHome safe ユーザーホームへ移動
goSearchProducts safe 製品検索
goPaginateProducts safe 製品リストのページネーション

UserProfile

id type title
goToUserHome safe ユーザーホームへ移動
doUpdateUserProfile idempotent ユーザープロフィール更新

UserReturnRefund

id type title
goToUserOrderDetail safe ユーザー注文詳細へ移動
doRequestReturn idempotent 返品リクエスト
doRequestRefund idempotent 払い戻しリクエスト

UserReview

id type title
goToUserProductDetail safe ユーザー製品詳細へ移動
doAddReview idempotent レビュー追加
doUpdateReview idempotent レビュー更新
doDeleteReview idempotent レビュー削除

validFrom

validTo

verifiedPurchase

website

weight

width

Wishlist

id type title
userId semantic ユーザーの一意の識別子
WishlistItem semantic ウィッシュリスト項目

WishlistItem

id type title
productId semantic 製品の一意の識別子
updatedAt semantic 更新日時

Profile

{
    "$schema": "https://alps-io.github.io/schemas/alps.json",
    "alps": {
        "title": "ALPS大規模マルチベンダーEコマースプラットフォーム",
        "version": "1.0",
        "doc": {
            "value": "このALPS定義は、AmazonのようなマルチベンダーEコマースプラットフォームに必要な主要コンポーネントをカバーしています。ユーザー管理、製品カタログ、注文処理、在庫管理、マーケットプレイス機能、フルフィルメント、アフィリエイトプログラム、サブスクリプションサービスなど、現代の複雑なEコマースシステムの主要機能を網羅しています。（遷移図はユーザーサイドのみ）"
        },
        "descriptor": [
            {"id": "userId", "title": "ユーザーの一意の識別子", "doc": {
                "value": "ユーザーの一意の識別子。UUIDを使用し、予測不可能で安全な値を保証します。システム全体でユーザーを一意に識別するために使用され、セキュリティとデータ整合性の基盤となります。"
            }},
            {"id": "username", "title": "ユーザーのユーザー名"},
            {"id": "email", "title": "ユーザーのメールアドレス", "doc": {
                "value": "ユーザーの主要な連絡手段。アカウント認証と重要な通知に使用されます。一意である必要があり、適切な形式検証が必要です。マーケティングコミュニケーションやトランザクション通知の送信先としても機能し、ユーザーエンゲージメントの重要な要素です。"
            }},
            {"id": "fullName", "title": "ユーザーのフルネーム"},
            {"id": "profileImage", "title": "ユーザーのプロファイル画像URL"},
            {"id": "role", "title": "システムにおけるユーザーの役割", "doc": {
                "value": "システム内でのユーザーの権限レベルを定義します。例：CUSTOMER, SELLER, AFFILIATE, ADMIN。役割ベースのアクセス制御（RBAC）システムと連携し、ユーザーが実行できる操作と表示できる情報を決定します。プラットフォームのセキュリティとユーザー体験のカスタマイズに不可欠です。",
                "link": [
                    {
                        "rel": "describedby",
                        "href": "role.md"
                    }
                ]
            }},
            {"id": "productId", "title": "製品の一意の識別子",
                "doc": {
                    "value": "製品の一意の識別子。SKU（Stock Keeping Unit）と連携し、在庫管理システムとの整合性を保ちます。注文処理、在庫追跡、製品検索など、多くのシステム機能で使用される重要な参照ポイントです。グローバルユニークである必要があり、マルチベンダー環境での製品の一意性を保証します。"
                }
            },
            {"id": "name", "title": "名前（製品名、カテゴリー名など）",
                "doc": {
                    "value": "製品の表示名。SEO最適化と製品検索のために重要。多言語サポートを考慮する必要があります。顧客が製品を識別し、理解するための主要な要素であり、検索結果や製品リストでの表示に使用されます。わかりやすく、魅力的で、かつ正確である必要があります。"
                }},
            {"id": "description", "title": "説明"},
            {"id": "price", "title": "価格", "doc": {
                "value": "製品の現在の価格。動的価格設定アルゴリズム、プロモーション、税金計算と連携します。異なる通貨と価格帯をサポートする必要があります。顧客の購買決定に直接影響を与え、競争力と収益性のバランスを取るための重要な要素です。価格履歴の追跡や、マーケットプレイス全体の価格動向分析にも使用されます。"
            }},
            {"id": "category", "title": "カテゴリー"},
            {"id": "subcategory", "title": "サブカテゴリー"},
            {"id": "inventory", "title": "在庫数"},
            {"id": "weight", "title": "重量"},
            {"id": "dimensions", "title": "寸法"},
            {"id": "isCustomizable", "title": "カスタマイズ可能かどうか"},
            {"id": "createdAt", "title": "作成日時"},
            {"id": "updatedAt", "title": "更新日時"},
            {"id": "orderId", "title": "注文の一意の識別子"},
            {"id": "totalAmount", "title": "合計金額"},
            {"id": "status", "title": "状態（注文状態など）"},
            {"id": "address", "title": "一般住所"},
            {"id": "shippingAddress", "title": "配送先住所"},
            {"id": "billingAddress", "title": "請求先住所"},
            {"id": "paymentMethod", "title": "支払い方法"},
            {"id": "street", "title": "通り名と番号"},
            {"id": "city", "title": "都市名"},
            {"id": "state", "title": "州または県名"},
            {"id": "postalCode", "title": "郵便番号"},
            {"id": "country", "title": "国名"},
            {"id": "phoneNumber", "title": "電話番号"},
            {"id": "amount", "title": "金額"},
            {"id": "currency", "title": "通貨"},
            {"id": "supplierId", "title": "供給者の一意の識別子"},
            {"id": "contactInfo", "title": "連絡先情報"},
            {"id": "rating", "title": "評価"},
            {"id": "paymentTerms", "title": "支払い条件"},
            {"id": "leadTime", "title": "リードタイム"},
            {"id": "minimumOrderQuantity", "title": "最小注文数量"},
            {"id": "discountId", "title": "割引の一意の識別子"},
            {"id": "discountType", "title": "割引の種類"},
            {"id": "discountAmount", "title": "割引額"},
            {"id": "validFrom", "title": "有効開始日"},
            {"id": "validTo", "title": "有効終了日"},
            {"id": "couponCode", "title": "クーポンコード"},
            {"id": "imageId", "title": "画像の一意の識別子"},
            {"id": "url", "title": "URL"},
            {"id": "altText", "title": "代替テキスト"},
            {"id": "width", "title": "幅"},
            {"id": "height", "title": "高さ"},
            {"id": "size", "title": "サイズ"},
            {"id": "format", "title": "フォーマット"},
            {"id": "reviewId", "title": "レビューの一意の識別子"},
            {"id": "comment", "title": "コメント"},
            {"id": "reviewDate", "title": "レビュー日"},
            {"id": "helpfulVotes", "title": "役立つ投票数"},
            {"id": "verifiedPurchase", "title": "確認済み購入"},
            {"id": "notificationId", "title": "通知の一意の識別子"},
            {"id": "message", "title": "メッセージ"},
            {"id": "isRead", "title": "既読かどうか"},
            {"id": "marketplaceId", "title": "マーケットプレイスの一意の識別子"},
            {"id": "commissionRate", "title": "手数料率"},
            {"id": "sellerId", "title": "販売者の一意の識別子"},
            {"id": "businessAddress", "title": "事業所住所"},
            {"id": "taxInformation", "title": "税務情報"},
            {"id": "performanceMetrics", "title": "パフォーマンス指標"},
            {"id": "affiliateId", "title": "アフィリエイトの一意の識別子"},
            {"id": "website", "title": "ウェブサイト"},
            {"id": "earnings", "title": "収益"},
            {"id": "clickCount", "title": "クリック数"},
            {"id": "conversionRate", "title": "コンバージョン率"},
            {"id": "subscriptionId", "title": "サブスクリプションの一意の識別子"},
            {"id": "plan", "title": "プラン"},
            {"id": "startDate", "title": "開始日"},
            {"id": "endDate", "title": "終了日"},
            {"id": "autoRenew", "title": "自動更新"},
            {"id": "quantity", "title": "数量", "doc": {
                "value": "カートに追加する製品の数量。この値は、在庫の可用性チェックや価格計算に使用されます。また、バルク購入や数量割引の適用条件としても機能します。"
            }},
            {"id": "isDefault", "title": "デフォルトかどうか"},
            {"id": "isActive", "title": "アクティブかどうか"},
            {"id": "expiryDate", "title": "有効期限"},
            {"id": "trackingNumber", "title": "追跡番号"},
            {"id": "estimatedDeliveryDate", "title": "予想配達日"},
            {"id": "isInStock", "title": "在庫があるかどうか"},
            {"id": "lowStockThreshold", "title": "在庫低下警告のしきい値"},
            {"id": "reservedQuantity", "title": "予約済みの数量"},
            {"id": "availableQuantity", "title": "利用可能な数量"},
            {"id": "baseCost", "title": "基本コスト"},
            {"id": "freeShippingThreshold", "title": "送料無料の閾値"},
            {"id": "parentCategory", "title": "親カテゴリー"},
            {"id": "capacity", "title": "容量"},
            {"id": "operatingHours", "title": "営業時間"},
            {"id": "reviewCount", "title": "レビューカウント"},
            {"id": "currentPassword", "title": "現在のパスワード"},
            {"id": "newPassword","title": "新しいパスワード"},
            {"id": "confirmNewPassword", "title": "新しいパスワードの確認"},
            {"id": "registrationDate", "title": "登録日時"},
            {"id": "reason", "title": "理由"},
            {"id": "searchKeyword", "title": "検索キーワード"},
            {"id": "pageNumber", "title": "ページ番号"},
            {"id": "pageSize", "title": "ページ番号"},
            {
                "id": "User",
                "title": "ユーザー情報",
                "doc": {
                    "value": "プラットフォーム上の個々のアカウントを表します。顧客、販売者、アフィリエイト、管理者など、様々な役割を持つユーザーを含みます。ユーザーの行動追跡、認証、パーソナライゼーション、権限管理の基盤となる重要なエンティティです。"
                },
                "descriptor": [
                    {"href": "#userId"},
                    {"href": "#username"},
                    {"href": "#email"},
                    {"href": "#fullName"},
                    {"href": "#profileImage"},
                    {"href": "#role"},
                    {"href": "#createdAt"},
                    {"href": "#updatedAt"}
                ]
            },
            {
                "id": "Product",
                "title": "製品情報",
                "doc": {
                    "value": "プラットフォーム上で販売される個々の商品やサービスを表します。物理的な商品、デジタル製品、サービスなど、多様な製品タイプをサポートします。製品情報の正確性と完全性は、顧客の購買決定とプラットフォームの信頼性に直接影響します。検索エンジン、推奨システム、在庫管理システムなど、多くのコンポーネントと相互作用する中心的なエンティティです。"
                },
                "descriptor": [
                    {"href": "#productId"},
                    {"href": "#name"},
                    {"href": "#description"},
                    {"href": "#price"},
                    {"href": "#category"},
                    {"href": "#subcategory"},
                    {"href": "#inventory"},
                    {"href": "#weight"},
                    {"href": "#dimensions"},
                    {"href": "#isCustomizable"},
                    {"href": "#createdAt"},
                    {"href": "#updatedAt"}
                ]
            },
            {
                "id": "Order",
                "title": "注文情報",
                "descriptor": [
                    {"href": "#orderId"},
                    {"href": "#userId"},
                    {"href": "#totalAmount"},
                    {"href": "#status"},
                    {"href": "#shippingAddress"},
                    {"href": "#billingAddress"},
                    {"href": "#paymentMethod"},
                    {"href": "#createdAt"},
                    {"href": "#updatedAt"}
                ]
            },
            {
                "id": "Address",
                "title": "住所情報",
                "descriptor": [
                    {"href": "#street"},
                    {"href": "#city"},
                    {"href": "#state"},
                    {"href": "#postalCode"},
                    {"href": "#country"},
                    {"href": "#phoneNumber"}
                ]
            },
            {
                "id": "PaymentMethod",
                "title": "支払い方法",
                "descriptor": [
                    {"href": "#paymentMethod"},
                    {"href": "#name"},
                    {"href": "#description"}
                ]
            },
            {
                "id": "Supplier",
                "title": "供給者情報",
                "descriptor": [
                    {"href": "#supplierId"},
                    {"href": "#name"},
                    {"href": "#contactInfo"},
                    {"href": "#rating"},
                    {"href": "#paymentTerms"},
                    {"href": "#leadTime"},
                    {"href": "#minimumOrderQuantity"}
                ]
            },
            {
                "id": "Discount",
                "title": "割引情報",
                "descriptor": [
                    {"href": "#discountId"},
                    {"href": "#name"},
                    {"href": "#description"},
                    {"href": "#discountType"},
                    {"href": "#discountAmount"},
                    {"href": "#validFrom"},
                    {"href": "#validTo"},
                    {"href": "#couponCode"}
                ]
            },
            {
                "id": "Image",
                "title": "画像情報",
                "descriptor": [
                    {"href": "#imageId"},
                    {"href": "#url"},
                    {"href": "#altText"},
                    {"href": "#width"},
                    {"href": "#height"},
                    {"href": "#size"},
                    {"href": "#format"}
                ]
            },
            {
                "id": "Review",
                "title": "レビュー情報",
                "descriptor": [
                    {"href": "#reviewId"},
                    {"href": "#userId"},
                    {"href": "#productId"},
                    {"href": "#rating"},
                    {"href": "#comment"},
                    {"href": "#reviewDate"},
                    {"href": "#helpfulVotes"},
                    {"href": "#verifiedPurchase"}
                ]
            },
            {
                "id": "Notification",
                "title": "通知情報",
                "descriptor": [
                    {"href": "#notificationId"},
                    {"href": "#userId"},
                    {"href": "#message"},
                    {"href": "#isRead"},
                    {"href": "#createdAt"}
                ]
            },
            {
                "id": "Marketplace",
                "title": "マーケットプレイス情報",
                "descriptor": [
                    {"href": "#marketplaceId"},
                    {"href": "#name"},
                    {"href": "#description"},
                    {"href": "#commissionRate"}
                ]
            },
            {
                "id": "Seller",
                "title": "販売者情報",
                "descriptor": [
                    {"href": "#sellerId"},
                    {"href": "#name"},
                    {"href": "#email"},
                    {"href": "#phoneNumber"},
                    {"href": "#businessAddress"},
                    {"href": "#taxInformation"},
                    {"href": "#performanceMetrics"},
                    {"href": "#createdAt"}
                ]
            },
            {
                "id": "Affiliate",
                "title": "アフィリエイト情報",
                "descriptor": [
                    {"href": "#affiliateId"},
                    {"href": "#name"},
                    {"href": "#email"},
                    {"href": "#website"},
                    {"href": "#earnings"},
                    {"href": "#clickCount"},
                    {"href": "#conversionRate"}
                ]
            },
            {
                "id": "Subscription",
                "title": "サブスクリプション情報",
                "descriptor": [
                    {"href": "#subscriptionId"},
                    {"href": "#userId"},
                    {"href": "#plan"},
                    {"href": "#startDate"},
                    {"href": "#endDate"},
                    {"href": "#status"},
                    {"href": "#autoRenew"},
                    {"href": "#price"}
                ]
            },
            {
                "id": "CartItem",
                "title": "カート項目",
                "descriptor": [
                    {"href": "#productId"},
                    {"href": "#quantity"},
                    {"href": "#price"}
                ]
            },
            {
                "id": "Cart",
                "title": "ショッピングカート",
                "descriptor": [
                    {"href": "#userId"},
                    {"href": "#CartItem"},
                    {"href": "#totalAmount"},
                    {"href": "#updatedAt"}
                ]
            },
            {
                "id": "WishlistItem",
                "title": "ウィッシュリスト項目",
                "descriptor": [
                    {"href": "#productId"},
                    {"href": "#updatedAt"}
                ]
            },
            {
                "id": "Wishlist",
                "title": "ウィッシュリスト",
                "descriptor": [
                    {"href": "#userId"},
                    {"href": "#WishlistItem"}
                ]
            },
            {
                "id": "Promotion",
                "title": "プロモーション",
                "descriptor": [
                    {"href": "#name"},
                    {"href": "#description"},
                    {"href": "#discountType"},
                    {"href": "#discountAmount"},
                    {"href": "#validFrom"},
                    {"href": "#validTo"},
                    {"href": "#couponCode"},
                    {"href": "#isActive"}
                ]
            },
            {
                "id": "Inventory",
                "title": "在庫",
                "descriptor": [
                    {"href": "#productId"},
                    {"href": "#quantity"},
                    {"href": "#isInStock"},
                    {"href": "#lowStockThreshold"},
                    {"href": "#reservedQuantity"},
                    {"href": "#availableQuantity"},
                    {"href": "#updatedAt"}
                ]
            },
            {
                "id": "ShippingMethod",
                "title": "配送方法",
                "descriptor": [
                    {"href": "#name"},
                    {"href": "#description"},
                    {"href": "#baseCost"},
                    {"href": "#estimatedDeliveryDate"},
                    {"href": "#freeShippingThreshold"},
                    {"href": "#isActive"}
                ]
            },
            {
                "id": "Category",
                "title": "カテゴリー",
                "descriptor": [
                    {"href": "#name"},
                    {"href": "#description"},
                    {"href": "#parentCategory"},
                    {"href": "#isActive"}
                ]
            },
            {
                "id": "FulfillmentCenter",
                "title": "フルフィルメントセンター",
                "descriptor": [
                    {"href": "#name"},
                    {"href": "#address"},
                    {"href": "#capacity"},
                    {"href": "#operatingHours"}
                ]
            },
            {
                "id": "Money",
                "title": "金額",
                "descriptor": [
                    {"href": "#amount"},
                    {"href": "#currency"}
                ]
            },
            {
                "id": "Rating",
                "title": "評価",
                "descriptor": [
                    {"href": "#rating"},
                    {"href": "#reviewCount"}
                ]
            },
            {
                "id": "OrderItem",
                "title": "注文項目",
                "descriptor": [
                    {"href": "#productId"},
                    {"href": "#quantity"},
                    {"href": "#price"},
                    {"href": "#discountId"}
                ]
            },
            {
                "id": "Order",
                "title": "注文",
                "descriptor": [
                    {"href": "#orderId"},
                    {"href": "#userId"},
                    {"href": "#OrderItem"},
                    {"href": "#totalAmount"},
                    {"href": "#status"},
                    {"href": "#shippingAddress"},
                    {"href": "#billingAddress"},
                    {"href": "#paymentMethod"},
                    {"href": "#ShippingMethod"},
                    {"href": "#trackingNumber"},
                    {"href": "#createdAt"},
                    {"href": "#updatedAt"}
                ]
            },
            {
                "id": "Login",
                "type": "semantic",
                "title": "ログイン",
                "tag": "auth",
                "descriptor": [
                    {"href": "#doLogin"},
                    {"href": "#goToRegister"}
                ]
            },
            {
                "id": "Register",
                "type": "semantic",
                "title": "ユーザー登録",
                "tag": "auth account",
                "descriptor": [
                    {"href": "#doRegister"},
                    {"href": "#goToLogin"}
                ]
            },
            {
                "id": "UserHome",
                "type": "semantic",
                "title": "ユーザーホーム",
                "tag": "account catalog",
                "descriptor": [
                    {"href": "#goToUserProductList"},
                    {"href": "#goToUserCart"},
                    {"href": "#goToUserOrderHistory"},
                    {"href": "#goToUserProfile"},
                    {"href": "#doLogout"}
                ]
            },
            {
                "id": "UserProfile",
                "type": "semantic",
                "title": "ユーザープロフィール",
                "tag": "account",
                "descriptor": [
                    {"href": "#doUpdateUserProfile"},
                    {"href": "#goToUserHome"}
                ]
            },
            {
                "id": "UserProductList",
                "type": "semantic",
                "title": "ユーザー製品リスト",
                "tag": "catalog shop",
                "descriptor": [
                    {"href": "#goToUserProductDetail"},
                    {"href": "#goToUserHome"},
                    {"href": "#goSearchProducts"},
                    {"href": "#goPaginateProducts"}
                ]
            },
            {
                "id": "UserProductDetail",
                "type": "semantic",
                "title": "ユーザー製品詳細",
                "tag": "catalog shop",
                "descriptor": [
                    {"href": "#doAddToCart"},
                    {"href": "#goToUserProductList"},
                    {"href": "#goToUserCart"},
                    {"href": "#goToUserReview"}
                ]
            },
            {
                "id": "UserCart",
                "type": "semantic",
                "title": "ユーザーカート",
                "tag": "cart shop",
                "descriptor": [
                    {"href": "#doUpdateCartItem"},
                    {"href": "#doRemoveCartItem"},
                    {"href": "#goToUserCheckout"},
                    {"href": "#goToUserHome"}
                ]
            },
            {
                "id": "UserCheckout",
                "type": "semantic",
                "title": "ユーザーチェックアウト",
                "tag": "checkout shop",
                "descriptor": [
                    {"href": "#doPlaceOrder"},
                    {"href": "#goToUserCart"},
                    {"href": "#goToUserHome"}
                ]
            },
            {
                "id": "UserOrderHistory",
                "type": "semantic",
                "title": "ユーザー注文履歴",
                "tag": "order",
                "descriptor": [
                    {"href": "#goToUserOrderDetail"},
                    {"href": "#goToUserHome"},
                    {"href": "#goPaginateOrders"}
                ]
            },
            {
                "id": "UserOrderDetail",
                "type": "semantic",
                "title": "ユーザー注文詳細",
                "tag": "order",
                "descriptor": [
                    {"href": "#goToUserOrderHistory"},
                    {"href": "#goToUserHome"},
                    {"href": "#goToUserReturnRefund"}
                ]
            },
            {
                "id": "UserProfile",
                "type": "semantic",
                "title": "ユーザープロフィール",
                "descriptor": [
                    {"href": "#doUpdateUserProfile"},
                    {"href": "#goToUserHome"}
                ]
            },
            {
                "id": "UserReview",
                "type": "semantic",
                "title": "ユーザーレビュー",
                "tag": "review shop",
                "descriptor": [
                    {"href": "#doAddReview"},
                    {"href": "#doUpdateReview"},
                    {"href": "#doDeleteReview"},
                    {"href": "#goToUserProductDetail"}
                ]
            },
            {
                "id": "UserReturnRefund",
                "type": "semantic",
                "title": "返品/払い戻し",
                "tag": "support order",
                "descriptor": [
                    {"href": "#doRequestReturn"},
                    {"href": "#doRequestRefund"},
                    {"href": "#goToUserOrderDetail"}
                ]
            },
            {
                "id": "goToRegister",
                "type": "safe",
                "title": "登録ページへ移動",
                "doc": {
                    "value": "ユーザーを新規アカウント作成ページにナビゲートします。このトランジションは、新規ユーザー獲得プロセスの開始点であり、コンバージョンファネルの重要なステップです。ユーザーエクスペリエンスを最適化し、登録の完了率を高めるために、このページへの遷移はスムーズで直感的である必要があります。また、ユーザーの現在のコンテキスト（例：閲覧していた製品ページ）を保持し、登録後にシームレスに元のコンテキストに戻れるようにすることが重要です。"
                },
                "rt": "#Register"
            },
            {
                "id": "goToLogin",
                "type": "safe",
                "title": "ログインページへ移動",
                "rt": "#Login"
            },
            {
                "id": "goToUserHome",
                "type": "safe",
                "title": "ユーザーホームへ移動",
                "rt": "#UserHome"
            },
            {
                "id": "goToUserProductList",
                "type": "safe",
                "title": "ユーザー製品リストへ移動",
                "rt": "#UserProductList"
            },
            {
                "id": "goToUserProductDetail",
                "type": "safe",
                "title": "ユーザー製品詳細へ移動",
                "rt": "#UserProductDetail"
            },
            {
                "id": "goToUserCart",
                "type": "safe",
                "title": "ユーザーカートへ移動",
                "rt": "#UserCart"
            },
            {
                "id": "goToUserCheckout",
                "type": "safe",
                "title": "ユーザーチェックアウトへ移動",
                "rt": "#UserCheckout"
            },
            {
                "id": "goToUserOrderHistory",
                "type": "safe",
                "title": "ユーザー注文履歴へ移動",
                "rt": "#UserOrderHistory"
            },
            {
                "id": "goToUserOrderDetail",
                "type": "safe",
                "title": "ユーザー注文詳細へ移動",
                "rt": "#UserOrderDetail"
            },
            {
                "id": "goToUserProfile",
                "type": "safe",
                "title": "ユーザープロフィールへ移動",
                "rt": "#UserProfile"
            },
            {
                "id": "goToUserReview",
                "type": "safe",
                "title": "ユーザーレビューページへ移動",
                "rt": "#UserReview"
            },
            {
                "id": "goToUserReturnRefund",
                "type": "safe",
                "title": "返品/払い戻しページへ移動",
                "rt": "#UserReturnRefund"
            },
            {
                "id": "doLogin",
                "type": "idempotent",
                "title": "ログイン",
                "rt": "#UserHome",
                "descriptor": [
                    {"href": "#email"},
                    {"href": "#currentPassword"}
                ]
            },
            {
                "id": "doLogout",
                "type": "idempotent",
                "title": "ログアウト",
                "rt": "#Login"
            },
            {
                "id": "doRegister",
                "type": "idempotent",
                "title": "ユーザー登録",
                "rt": "#UserHome",
                "descriptor": [
                    {"href": "#name"},
                    {"href": "#email"},
                    {"href": "#currentPassword"},
                    {"href": "#confirmNewPassword"}
                ]
            },
            {
                "id": "doAddToCart",
                "type": "unsafe",
                "title": "カートに追加",
                "doc": {
                    "value": "指定された製品を指定された数量だけユーザーのショッピングカートに追加します。この操作は、Eコマースプラットフォームの中核的な機能の一つであり、ユーザーの購買意図を捕捉する重要なポイントです。実行時には、リアルタイムの在庫確認、価格の再計算、関連商品の推奨などの処理が行われます。また、ユーザーの過去の行動に基づいて、クロスセリングやアップセリングの機会を識別します。カートの状態変化は、在庫管理システムに即時に反映され、他の顧客の購買体験に影響を与えないようにします。パフォーマンスとユーザーエクスペリエンスの観点から、この操作は高速で信頼性が高く、ユーザーに明確なフィードバックを提供する必要があります。"
                },
                "rt": "#UserCart",
                "descriptor": [
                    {"href": "#productId"},
                    {"href": "#quantity"}
                ]
            },
            {
                "id": "doUpdateCartItem",
                "type": "idempotent",
                "title": "カート内アイテム更新",
                "rt": "#UserCart",
                "descriptor": [
                    {"href": "#productId"},
                    {"href": "#quantity"}
                ]
            },
            {
                "id": "doRemoveCartItem",
                "type": "idempotent",
                "title": "カート内アイテム削除",
                "rt": "#UserCart",
                "descriptor": [
                    {"href": "#productId"}
                ]
            },
            {
                "id": "doPlaceOrder",
                "type": "idempotent",
                "title": "注文確定",
                "rt": "#UserOrderDetail",
                "descriptor": [
                    {"href": "#shippingAddress"},
                    {"href": "#paymentMethod"}
                ]
            },
            {
                "id": "doUpdateUserProfile",
                "type": "idempotent",
                "title": "ユーザープロフィール更新",
                "rt": "#UserProfile",
                "descriptor": [
                    {"href": "#name"},
                    {"href": "#email"},
                    {"href": "#phoneNumber"},
                    {"href": "#address"}
                ]
            },
            {
                "id": "doAddReview",
                "type": "idempotent",
                "title": "レビュー追加",
                "rt": "#UserProductDetail",
                "descriptor": [
                    {"href": "#productId"},
                    {"href": "#rating"},
                    {"href": "#comment"}
                ]
            },
            {
                "id": "doUpdateReview",
                "type": "idempotent",
                "title": "レビュー更新",
                "rt": "#UserProductDetail",
                "descriptor": [
                    {"href": "#reviewId"},
                    {"href": "#rating"},
                    {"href": "#comment"}
                ]
            },
            {
                "id": "doDeleteReview",
                "type": "idempotent",
                "title": "レビュー削除",
                "rt": "#UserProductDetail",
                "descriptor": [
                    {"href": "#reviewId"}
                ]
            },
            {
                "id": "doRequestReturn",
                "type": "idempotent",
                "title": "返品リクエスト",
                "rt": "#UserOrderDetail",
                "descriptor": [
                    {"href": "#orderId"},
                    {"href": "#reason"}
                ]
            },
            {
                "id": "doRequestRefund",
                "type": "idempotent",
                "title": "払い戻しリクエスト",
                "rt": "#UserOrderDetail",
                "descriptor": [
                    {"href": "#orderId"},
                    {"href": "#reason"}
                ]
            },
            {
                "id": "goSearchProducts",
                "type": "safe",
                "title": "製品検索",
                "rt": "#UserProductList",
                "descriptor": [
                    {"href": "#searchKeyword"},
                    {"href": "#category"},
                    {"href": "#subcategory"}
                ]
            },
            {
                "id": "goPaginateProducts",
                "type": "safe",
                "title": "製品リストのページネーション",
                "rt": "#UserProductList",
                "descriptor": [
                    {"href": "#pageNumber"},
                    {"href": "#pageSize"}
                ]
            },
            {
                "id": "goPaginateOrders",
                "type": "safe",
                "title": "注文リストのページネーション",
                "rt": "#UserOrderHistory",
                "descriptor": [
                    {"href": "#pageNumber"},
                    {"href": "#pageSize"}
                ]
            }
        ]
    }
}