マルチカレンシーカタログ

（事業・管理）

1）タスクとスコープ

• 正しい価格のmart （UX、信頼）、
• 計算の再現性（監査、返品）、
• 経済予測可能性（証拠金/税金）、
• コンプライアンス（課税、制裁、通貨制限）。

2）データモデル（参考）

• Product/SKU： '{sku_id、 title、 attributes、 region_policies[]}'
• 価格リスト：'{pricelist_id、 base_currency、 effective_from、 effective_to、バージョン}'
• PriceItem： '{sku_id、 base_price、 base_currency、 tax_class、 pricing_model、 promo_refs[]}'
• FXRate： '{pair： EUR→USD、 rate、 source、 method、 precision、 effective_from、 version}'

• 'minor_units' （ISO 4217；例：JPY=0、 USD/EUR=2、 KWD=3；暗号の場合-最大8）
• 'rounding_mode'： 'HALF_UP'（小売）、'BANKERS'（金融）、'FLOOR'/'CEIL'（税金/規制当局）

3） FXのソースとポリシー

ソース：コースプロバイダー（商業/中央銀行）、独自のTWAP/中央値。
更新方針：頻度（揮発性のための1-15分、安定したのための1時間/日）、出版物の遅れ。
マークアップ：'rate （1+fx_markup_bps）'クライアント側へ；チャネル/リージョンごとの透過的なルール。
保証された見積もりウィンドウ（レートロック）：'fx_version'の順序で5〜30分。
アンチジャンプ：ダニごとのキャップ変更、サーキットブレーカー、最新の有効な引用符のフォールバック。
バージョン管理：各コースの出版物には'version'、 'effective_from'があります。返品/紛争の履歴を保持します。

4）価格戦略

Base+FX：基本価格を「コア」（EURなど）に保存し、ショーケースに変換します。
通貨単位のシート：キー通貨の事前に計算された価格（最高のUX、予測可能性）。
混合：トップ10通貨-事前計算、「ロングテール」-オンザフライ。
チャーム価格：'X。99/95/90 'by region、丸めエラーの蓄積を監視します。
手数料：支払い手数料、クロスボーダー手数料、ネットワーク手数料（暗号）-ディレクトリまたは「チェックアウト価格」段階で。

5）税金と「包含」

VAT/GSTが含まれ/除外：EU-VATを含むよりも頻繁に；B2BはVATフリーです。
税金の層：連邦/州/ローカル；オンラインゲーム-特定の料金。
しきい値率：税金は売上高/カテゴリ/地域（しきい値）によって異なります。
税額の切り捨て：アイテムごとにバスケットごとに対；丸めモードと計算順序は決定論的でなければなりません。
（美咲）うん。reporting： check/receiptに'tax_rule_version'を保持します。

6）丸め、正確さ

ショーの最後のステップでラウンド；計算で「高精度」を維持します（最大8〜9文字）。
暗号の場合は、（バイナリ浮動小数点以外の）10進数ライブラリを使用します。
バスケットの反ドリフト：量のための「円形になる銀行家」、しかし表示のためのUX円形；'rounding_scope'を修正しました。
合計ルール：行ごとの丸めの合計は合計と同じでなければなりません-ペニー分布を使用します。

7）カタログ、プロモーション、バンドル

プロモーション：'if region=A and currency in ［EUR、 USD］ then discount=10％ cap=50'。
申込順：（1）基本価格→（2）割引→（3）税金→（4）手数料→（5）四捨五入。
バンドル分布：割引の前に位置タブに比例します。返品のためのラッパー。
しきい値プロモーション：送料無料/ボーナス時に合計≥ Xカート通貨；基本通貨を同等に保ちますが、FXバージョンを修正します。

8）支払および承諾との統合

通貨の可用性：すべての通貨がすべてのプレーヤー/地域/決済プロバイダーに利用できるわけではありません。
保証されたFX：固定'fx_version'による承認プレフィックス；有効期限中-新しい価格の要求確認。
CUS/制裁：通貨/銀行/トークンのブロックリスト、変換の制限。
戻り値/チャージバック：注文の履歴'fx_version'に従って再計算；返品手数料-トランザクションの日付のディレクトリ。

9） APIアーキテクチャと契約

• 'GET/カタログ/価格？sku=……¤cy=……®ion=……&pricelist=……'
• "{unit_price、 currency、 fx_version、 pricelist_version、 tax_breakdown[]、 fees［］、display_price、 rounding_mode}'

• 'POST/pricing/quote {items［］、region、 currency、 buyer_type}'
• 「{items_priced［］、subtotal、 discounts、 tax［］、fees［］、total、 fx_version、 lock_ttl、 signature}」

• 'POST/pricing/commit {quote_id、 signature}'→ハッシュと署名付きの領収書。

• 'PriceListUpdated'、 'FXRatePublished'、 'TaxRuleChanged'、 'PromoChanged'-'バージョン/effective_from'。

10）キャッシュとパフォーマンス

エッジキャッシュ：キー'pricelist： region： currency： sku： version'；安定した通貨のTTLはより高いです。
ウォームアップ：キャンペーンの立ち上げによってトップカテゴリをウォームアップします。
SWR （stale-while-revalidate）：ストアフロント用；チェックアウト-新鮮なだけ。
部分無効：'sku'、 'category'、 'pricelist_version'タグによる無効。
SLO：表示のためのp95 ≤ 120ms、 p95 ≤引用のための250ms、 ≥ 99。95％の可用性。

11）観察可能性および監査

トレース： 'trace_id'、 'pricelist_version'、 'fx_version'、 'tax_rule_version'

不変性：価格リスト/コースの出版物のWORMジャーナル；Merkle-slices、リリース署名（DSSE）。
領収書：完全なレイアウトおよびペイロードのハッシュが付いている点検/領収書；7-10年間（調整装置によって）貯えて下さい。
ダッシュボード：vitrina↔checkoutの不一致、上下の丸め周波数、FXエラー、コースロックタイム（ロックTTL）、 ROIプロモーション。

12）ディスプレイのローカライズ

通貨フォーマット：文字/コード（₴、€、$、AED）、文字位置、区切り文字、スペース。

ローカルルール： "₴ 1,234,56"対"$1,234。56”.

心理学：マジックプライスタグ（'。99'）は、フィンテック/ゲームでは必ずしも適切ではありません。地域ごとのテスト。
法的署名：「価格は付加価値税を含みます」、「ネットワーク手数料は別途請求されます」。

13）特別な場合

小数部分のない通貨：JPY/ISK-minor_units=0。
3文字のマイナーユニット：KWD/BHD=3。
暗号：BTC/ETH/USDT-8文字まで、ネットワーク料金は別途；stablecoins ≠クロスボーダーの「1：1見出し」です。
二重価格：「カタログ通貨」≠「書き込み通貨」（商人銀行レート）。スプレッドを文書化します。
スポーツ/ゲーム：カタログ通貨の最大賞金制限-'fx_version'ラウンドで同等のものを維持します。

14） SLO/SLIと成功指標

Correctness： total_checkout=total_quote（分配ルールの± 1マイナーユニット）が99を≥注文の割合。99%.

FX安定性：レートロックウィンドウの操作のシェア≥ 99％です。
経済：証拠金/単位対計画；FX/丸め （bps）による偏差。
UX：スピードクォートP95、価格変換のダンプのシェア、NPSストアフロント。
監査：保存された'_version'と署名によるチェックの100％。

15）インシデントプレイブック

1.凍結キャッシュ無効、2）強制リフレッシュ価格表、3）比較'pricelist_version'/'fx_version'、 4）ポリシー補償。

1.マークアップ/ディスカウントキャップの増加、2） ロックTTLの削減、3）フォールバックソースへの切り替えを可能にします。

1.チェック'tax_rule_version'、 2） rounding_scopeの検証、3）バスケットのhotfixルールとreprice。

1.セキュリティルール（min_price)、 2）スタッキングを無効にする、3）再計算と監査。

16）安全性とコンプライアンス

Policy-as-code： PR+リリース署名による価格リスト/FX/税の変更の制御。
役割/アクセス：価格の出版物/FXの4目の原則。
ログ/領収書：署名された発行イベントとチェックアウト。
地域の制限：個々の通貨/トークンの禁止。地理政治家だ。

17）実験と最適化

A/B：チャーム価格、事前に計算された価格とオンザフライの表示形式。
動的マークアップ：ペアのボラティリティ/時間に依存します。
コホート分析：通貨による返品/チャージバック、感度の丸め。
現金戦略：SWR/TTLが変換と精度に与える影響。

18）実装チェックリスト

• シートの基本通貨とポリシーを定義します。
• バージョン管理、マークアップ、およびTTLロックを使用してFXコレクション/パブリッシングを構成します。
• TaxRuleと計算/丸め順序（アイテムごとまたはバスケットごと）を形式化します。
• ディレクトリAPI/quote/commit+署名付き領収書を実装します。
• エッジキャッシュと粒状障害を有効にします。店頭のSWR。
• ダッシュボード（vitrina↔checkout、 FXエラー、税金、bpsマージン）を作成します。
• 価格/レート出版物、WORMジャーナルの役割/署名を入力します。
• プレイブックを準備する：価格ミス、FXスパイク、税金の相違。
• 「GameDayカタログ」を実行する：FXソースを無効にします。、プロモーションバースト、税金の変更。
• 地域ごとに定期的にminor_units/otobrazheniyeを見直します。

19） FAQ

各通貨で価格を保管する必要がありますか？
必ずしもそうではありません。トップ通貨の事前計算とテールのコンバージョンを組み合わせる-これがUXとコストのバランスです。

なぜ丸めた後に合計が「負けない」のでしょうか？
アイテムごとの違いとバスケットごとの違いによる。1つのアプローチを修正し「、ペニー分布」を使用します。

月に払い戻しを行う方法？
歴史的な'pricelist_version'によると、'fx_version'と'tax_rule_version'は領収書に格納されています。

暗号はどうですか？
小数の正確さ、ネットワーク料金を別に使用して下さい、フィアットに1：1を約束しないで下さい；コースとアクションウィンドウを修正します。

概要：マルチカレンシーカタログは、精密数学、厳格なポリシー、およびスマートキャッシングの組み合わせです。すべてのバージョン（価格/料金/税金）、見積ウィンドウを修正し、計算と丸めの順序を決定し、アーティファクトに署名し、ダッシュボードを表示します。だから、すべての通貨と地域で正直なショーケース、再現可能な決済とマネージドエコノミーを取得します。