Katalogi wielomianowe

(Sekcja: Operacje i zarządzanie)

1) Zadanie i zakres

• prawidłowa cena mart (UX, zaufanie),
• powtarzalność obliczeń (audyty, zwroty),
• przewidywalność ekonomiczna (marża/podatki),
• zgodność (podatki, sankcje, ograniczenia walutowe).

2) Model danych (odniesienie)

• Produkt/SKU: '{sku _ id, tytuł, atrybuty, region_policies[]}'
• „{cennik _ id, base_currency, effective_from, effective_to, wersja}”
• "{sku _ id, base_price, base_currency, tax_class, pricing_model, promo_refs[]}'
• FXRate: '{para: EUR → USD, stawka, źródło, metoda, precyzja, effective_from, wersja}'

• „minor _ units” (ISO 4217; np. JPY = 0, USD/EUR = 2, KWD = 3; dla krypto - do 8)
• „tryb zaokrąglania _”: „HALF _ UP” (handel detaliczny), „BANKIERZY” (finanse), „FLOOR ”/„ CEIL” (podatki/organy regulacyjne)

3) Źródła i polityka FX

Źródła: dostawcy kursów (banki komercyjne/centralne), własne TWAP/mediana.
Polityka aktualizacji: częstotliwość (1-15 min dla lotnych, 1 godzina/dzień dla stabilnych), opóźnienie publikacji.
Markupy: 'rate (1 + fx_markup_bps)' po stronie klienta; przejrzyste zasady dotyczące poszczególnych kanałów/regionów.
Gwarantowane okno notowania (blokada szybkości): 5-30 minut z 'fx _ version' w kolejności.
Anty-skok: zmiany nakrętki na kleszcz, wyłączniki, awaryjne na najnowszym ważnym cytacie.
Wersioning: każda publikacja kursu ma 'version', 'effective _ from'; Zachowaj historię zwrotów/sporów.

4) Strategie cenowe

Baza + FX: przechowywać cenę bazową w „rdzeniu” (na przykład EUR), konwertować na prezentacji.
Arkusze walutowe: wstępnie obliczone ceny dla kluczowych walut (najlepsze UX, przewidywalność).
Mieszane: 10 najlepszych walut - wstępne obliczenia, „długi ogon” - on-the-fly.
Ceny uroku: "X. 99/95/90 "według regionów, monitorować gromadzenie się błędów zaokrąglania.
Opłaty: opłata płatnicza, opłata transgraniczna, opłata sieciowa (crypto) - w katalogu lub na etapie „Cena realizacji transakcji”.

5) Podatki i „włączenie”

VAT/GST włączone/wyłączone: UE - częściej niż VAT-inclusive; B2B może być zwolniony z podatku VAT.
Warstwy podatków: federalny/państwowy/lokalny; dla gier online - specyficzne opłaty.
Stawki progowe: podatek różni się w zależności od obrotu/kategorii/regionu (próg).
Zaokrąglanie podatkowe: od pozycji do koszyka; tryby zaokrąglania i kolejność obliczeń muszą być deterministyczne.
Yur. reporting: keep the 'tax _ rule _ version' w check/receipt.

6) Zaokrąglenie i dokładność

Runda na ostatnim etapie pokazu; zachować „wysoką dokładność” w obliczeniach (do 8-9 znaków).
W przypadku krypto należy użyć bibliotek dziesiętnych (bez podwójnego punktu zmiennoprzecinkowego).
Koszyk przeciw dryfowi: „bankierzy zaokrąglający” dla kwot, ale UX-zaokrąglanie do wyświetlania; fix 'rounding _ scope'.
Zasada sumy: suma zaokrąglania liniowego musi być taka sama jak łączna - rozkład penny użycia.

7) Katalogi, promocje i pakiety

Promo-мравила: „jeżeli region = A i waluta w [EUR, USD], to rabat = 10% cap = 50”.
Kolejność wniosku: (1) cena bazowa → (2) zniżki → (3) podatki → (4) opłaty → (5) zaokrąglanie.
Dystrybucja pakietów: proporcjonalna do zakładki pozycji przed zniżką; opakowanie na zwroty.
Promocja progowa: darmowa wysyłka/bonus, gdy razem ≥ X w walucie koszyka; Zachowaj równowartość waluty bazowej, ale napraw wersję FX.

8) Integracja z płatnościami i zgodność

Dostępność waluty: Nie każda waluta jest dostępna dla każdego gracza/regionu/dostawcy płatności.
Gwarantowane FX: prefiks autoryzacji przez stałe 'fx _ version'; w czasie ważności - żądanie potwierdzenia nowej ceny.
CUS/sankcje: listy blokowe walut/banków/żetonów, ograniczenia w konwersji.
Zwroty/obciążenie zwrotne: ponowne obliczenie zgodnie z historyczną „fx _ version” zamówienia; opłata zwrotna - według katalogu w dniu transakcji.

9) Architektura i kontrakt API

• "GET/katalog/ceny? sku =... & currency =... & region =... & pricelist =... "
• Отвей: "{jednostka _ cena, waluta, fx_version, pricelist_version, tax_breakdown[], opłaty [], display_price, rounding_mode}'

• „POST/pricing/quote {pozycje [], region, waluta, buyer_type}”
• Отвей: „{items _ priced [], razem, zniżki, podatki [], opłaty [], razem, fx_version, lock_ttl, podpis}”

• „POST/pricing/commit {quote_id, podpis}” → potwierdzenie z hashem i podpisami.

• Uaktualniane "," FXRatePublished "," TaxΕChanged "," PromoChanged "- " version/effective _ from ".

10) Buforowanie i wydajność

Bufor krawędzi: klucz „cennik: region: waluta: sku: wersja”; TTL dla stabilnych walut jest wyższy.
Rozgrzewka: Ocieplenie najlepszych kategorii przez uruchomienie kampanii.
SWR (stale-while-revalidate): dla sklepów; Kasa - tylko świeża.
Częściowe unieważnienie: niepełnosprawność przez 'sku', 'category', 'pricelist _ version' tagi.
SLO: p95 ≤ 120 ms dla wyświetlacza, p95 ≤ 250 ms dla cytatu, ≥ 99. 95% dostępności.

11) Obserwowalność i audyt

Ślad: 'trace _ id',' pricelist _ version ',' fx _ version ',' tax _ rule _ version 'we wszystkich zdarzeniach.
Immutability: WORM-czasopisma publikacji cenników/kursów; Plastry Merkle'a, podpisy wydawnicze (DSSE).
Paragony: czek/paragon z pełnym układem i hash ładunku; przechowywać przez 7-10 lat (według regulatora).
Deski rozdzielcze: rozbieżność realizacji transakcji, częstotliwość zaokrąglania w górę/w dół, błędy FX, czas blokady kursu (blokada TTL), promo ROI.

12) Lokalizacja wyświetlacza

Format waluty: znak/kod (€, $, $, AED), pozycja znaków, delimitery, przestrzeń.
Lokalne zasady: "1,234,56" vs "$1,234. 56”.
Psychologia: magiczne tagi cenowe ('.99') nie zawsze są odpowiednie w fintech/gry; badanie w przeliczeniu na region.
Podpisy prawne: „Cena zawiera VAT”, „Prowizja sieciowa jest pobierana oddzielnie”.

13) Przypadki szczególne

Waluty bez części frakcyjnej: JPY/ISK - minor_units=0.
Trzyznakowe jednostki drobne: KWD/BHD = 3.
Krypta: BTC/ETH/USDT - do 8 znaków, opłata sieciowa oddzielnie; stablecoins „1:1 heading” z transgranicznym.
Podwójna cena: „waluta katalogowa” i „waluta odpisu” (kurs bankowy handlowca). Udokumentuj rozprzestrzenianie się.
Sport/gry: maksymalne limity wygranych w walucie katalogowej - zachowaj odpowiedniki w rundzie 'fx _ version'.

14) SLO/SLI i wskaźniki sukcesu

Poprawność: odsetek zamówień, w których total_checkout = total_quote (± 1 mniejsza jednostka dla reguł dystrybucji) ≥ 99. 99%.
Stabilność FX: udział operacji w szybkim oknie blokady ≥ 99%.
Gospodarka: marża/jednostka vs plan; odchylenia wynikające z FX/zaokrąglania (bps).
UX: wycena prędkości p95, udział dumpsów w konwersji cen, sklepów NPS.
Audyt: 100% kontroli z zapisaną „_ wersją” i podpisem.

15) Playbooks incydentu

1. zamrażać gotówkę wyłączoną, 2) wymuszoną cenę odświeżania, 3) porównać „cennik _ wersja ”/„ fx _ version”, 4) rekompensatę z tytułu polityki.

1. włączyć zwiększony znacznik/czapkę rabatową, 2) zmniejszyć blokadę TTL, 3) przełączyć na źródło awaryjne.

1. sprawdź 'tax _ rule _ version', 2) walidację rounding_scope, 3) zasady hotfix i reprice koszy.

1. przepisy bezpieczeństwa (min_price), 2) wyłączają układanie, 3) ponowne obliczanie i audyt.

16) Bezpieczeństwo i zgodność

Policy-as-code: kontrola zmian w cennikach/FX/podatki poprzez podpisy PR + release.
Role/dostęp: 4-oka zasada dotycząca publikacji cenowych/FX.
Dzienniki/pokwitowania: podpisane wydarzenia wydawnicze i realizacja transakcji.
Ograniczenia regionalne: zakaz stosowania poszczególnych walut/żetonów; geo-politycy.

17) Eksperymenty i optymalizacja

A/B: kalkulacja uroku, wstępnie obliczone ceny vs on-the-fly, format wyświetlacza.
Dynamiczny markup: zależność od zmienności pary/pora dnia.
Analiza kohort: zwroty/obciążenie zwrotne według waluty, wrażliwość zaokrąglania.
Strategie gotówkowe: wpływ SWR/TTL na konwersję i dokładność.

18) Lista kontrolna wdrażania

• Określić walutę bazową i politykę w przeliczeniu na walutę arkuszy.
• Skonfiguruj kolekcję/publikację FX za pomocą wersji, znaczników i blokady TTL.
• Sformalizować TaxRule i obliczenie/zaokrąglanie zlecenia (na element lub na koszyk).
• Wdrożenie API katalogu/quote/commit + podpisane paragony.
• Włączyć krawędź pamięci podręcznej i ziarnistej niepełnosprawności; SWR dla sklepów.
• Tworzenie desek rozdzielczych (realizacja transakcji z witryną, błędy FX, podatki, marża bps).
• Wpisz role/podpisy w publikacjach dotyczących cen/stawek, czasopisma WORM.
• Przygotuj playbooks: Price miss, FX spike, rozbieżności podatkowe.
• Prowadzenie „GameDay Catalog”: wyłączyć źródło FX, wybuch promo, zmiana podatku.
• Regularne zmiany minor_units/otobrazheniye w podziale na regiony.

19) FAQ

Czy muszę przechowywać ceny w każdej walucie?
Niekoniecznie. Połączyć wstępne obliczenia dla najlepszych walut i konwersji dla ogona - w ten sposób UX i koszty są zrównoważone.

Dlaczego całkowite „nie bije” po zaokrągleniu?
Ze względu na różnice na element vs na koszyk. Napraw jedno podejście i użyj „penny distribution”.

Jak dokonać zwrotu pieniędzy w ciągu miesiąca?
Zgodnie z historycznym 'pricelist _ version', 'fx _ version' i 'tax _ rule _ version' zapisanym w paragonie.

A co z kryptą?
Użyj dokładności dziesiętnej, opłata sieciowa oddzielnie, nie obiecuj 1:1 fiat; naprawić kurs i okno działania.

Podsumowanie: Katalog wielokrotności to połączenie precyzyjnej matematyki, ścisłych zasad i inteligentnego buforowania. Wersja wszystko (ceny/stawki/podatki), naprawić okno notowania, określić kolejność obliczeń i zaokrąglania, podpisać sprawdzić artefakty i utrzymać deski rozdzielcze widoczne. Więc dostajesz uczciwą prezentację, powtarzalne osiedla i zarządzaną gospodarkę we wszystkich walutach i regionach.