Платформа SelSup · Кіраўнікі
Пашырэнні і інтэграцыі на заказ
Выбар паміж знешнім паслугай задніх бакоў, убудаваным React UI, і сервер-сход рынку або модуль дастаўкі.
Большасць інтэграцый павінна пачацца як знешняя заднія рэчывы з выкарыстаннем грамадскага API. Убудаваны карыстальнік карыстаецца карыстальцам, калі ён павінен працаваць непасрэдна ўнутры SelSup.
Развівальнікі прыкладанняў і партнёры ў галіне тэхналогій01
Выберыце тып інтэграцыі
- 1
Паслуга знешняга заканчэння
Лепш за ўсё для ERP, вэб-крамы, WMS, BI і аналагічнай сінхрынізацыі. Токен застаецца на серверы і дадзеныя перамяшчаюцца праз API і вэбхукі.
- 2
Пашырэнне рэакцыі
Выкарыстоўвайце яго для карыстацкага інтэрфейсу, які павінен працаваць у SelSup і паўторна выкарыстоўваць ўзоры ўзаемадзеяння прадукту.
- 3
SelSup папярэдні модуль
Патрабавана для глыбокага рынку або інтэграцыі дастаўкі ўдзельнічаюць у агульных працэсах SelSup фону.
Укараньні адзін поўны працоўны паток і яго назіральнасць спачатку. Дадаць маштабны імпарт, UI, і больш тыпаў падзей пасля ўзгаднення стабільны.
02
Архітэктура знешніх прыкладанняў
Захоўвайце токен у кіраўніку сакрэтаў і тэлефануйце SelSup толькі з вашага бэкэнд.
Аддзяліце адаптар SelSup, чаргу працы і мадэль дамена. API змены кантрактаў затым застаюцца ізаляванымі ад астатніх прыкладанняў.
Выкарыстоўвайце паступную скрынку для паступных падзей і выхадную скрытку для выходзячых змяненняў.
SelSup webhook → inbox → domain worker → ERP/WMS
ERP/WMS change → outbox → SelSup API → reconciliation
Сродкі API канечныя пункты
GET/api/product/findПрыклад чытання слоўнікаGET/api/order/findПрыклад інкрэментальнай сінхронізацыі
03
Убудаваная пашырэнне React
Кампанент працуе ў інтэрфейсе SelSup. Внешняя дамена павінна дазволіць запыты з selsup.ru і правільна выконваць абмежаванні браўзэра.
Ніколі не ўсталёўвайце ў пакет пастаянны токен API. Праверце прывілеяваную працу праз ваш бэкэнд і кароткатэрміновы кантэкс карыстальніка, вызначаны архітэктурай пашырэння.
Згуляць ўзоры ўзаемадзеяння прадукту і ахопліваць даступныя пустыя, загрузкі і error стан.
Дазволеныя паход кіруе доступам браўзэра, але не аўтэнтыкуе карыстальніка.
https://github.com/SelSup/component
04
Модуль інтэграцыі з боку сервера
Інтэграцыя рынку звычайна ахоплівае токены, карты, цэны, акцыі, замовы і абнаўленні статусу фону.
Гэты модуль змяняе асноўны задні план SelSup і прытрымліваецца яго працэсу агляду, тэставання, лакалізацыі і выпуску.
Пераўтварыць здарэнні знешніх API ў стабільныя значэнні ApplicationError і адкліканыя або непапраўныя знешнія токены ў AccessException ў адпаведнасці з правіламі задніх праектаў.
Не дадайце рынкавыя спецыфічныя поля ў агульныя суб'екты. Захоўвайце сырыя кантракты ў інтэграцыйных DTO і адлюстроўвайцеся на мяжы.
05
Выпуск і эксплуатацыя
- 1
Стварэнне тэставага ўліку
Асобныя тэставыя токены, склады, прадукты і заказы з дадзеных прадукцыі кліента.
- 2
Дадаць назіральнасць
Адсочваць затрымкі чаргі, памылкі па кодзе, пералік перапрабаванняў і непарыўнасці ў пагадненні.
- 3
План кантрактнай міграцыі
Падтрымлівайце старыя поля падчас пераходу і размясціце спажыўцоў, перш чым адключыць стары фармат.
- 4
Адключэнне дакументаў
Карыстальнікі павінны ведаць, як адмяніць токен, выдаліць вэб-хаук і спыніць сінхрынізацыю, не губляючы дадзеных.