Созгорпазирии иштирокчиён

(Қисмат: Экосистема ва шабака)

1) Ҳамоҳангсозии иштирокчиён чист

Ҳамоҳангсозӣ - қобилияти ташкилотҳои гуногун (операторҳо, студияҳо, PSP, провайдерҳои KYC/AML, пулҳо, филиалҳо, таҳлилгарон ва идоракунандагон) барои боэътимод бо ҳамдигар тавассути протоколҳо ва шартномаҳои мувофиқашуда ва ҳамзамон нигоҳ доштани амният, махфият ва таҷдиди натиҷаҳои тиҷорат.

• Вақт ба ҳамгироӣ ↓
• Пешгӯишаванда (SLO/SLA-и устувор бо ҷараёнҳои интиқодӣ).
• Амният ва мувофиқат (ҳадди аққали ҳуқуқҳои кофӣ, аудит).
• Таҳаввулот бидуни тақсимот (версия, мутобиқати қафо).

2) Сатҳи созгорпазирӣ (модели қабат)

1. Нақлиёт ва шабака: HTTP/2/3, GRPC/QUIC, Web

2. Шахсиятҳо ва боварӣ: org_id, peer_id, X.509/mTLS, имзоҳо, гардиши калидҳо.
3. Ҳодисаҳо ва маълумот: схемаҳои ягонаи рӯйдодҳо, каталогҳои дороиҳо/шабакаҳо, аблаҳӣ.
4. Равандҳо ва шартномаҳои корӣ: пардохт/ҳисоббаробаркунӣ, атрибутсия, сигналҳои хавф, такрори маҳдуд.
5. Қабати идоракунӣ/ҳуқуқӣ: SLA/SLO, DPA, литсензияҳо, қоидаҳои ҳокимият.
6. Мушоҳида ва сифат: SLI/SLO, воридшавӣ, пайгирӣ, аудит.

Ҳар як қабат шартномаҳо, озмоишҳо ва сиёсати мутобиқати худро дорад.

3) Принсипҳои тарроҳӣ

Шартнома-аввал: API/схемаҳо/чорабиниҳо пеш аз татбиқ ба расмият дароварда мешаванд.
Тағироти ба қафо мувофиқ: стратегияи "танҳо майдонҳо илова кунед" ва равзанаи фарсуда ≥ 90 рӯз.
Музокироти қобилият: Мубодилаи иштирокчиён қобилиятҳоро дастгирӣ мекунад ва зербанди умумиро интихоб мекунад.
Изолятсия ва ПЛП: дастрасӣ ва маҳдудиятҳо "ҳадди аққали зарурӣ" дода мешаванд.
Идемпотентсия ва детерминизм: амалиёти такрории бехатар, қоидаҳои пешгӯишавандаи низоъ.
Мушоҳидаҳои пешфарз: таносуби пайгирии дархостҳо/рӯйдодҳо, векселҳои тасдиқшаванда.
Кам кардани маълумот: набудани PII дар телеметрия/тамғакоғазҳо, псевдонимизатсия.

4) Гуфтушунид оид ба қобилият

Ҳангоми даст ба ларза гирифтан, иштирокчиён манифести хусусиятҳо ва версияҳоро нашр мекунанд.

yaml participant:
org_id: "ORG:ACME"
versions:
api: "2. 6. 1"
events: "1. 9. 0"
capabilities:
payouts: { create: true, cancel: true, currencies: [USD, EUR, USDC] }
kyc: { level: ["basic","enhanced"], sla_minutes_p95: 15 }
bridge: { proof: ["light","zk"], challenge_supported: true }
telemetry: { qos: ["P0","P1"], traces: true }
limits:
payouts_daily_usd: 1_000_000 rate_limits: { create_per_minute: 500 }

Муҳаррики мутобиқат ба ҳизб мувофиқат мекунад ва профили кориро интихоб мекунад (масалан, 'пардохт: v2', 'ҳодисаҳо: v1. 9`).

5) Шартномаҳо ва схемаҳои API/чорабиниҳо

Шартномаҳои API: Open

Модели ҳодиса: 'амонат. ',' пардохт. ',' пул. ',' kyc. ',' хатар. ',' маҳсулот. '- бо майдонҳои устувор.
Феҳристҳо/каталогҳо: шабакаҳо, дороиҳо, усулҳои пардохт, версияҳои SDK, минтақаҳо/қаламравҳо.
Шартномаҳои маълумот - дар CI санҷидашуда, тавассути идоракунӣ бо мӯҳлат тағйир меёбад.

yaml event:
id: uuid ts: timestamp_utc type: payout. created    payout. finalized    bridge. lock...
src_org: string dst_org: string payload: object trace_id: string idempotency_key: string signature: string # source signature

6) Версия ва мутобиқат

Версияҳои семантикӣ: 'MAJOR. МИНОР. ПАТЧ '.
Қоидаҳо: MINOR/PATCH - ба қафо мувофиқ; MAJOR - мавҷудияти мувозӣ бо "адаптерҳо", 90 рӯзро аз даст медиҳад.
Китобҳои бозии муҳоҷират: қолабҳои муҳоҷират барои API/events/directories; эмуляторҳои форматҳои кӯҳна.

7) Намунаҳои ҳамгироӣ (намунаҳо)

Дархост-ҷавоб + Номутобиқатӣ: пардохтҳои бехатар/маҳдудиятҳо/захираҳо.
Рӯйдодҳо: "манбаъҳои ҳақиқат" тағиротро мефиристанд; муштариён мағозаҳоро ҷобаҷо мекунанд.
Outbox/Inbox: нашри атомии рӯйдодҳо аз пойгоҳи додаҳо; қабули idempotent дар муштарӣ.
SAGA (оркестр/хореография): амалиёти ҳамоҳангшудаи бисёрсоҳавӣ (масалан, "popolneniye → igrovoye sobytiye → vyplata").
Гвардияи дугона: вурудоти мустақими дугона бидуни қуттӣ вуҷуд надорад.
Такрори/Backfill: нокомӣ бо фармоиш ва ниҳоӣ.

8) Амният ва эътимод

MTLS ва ҳатмии калидӣ ба 'org _ id/peer _ id'.
Имзои чорабиниҳо, сабти эътимод (кӣ ва чӣ имзо/қабул шудааст).
RBAC/ABAC ва квотаҳо: ҳуқуқҳо аз рӯи нақш, маҳдудиятҳо аз рӯи амалиёт/ҳаҷм.
Идоракунии махфӣ: ротатсия, манъи нишонаҳои "дарозмуддат", миқёси кӯтоҳ.
PII/махфият: токенизатсия, сегрегатсияи минтақавии маълумот (EU/ROW), равандҳои DSR (нест кардан/содирот).
Муҳофизат аз сӯиистифода: маҳдудиятҳои суръат, сигналҳои зидди қаллобӣ, санҷишҳои таҳримот.

9) SLI/SLO ва мушоҳидаи созгорпазирӣ

• 'p95 Вақт барои эътироф'.
• 'p95 Анҷом-ба-охир' (эҷод § анҷом додан/иҷро кардан).
• 'Сатҳи муваффақият/навъи амалиёт.
• 'Схема/Мувофиқати шартнома%' (паёмҳои дуруст).
• 'Фарогирии исботи%' (таносуби далелҳои имзошуда/замимашуда).
• 'Хатогии буҷа сӯзондан' po P0/P1.

• P0 (пардохт/пул): p95 E2E ≤ 5 дақ., Муваффақият ≥ 99. 5%, Ack ≤ 2 sec.
• P1 (маҳсулот): Тару тоза p95 ≤ 3 дақ., Мувофиқат ≥ 99. 9%.
• Шартномаҳои маълумот: Drift MTTA ≤ 5 дақиқа, Тағиротҳо = 0 бе MAJOR.

Дашборды: Интерпоп Опс, Саломатии шартнома, Таъхир ва Муваффақият, Схема Дрифт, Амният ва Калидҳо.

10) Матритсаи мутобиқат (тарҳи тестӣ)

• Сенарияҳо: пардохтҳо, амонатҳо, пулҳо, хавф, маҳсулот, телеметрия.
• Версияҳо: API v2. 6/v2 нест. 5, рӯйдодҳои v1. 9/v1 нест. 8.
• Усулҳои шабака: муқаррарӣ, таназзул, регургитация, таъхири DA.
• Қаламравҳо: EU/UK/TR/LA - каталогҳо ва қоидаҳои гуногун.

Автотестҳо: санҷишҳои шартномавӣ (истеҳсолкунанда/истеъмолкунанда), idempotency, retry/ҷуброн, schema-linters, профилҳои сарборӣ.

11) Схемаҳо ва каталогҳои истинод

Каталоги хусусиятҳо (SQL)

sql
CREATE TABLE capabilities (
org_id TEXT,
cap_name TEXT,
version TEXT,
params JSONB,
PRIMARY KEY (org_id, cap_name)
);

Феҳристи шартнома/версия

sql
CREATE TABLE contracts (
name TEXT, kind TEXT,     -- api    events    catalog version TEXT, status TEXT,  -- active    deprecated    retired breaking BOOLEAN DEFAULT FALSE,
effective_from TIMESTAMPTZ,
deprecates_at TIMESTAMPTZ,
PRIMARY KEY (name, version)
);

Мониторинги мутобиқат

sql
SELECT name, version, 100. 0SUM(CASE WHEN compliant THEN 1 END)/COUNT() AS compliance_pct
FROM contract_checks
WHERE ts >= now() - INTERVAL '7 days'
GROUP BY name, version;

12) Танзимот (YAML)

Сиёсати версия

yaml versioning:
events: { compatibility: "BACKWARD", deprecate_days: 90 }
api:  { parallel_majors: true, support_minors: 2 }

Номутобиқатӣ ва такрорӣ

yaml idempotency:
header: "Idempotency-Key"
ttl_hours: 72 conflict_policy: "prefer-latest-payload-with-signature"

Синфҳои QOS

yaml qos:
P0: { ack_timeout_ms: 2000, retries: 3, backoff_ms: [100,400,800] }
P1: { ack_timeout_ms: 5000, retries: 2 }
P2: { best_effort: true }

13) Тартиби амалиёт

Ҳамарӯза: ҳисоботи мутобиқат дар бораи шартномаҳо/схемаҳо, калидҳои мӯҳлати истифодашуда, сӯзондани SLO.
Ҳафта: Кумитаи ҳамоҳангсозӣ (имкониятҳои нав, муҳоҷират, фарсуда).
Пеш аз озод шудан: санҷишҳои шартномавӣ, канарейка бо ченакҳои "шиша", нақшаҳои бозгашт.
Ҳодисаҳо: канали ягонаи ҳолат, қолабҳои паём барои шарикон, пас аз марг ≤ 72 соат.

14) Ҳодисаҳои китоби бозӣ

A. Schema/Drift шартнома

1. Даргиронидани "ҳолати қатъӣ" (буридани паёмҳои номувофиқ),

2. ҳодисаро кушоед ва манбаъҳоро огоҳ кунед,

3. тавлид кардани diff

4. адаптер/ислоҳро озод кунед,

5. навсозии пас аз марг ва линтер.

B. такрори яклухт/паёмҳои дугона

1. Санҷиши idempotence/калидҳо,

2. филтрҳои тарҳро фурӯзон кунед,

3. маҳдудкунандаи истеҳсолкунандаи ғалоғула,

4. ҳисобкунии тирезаҳои дӯконҳо.

C. афзоиш дар таъхир/кашидани ack

1. Афзалияти P0, афзоиши истеъмолкунандагон,

2. муваққатан кам кардани интихоби P2,

3. таҳлили масир ва шабака.

D. компромиссияи калиди аъзо

1. Бозхонд, ротатсия, навсозии феҳристи боэътимод,

2. аз нав имзо кардани бастаҳои/сертификатҳои интиқодӣ,

3. аудити амалҳо, ҳисобот ба шарикон.

Номутобиқатии директория (дороиҳо/шабакаҳо)

1. Паёмҳои муноқишаи карантинӣ,

2. каталоги бозгашт

3. ҳисобкунии агрегатҳо,

4. чопи часбҳо.

15) Рӯйхати назорати амалисозӣ

1. Сатҳҳо ва шартномаҳоро муайян кунед (API, ҳодисаҳо, феҳристҳо, калидҳо).
2. Музокироти қобилият ва сабти версия/қобилиятро иҷро кунед.
3. Дохил кардани idempotency, квотаҳо, QOS, имзоҳо ва MTLS.
4. Танзимоти SLI/SLO, панели панелҳо ва огоҳиҳо (Ack, E2E, Мувофиқат).
5. Автоматикунонии санҷишҳои шартнома ва матритсаи санҷиши мутобиқат.
6. Тартиби беқурбшавӣ ва муҳоҷиратро ворид кунед (MAJOR ба таври мувозӣ).
7. Мунтазам баррасии каталогҳо/махфият ва қоидаҳои дастрасӣ.

16) Луғат

Музокироти қобилият - оштӣ кардани қобилиятҳо ва профили корӣ.
Шартнома-аввал - Интерфейси тарроҳӣ тавассути шартномаҳои расмӣ пеш аз татбиқ.
Idempotency - амалиёти такрории амният.
Schema/Drift Drift - фарқияти байни паёмҳои воқеӣ ва шартномаҳои эълоншуда.
ПЛП принсипи ҳуқуқҳои ҳадди ақали зарурӣ мебошад.
Риояи% фоизи паёмҳо/дархостҳоест, ки ба шартнома мувофиқанд.

Сатри поён: Ҳамоҳангсозии иштирокчиён системаи идоракунии шартномаҳо, версияҳо, қобилиятҳо ва мушоҳидаҳо мебошад. Бо пайравӣ аз ин чаҳорчӯба, экосистема ҳамгироии босуръат, ҷараёнҳои устувори тиҷорат ва таҳаввулоти бехатарро бидуни тақсимот - аз сатҳи шабака ва шахсият то равандҳо ва идоракунӣ таъмин менамояд.