Vazifa
Agent tarmogʻi degani, bitta tizimda bir-birini umuman koʻrmasligi kerak boʻlgan kompaniyalar ishlaydi. Na qoldiqlarni, na mijozlarni, na toʻlovlar tarixini, na maʼlumotnomalarni. Shu bilan birga ularning har biri platformaga qoʻlda kabinetda oʻtirib emas, dasturiy ulanishni xohlaydi. Demak ochiq API kerak, unga hujjat kerak va oldindan aytiladigan xatti-harakat kerak, chunki hamkor platforma haqida shartnoma imzolagunga qadar aynan shular boʻyicha xulosa chiqaradi.
Yechim
Platforma vazifalari ajratilgan toʻrtta qismga boʻlingan: kabinet uchun shaxsiy API, integratorlar uchun ochiq JSON-RPC, agentning oʻz kabineti va alohida hujjatlar sayti.
Ijarachilarni ajratish hamma qatlamdan oʻtadi. Har bir tanlov ijarachi bilan cheklangan, va bu dasturchilar oʻrtasidagi kelishuv emas, alohida tekshiriladigan talab: bitta unutilgan tekshiruv ekranda begona maʼlumot degani.
Pul ikki fazada sanaladi. Toʻlov zaxiraga olinadi, provayderga ketadi, va faqat provayderning tasdigʻi zaxirani oʻtkazmaga aylantiradi.
Agent komissiyasi va mukofoti umumiy formula boʻyicha emas, aniq «ijarachi va xizmat» juftligi sozlamalari boʻyicha hisoblanadi.
Arxitektura va qanday qurdik
Nimalar kirdi:
· kabinetning shaxsiy API si va tashqi integratorlar uchun ochiq JSON-RPC
· agent kabineti: balans, toʻlovlar, tarix, hisobotlar
· provayderga bogʻliq maydonlar bilan xizmatlar katalogi, kaskadli roʻyxatlar bilan birga
· holatlari va osilib qolgan operatsiyalarni ajratishi bilan ikki fazali toʻlov
· ikki faktorli autentifikatsiya va API ning ochiq hujjatlar sayti
Har bir ijarachi xizmati uchun komissiya va mukofot alohida sozlanadi. Stek: NestJS, funksiya va triggerlar bilan PostgreSQL, navbatlar bilan Redis, kabinetda React.
Natija
Platforma prodda ishlaydi va agentlarga xizmat qiladi, uning ochiq hujjatlari esa alohida ish bajaradi. Aynan shu hujjatlar boʻyicha tashqi toʻlov kompaniyalari biz bilan integratsiya arziydimi yoʻqmi deb baholaydi va oʻz mamlakatlarini ulash taklifi bilan keladi.
API sifati toʻgʻridan-toʻgʻri hamkor olib keladigan holat kamdan-kam uchraydi.
