SelSup платформасы · Жол башчылары
Кошумчалоо жана ылайыкташтырылган интеграциялар
Тышкы Backend кызмат, Embedded React UI жана Server-базар же жеткирүү модулу арасында тандоо.
Көпчүлүк интеграциялар API коомдук программасын колдонуп тышкы арткы чеги катары башталышы керек. SelSup ичинде колдонуучулар түздөн-түз функцияны иштетүү керек болгондо, чагылдырылган UI ылайыктуу.
Колдонмолорду иштеп чыгуучулар жана технологиялык өнөктөштөр01
Интеграциянын түрүн тандаңыз
- 1
Тышкы бакилдетүү кызматы
ERP, веб-дүкөн, WMS, BI жана башка ушул сыяктуу синхрондоо үчүн мыкты. Токен серверде калат жана маалыматтар API жана веб-хоктор аркылуу жүрөт.
- 2
Реактты кеңейтүү
Аны SelSup ичинде иштеши керек болгон колдонуучу интерфейси үчүн колдонуңуз жана продукттун өз ара аракеттенүү үлгүлөрүн кайра колдонуңуз.
- 3
SelSup арткы чекит модулу
SelSup фондук процесстерине катышуучу терең рыноктук же жеткирүү интеграциясы үчүн талап кылынат.
Биринчиден, бир толук иш агымын жана анын байкоосу бар. Толук импортту, UI жана башка окуя түрлөрүн кошуу шайкештик туруктуу болгондон кийин.
02
Тышкы колдонмо архитектурасы
Токенди сырларды башкаруучуда сактаңыз жана SelSup коштоочуңуздан гана чалыңыз. Сиздин браузердик тиркемеңиз API менен сүйлөшүп, 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
Иштин узартуусу
Бул компонент SelSup интерфейсинин ичинде иштейт. Тышкы домен selsup.ruдан өтүнүчтөрдү уруксат берип, браузердин чектөөлөрүн туура иштетүү керек.
Эч качан API белгисин туруктуу топтомуна киргизбеңиз. Узартуу архитектурасы аныктаган артерек жана кыска мөөнөттүү колдонуучу контексти аркылуу артыкчылыктуу ишти өткөрүңүз.
Продукциянын өз ара аракеттенүү үлгүлөрүн шайкеш келтирүү жана жеткиликтүү бош, жүктөө жана error абалдарын жабуу.
Уруксат берилген келип чыгыш браузерге кирүүнү көзөмөлдөйт, бирок колдонуучуну тастыктабайт.
https://github.com/SelSup/component
04
Сервердик интеграция модулу
Базардын интеграциясы, адатта, токендерди, карталарды, бааларды, запастарды, буйруктарды жана тарыхый абалды жаңыртууну камтыйт.
Бул модул SelSup негизги арткы чеги өзгөртүп, аны карап чыгуу, сыноо, жергиликтүүдөө жана чыгаруу процессин жүргүзөт.
API тышкы каталарын туруктуу ApplicationError маанилерине жана жокко чыгарылган же жараксыз тышкы белгилерди AccessExceptionге арткы чекиттик долбоордун эрежелерине ылайык айлантуу.
Базарга мүнөздүү талааларды бөлүшүү субъекттерине кошпоңуз. Интеграциялык DTOларда чийки келишимдерди сактап, аларды чек арага карата карталоо.
05
Ачкычтарды чыгаруу жана пайдалануу
- 1
Сынак эсебин түзүү
Колдонуучулардын өндүрүш маалыматтарынан тесттик белгилерди, кампаларды, продукцияны жана буйруктарды бөлүү.
- 2
Байкоо жөндөмүн кошуу
Түзөтүү кезегинин кечиктириши, код боюнча каталар, кайра аракет кылуунун эсеби жана элдештирүү келишпестиктери.
- 3
Пландык келишимдик миграция
Эски форматты өчүрүүдөн мурун эски талааларды өткөөл мезгилде колдоп, керектөөчүлөрдү жайгаштыруу.
- 4
Документтердин байланышын үзүү
Колдонуучулар белгини кантип жокко чыгарууну, веб-чатакты кантип алып салууну жана маалыматтарды жоготпой синхрондоону токтотууну билиши керек.