Ҳамгироии экосистемаи шарик
1) Нақшҳо ва моделҳои иштирок
Операторҳо/брендҳо: мағозаҳо, нуқтаҳои аҳолинишин, KYC/AML, масъулият барои таҷрибаи корбар.
Студияҳо/RGS/Агрегаторҳои мундариҷа: бозиҳо/ҷараёнҳо, каталогҳо, воситаҳои таблиғотӣ.
Таъминкунандагони пардохт/ҳамёнҳо: PSP, APM, крипто, пардохтҳо.
KYC/AML/Antifraud: санҷиш, рӯйхати ғарқшуда, баҳодиҳии хатар.
Шӯъбаҳо/шабакаҳои маркетингӣ: трафик, постбэкҳо, атрибутсия.
ISV/интеграторҳо: модулҳои иловагӣ, барномаҳои бозор.
Моделҳо: муроҷиат/бозфурӯш, сафед-тамғакоғаз/OEM, бозор/app-store, hub & talk (федератсия).
2) "Шиносномаи шарикӣ" ва бастаи Starter
Чаро: Манбаи ягонаи ҳақиқат дар бораи ҳуқуқҳо, минтақаҳо, версияҳо, SLO, калидҳо ва равандҳо.
yaml partner_passport. v1:
partner_id: "kyc-omega"
type: "KYC/AML"
regions: ["EU","TR","LATAM"]
contracts: { msa: "2025-01-10", dpa: "2025-01-10", sla: "99. 9/30d" }
api_versions: ["identity. v1","events. v1","webhook. v1"]
auth: { oidc_client_id: "p_omega", scopes: ["kyc:read","kyc:write"] }
webhooks: { signature: "Ed25519", retry: "exp", dedupe: true, ttl_s: 300 }
rate_limits: { rps: 100, burst: 300 }
pii_policy: { minimization: true, retention: "180d", geo_pinning: ["EU"] }
recon: { window_days: 7, epsilon: 0. 002 }
owners: { biz: "ecosystem-biz", tech: "integrations" }
status: "sandbox"3) Дар киштӣ: Ариза ба раванди истеҳсолот
1. Санҷиш: саволнома, шарики KYC, манбаъҳои маълумот/трафик, санҷиши ғарқ.
2. Шартномаҳо: MSA/DPA/SLA/OLA, тиҷорат (CPA/Rev
3. Оғози Tech: Барориши калид/муштарии OIDC, дастрасии қуттиҳо, пакети санҷишӣ.
4. Санҷишҳои мутобиқат: схемаҳои рӯйдодҳо, вебҳукҳо, маҳдудиятҳо, номутобиқатӣ.
5. Шарҳи амният: имзои артефактҳо, SBOM/SLSA (агар SDK/муштарӣ).
6. Пилот/канарӣ: ҳаҷми маҳдуд/гео, мониторинги мукаммал.
7. Go-live: интиқоли мақом, панелҳои SLO-dashboard, нақшаи посух.
8. QBR/MBR: баррасиҳои мунтазами KPI, ҳодисаҳо, харитаҳои роҳ.
4) Шартномаҳои маълумот ва схемаҳои ҳодиса
Принсипҳо: минимализатсия, версияҳо (семвер), мутобиқати 'v
yaml event. common. v1:
id: uuid occurred_at_utc: timestamp source_partner_id: string trace_id: uuid type: enum # e. g., "kyc. approved. v1"
payload: object signature: ed25519 version: "1. 0. x"Каталогҳо ва ҳисоботҳо: JSON Schema/Avro, назорати ҳатмии саҳро, TTL/нигоҳдорӣ, Hold Legal.
Устуворӣ: шикастани тағирот танҳо тавассути намудҳо/версияҳои нав бо равзанаи амортизатсия.
5) Аутентификатсия, авторизатсия, асрори
OAuth2/OIDC: агар имкон бошад, токенҳои кӯтоҳмуддат, POP/DP.
MTLS барои сервер-ба-сервер.
Веб-китобҳои имзошуда: Ed25519/HMAC; зидди такрорӣ ('X-Timestamp', 5 дақиқа тиреза).
POLP/ABAC: миқёс/сифатҳо: 'шарик', 'минтақа', 'маҷмӯаи маълумот', 'env'.
Гардиши калидҳо: дутарафа, бо равзанаи мутобиқат ва пайроҳаи аудит.
python def verify(req):
if abs(now()-req. h["X-Timestamp"])>300: return 401 if not sig_ok(req. body, req. h["X-Signature"], partner_pubkey): return 401 if seen(req. json["event_id"]): return 200 store(req. json); mark_seen(req. json["event_id"]); return 2006) Номутобиқатӣ, маҳдудиятҳо, истодагарӣ
Калиди Idempotency: 'partner _ id + external_id + op_type'.
Маҳдудияти меъёрҳо/квотаҳо: RPS, таркиш, оғози гарм, омилҳои коҳиши таназзул.
Сиёсатмадоронро такрор кунед: намоишгар + ҷиттер, бобояш дар зиёфат.
Қолаби баромад/паёмдони қуттӣ: таҳвили кафолатнок, тарҳ, аудит.
Backpressure: навбатҳо, DLQ бо нигоҳдории алоҳида.
7) Мушоҳида ва SLO
Метки: 'шарик', 'минтақа', 'api _ version', 'маршрут', 'env'.
SLI: мавҷудият, таъхири p95/99, хатогӣ, таҳвил дар дохили тиреза, recon-diff.
SLO & сатҳи сӯзондан: барои як шарик/гиреҳ; ҳушдорҳо аз ҳад зиёд.
Нишонаҳо: ба-охири 'trace _ id'; интихоби дум ва интихоби хато.
Синтетика: санҷиши берунии нуқтаҳои ниҳоӣ/имзоҳо/TTL.
rego package partner. release deny["SLO at risk"] { input. slo_forecast. error_burn > 1. 0 }
deny["Missing schema tests"] { input. tests. schemas_passed == false }8) Мувофиқат ва махфият
Geo-pinning: маълумоти ҳассоси домейн минтақаҳои иҷозатшударо тарк намекунад.
Ҳадди аққал ва тахаллуси PII: 'user _ pseudo _ id' ба ҷои PD-ҳои мустақим.
Мӯҳлати нигоҳдорӣ: TTL/ILM; крипто-решакан кардани калид (ба як шарик/ба як минтақа).
Ҳуқуқҳои мавзӯъ: равона кардани DSAR ба манбаъ, сабти иҷро.
Дастрасӣ ба гузоришҳо ва аудитҳо: кӣ дид, ки чаро; гузоришҳои тағйирнопазир.
9) Ҳисобҳо, атрибутсия ва мусолиҳа
Базаи ҳисобкунӣ: холис ва умумӣ, қурби асъор, андозҳо, мукофотпулӣ.
Атрибутсия: тирезаҳо (клик/намоиш), афзалияти канал, тарҳ аз ҷониби 'event _ id/click _ id'.
Оштӣ: гузоришҳои дуҷониба, ε - таҳаммулпазирӣ, SLA барои бастани ихтилофот (≤ 5 рӯзи корӣ).
sql
SELECT a. event_id
FROM partner_report a
LEFT JOIN internal_events b ON a. event_id=b. event_id
WHERE a. date BETWEEN:from AND:to AND b. event_id IS NULL;10) Идоракунии версия ва тағирёбии API
Семвер: 'v1' шохаи устувор аст; шикастани → 'v2' бо дастгирии дугона ≥ 90 рӯз.
Раванди радкунӣ: эълон → парчам дар шиноснома → синтетика/огоҳӣ → хомӯш кардан.
SDK/пайвасткунакҳо: имзои озод, SBOM, мутобиқат, дастурҳои муҳоҷират.
11) Масир ва федератсия (агар якчанд шарикони якхела)
SOR (Масири Smart Order): нарх/сифат/таъхир/мувофиқат/обрӯ.
Адолат: маҳдудиятҳои ҳиссаи гардиш, танаффус аз ҷониби SLA/эътибори.
Таназзул: таназзули одилона, таназзули шаффоф (огоҳиҳо/баннерҳо).
12) Китобҳои бозии ҳодиса
12. 1 "Диаграммаи Веб Ҳук Дрифт"
yaml detect: "schema_validation_error_rate>0. 5%"
steps:
- "auto-pause partner webhooks"
- "fallback to cached/default behavior"
- "notify partner; open war-room"
- "provide diff & test vectors; hotfix window 24h"
kpi: ["RTA<=1h","residual_errors<0. 1%"]12. 2 "Нокомии SLO дар PSP/KYC"
1. Азнавтақсимкунӣ тавассути SOR →
2. Имкон диҳед, ки таназзули зебо дар § ҷараён
3. Маҳдудиятҳо/квотаҳоро татбиқ кунед
4. Эҷоди қарзи SLA ва пас аз ҳодиса.
12. 3 "Номутобиқатӣ дар ҳисобҳо"
1. Пардохтҳоро аз рӯи § диапазон ях кунед
2. Аз нав ба кор даровардани рӯйдодҳо аз outbox
3. Оштӣ/ ε ислоҳҳо →
4. Санади муштарак ва обшавии.
13) Портали бозор/шарик
Сертификатсияи ҳамгироӣ: рӯйхатҳои назоратӣ, нишонаҳои сифат (тилло/нуқра/биринҷӣ).
Каталоги пайвасткунанда: ҷустуҷӯ/филтрҳо аз рӯи бозор/намуди/версияи API.
Autogen-SDK/характеристика: Open
Худмаблағгузорӣ: калидҳо, вебхукҳо, маҳдудиятҳо, маҷаллаҳо, чаҳорчӯбаҳои санҷишӣ.
14) Нишондиҳандаҳои камолоти ҳамгироӣ
Вақт ба интегратсия (TTI) -Дар рӯзҳои Median.
Фарогирӣ: Ҳиссаи бозорҳо/хусусиятҳое, ки аз ҷониби шарик дастгирӣ мешаванд.
Меъёри гузариши SLO: ҳар моҳ аз ҷониби шарик/минтақа.
Рекон-саломатӣ: сатҳи бастани номутобиқатӣ, ε боқимонда.
Ҳолати амният: басомади гардиши калидӣ, фарогирии SBOM.
Арзиш/egress: $/req ва $/GB аз ҷониби шарик, иҷрои SOR.
15) Анти-намунаҳо
"Аввал пайваст шавед, баъд стандартҳо" → интегратсияи зоопарк.
Схемаҳои беназир барои ҳар як шарик → таркиши мураккаб.
Танҳо атрибутсияи кукиҳо бе гум S2S → ва баҳсҳо.
Не idempotency/limits → такрорӣ/тӯфон.
PII дар гузоришҳо/вебҳукҳо → хатарҳои танзимкунанда.
Як "супер-интегратсия" бидуни алтернатива → хатари консентратсия.
API бидуни равзанаи амортизатсия ва синтетика → садамаҳо дар маҳсулот тағйир меёбад.
16) Рӯйхати санҷиши меъмории ҳамгироӣ
1. Шиносномаи шарикӣ пур карда шудааст (шартномаҳо, минтақаҳо, версияҳо, калидҳо, SLO)?
2. Схемаҳои ҳодиса ва ҳисобот бо бастаи санҷишӣ тасдиқ карда мешаванд, оё қуттича ҳаст?
3. OA buth/OIDC, имзои ҳатмии webhook ва анти-такрорӣ фаъол аст?
4. Idempotence, маҳдудиятҳо, outbox/паёмдони ва DLQ татбиқ карда мешаванд?
5. Панели панели SLO/SLA, пайҳо, огоҳиҳо бо суръати сӯхтан танзим карда шудаанд?
6. Тирезаҳои муқоисавӣ ва ҳисобкунӣ/атрибутсия ба расмият дароварда шуданд?
7. Масири Geo-pinning/TTL/crypto-erasure ва DSAR дар ҷои худ?
8. Semver, раванди фарсудашавӣ ва дастгирии версияи дугона ҳуҷҷатгузорӣ шудаанд?
9. Дафтарҳои бозии ҳодиса тафтиш карда шуданд (гардиши гардиш, нокомии SLO, recon diff)?
10. Нақшаи баромадан: калидҳои ғайрифаъол, маълумоти содиротӣ, гузариш ба манбаи дуюм?
Хулоса
Интегратсияи шарик як лӯлаи истеҳсолӣ аст: стандартҳо → санҷиш → мушоҳида → такмил. Вақте ки шиносномаи шарик пур аст, рӯйдодҳо ва шартномаҳо навишта мешаванд, аутентификатсия ва имзоҳо талаб карда мешаванд, SLO-ҳо чен карда мешаванд, ҳисобҳо муқоиса карда мешаванд ва тағирот тавассути версияҳо ва дарвозаҳо идора карда мешаванд - экосистема зуд ва боэътимод меафзояд ва ҳар як шарики нав арзиши худро илова мекунад. ба шабака.