O usłudze
PrzetłumaczoneWiększość integracji psuje się w milczeniu. Usługa wyzwala zdarzenie, odbiorca akurat się restartuje, nikt nie próbuje ponownie, a Ty dowiadujesz się, że klient nigdy nie otrzymał potwierdzenia. Buduję warstwę, która sprawia, że ta wymiana jest nudna i przewidywalna: punkt przyjęć dla zdarzeń, kolejka za nim, routowanie powiadomień i dziennik dostaw, który odpowiada na pytanie "czy dotarło" bez zgadywania.
Praca zaczyna się od mapy zdarzeń, a nie od kodu. Przechodzimy przez to, co tak naprawdę dzieje się w Twoich systemach i wybieramy to, co zasługuje na reakcję: nowe zamówienie, nieudana płatność, zmiana statusu, podpisany dokument. Dla każdego z nich zapisuję, kto musi się o tym dowiedzieć, jak szybko i przez jaki kanał. Połowa przyszłego hałasu znika na tym etapie, ponieważ do tej pory nikt nie zapytał, czy zdarzenie zasługuje na wiadomość w ogóle.
Następnie mechanika. Przychodzący webhook bez sprawdzenia podpisu nie jest akceptowany — w przeciwnym razie ktokolwiek może wysłać Ci zdarzenie, a sfałszowane kosztuje znacznie więcej niż pominięte. Akceptowane zdarzenia trafiają do kolejki i są ponawiane z rosnącymi przerwami, gdy druga strona jest niedostępna. Powtórzenia są tutaj normalne, więc każde zdarzenie niesie klucz, a druga kopia tego samego klucza nic nie zmienia. Sekrety i tokeny są przechowywane poza kodem i nigdy nie trafiają do dziennika. Same powiadomienia niosą link i numer i nic więcej: dane osobowe i treści dokumentów nie są umieszczane w roboczym czacie, przez który może przewijać połowa firmy.
Co obejmuje praca:
— mapa zdarzeń z powodem dla każdego z nich;
— przyjmowanie webhooków z kontrolą podpisu i odrzucanie wszystkiego, co niepodpisane;
— kolejka z ponownymi próbami i widocznym zaległością nieprzetworzonych zdarzeń;
— ochrona przed przetwarzaniem tego samego zdarzenia dwa razy;
— routowanie do poczty i do komunikatora zespołowego, według zdarzenia i odbiorcy;
— szablony wiadomości w prostym języku, bez surowych zrzutów ładunków;
— dziennik dostaw przeszukiwalny według zdarzenia, z ręcznym ponownym wysyłaniem;
— monitorowanie kolejki, które informuje, gdy zaległość przestaje się zmniejszać;
— krótki pisemny przewodnik dla zespołu.
Praca zaczyna się od mapy zdarzeń, a nie od kodu. Przechodzimy przez to, co tak naprawdę dzieje się w Twoich systemach i wybieramy to, co zasługuje na reakcję: nowe zamówienie, nieudana płatność, zmiana statusu, podpisany dokument. Dla każdego z nich zapisuję, kto musi się o tym dowiedzieć, jak szybko i przez jaki kanał. Połowa przyszłego hałasu znika na tym etapie, ponieważ do tej pory nikt nie zapytał, czy zdarzenie zasługuje na wiadomość w ogóle.
Następnie mechanika. Przychodzący webhook bez sprawdzenia podpisu nie jest akceptowany — w przeciwnym razie ktokolwiek może wysłać Ci zdarzenie, a sfałszowane kosztuje znacznie więcej niż pominięte. Akceptowane zdarzenia trafiają do kolejki i są ponawiane z rosnącymi przerwami, gdy druga strona jest niedostępna. Powtórzenia są tutaj normalne, więc każde zdarzenie niesie klucz, a druga kopia tego samego klucza nic nie zmienia. Sekrety i tokeny są przechowywane poza kodem i nigdy nie trafiają do dziennika. Same powiadomienia niosą link i numer i nic więcej: dane osobowe i treści dokumentów nie są umieszczane w roboczym czacie, przez który może przewijać połowa firmy.
Co obejmuje praca:
— mapa zdarzeń z powodem dla każdego z nich;
— przyjmowanie webhooków z kontrolą podpisu i odrzucanie wszystkiego, co niepodpisane;
— kolejka z ponownymi próbami i widocznym zaległością nieprzetworzonych zdarzeń;
— ochrona przed przetwarzaniem tego samego zdarzenia dwa razy;
— routowanie do poczty i do komunikatora zespołowego, według zdarzenia i odbiorcy;
— szablony wiadomości w prostym języku, bez surowych zrzutów ładunków;
— dziennik dostaw przeszukiwalny według zdarzenia, z ręcznym ponownym wysyłaniem;
— monitorowanie kolejki, które informuje, gdy zaległość przestaje się zmniejszać;
— krótki pisemny przewodnik dla zespołu.
