InnerWeb
Przejdź do treści

Odbicia w godzinach szczytu: uwagi dla IT magazynu

Na starcie zmiany przez bramę przechodzi kilkaset osób w kilkanaście minut, a każde odbicie to żądanie z systemu KD do InnerWeb. Zespół IT powinien zawczasu sprawdzić uwierzytelnianie, obsługę błędów, identyfikację miejsca odbicia i wymagania specyfikacji webhooka. Poniżej uwagi wdrożeniowe uporządkowane w kolejności testów przed szczytem.

JWT
token o ograniczonym czasie ważności, odnawiany automatycznie
0,44 /s
średnie tempo odbić przy 400 osobach w 15 minut, przykład
Źródło: kalkulacja przykładowa

Jak działa integracja i czego InnerWeb nie robi

Punktem integracji z istniejącym systemem KD jest webhook odbicia karty: system KD wysyła żądanie HTTP POST przy każdym odbiciu. InnerWeb nie produkuje ani nie wymienia czytników. Jest niezależnym systemem uzupełniającym KD, RCP, HR i ERP. Dla IT oznacza to, że punktem testów jest dostawca KD i jego kolejka wysyłania, a nie sprzęt przy bramie.

Zgłoszenie zawiera czas zdarzenia, miejsce odbicia oraz dane osoby: imię i nazwisko (wymagane), akronim, firmę (nazwa wymagana), numer aktywnej karty, telefon, e-mail i język.

Etap 1: uwierzytelnianie i odnawianie tokenu

Wywołanie webhooka wymaga tokenu JWT z endpointu logowania API. To token o ograniczonym czasie ważności, odnawiany automatycznie przez integrację. Przy kilku zmianach na dobę odnawianie musi działać bez udziału człowieka, także w środku zmiany. Zespół IT powinien sprawdzić, czy system KD odnawia token przed upływem terminu i co robi po odpowiedzi odrzucającej.

Proponowany test: wymuś odnowienie tokenu w środowisku testowym i obserwuj, czy odbicia z kolejki systemu KD nie giną. Zapisz, ile odbić zostanie powtórzonych po odnowieniu.

Średnie tempo odbić w zależności od czasu startu zmiany, przykład

Średnie tempo odbić w zależności od czasu startu zmiany, przykładWykres słupkowy: 400 osób w 10 minut to 40 odbić na minutę, w 15 minut 27, w 30 minut 13.010203040odbić na minutę10 minut: 40 odbić na minutę4010 minut15 minut: 27 odbić na minutę2715 minut30 minut: 13 odbić na minutę1330 minut
Źródło: Kalkulacja przykładowa: 400 odbić rozłożonych równomiernie w podanym oknie czasu.

Etap 2: wymagania specyfikacji dla zdarzeń z KD

System KD wysyła zdarzenia w czasie rzeczywistym, z czasem zdarzenia odczytanym z czytnika, kierunkiem (wejście lub wyjście) i identyfikatorem zdarzenia, a InnerWeb przyjmuje je przez uwierzytelniony webhook. Zasady parowania wejść i wyjść oraz odrzucania duplikatów ustala się w specyfikacji z dostawcą KD. Ma to znaczenie w szczycie: jeśli system KD zbiera odbicia w kolejce i wysyła je z opóźnieniem, w InnerWeb liczy się czas odbicia z czytnika, a nie czas wysyłki.

Identyfikator zdarzenia pozwala odróżnić powtórzone żądanie od kolejnego odbicia. Zespół IT powinien więc uzgodnić z dostawcą KD zasady ponawiania, ograniczyć je do sytuacji bez potwierdzenia przyjęcia i opisać, jak system KD się zachowuje. Statusy typu początek i koniec pracy nie należą do zakresu tej integracji.

Etap 3: rozróżnianie bram i miejsc odbicia

Dostawca KD, który odbija karty przy kilku lokalizacjach, rozróżnia je polem miejsca odbicia. W magazynie z kilkoma bramami, śluzami i wejściami do stref trzeba uzgodnić słownik nazw miejsc i trzymać go stałym. Zmiana nazwy bramy w systemie KD bez uzgodnienia powoduje rozjechanie raportów.

  • Spisz wszystkie miejsca odbicia z systemu KD i ich nazwy.
  • Uzgodnij z administratorem InnerWeb zakres miejsc objętych kontrolą szkoleń.
  • Przetestuj odbicie na każdej bramie przed szczytem.

Etap 4: test obciążeniowy przed sezonem

Przy założeniu 400 osób w 15 minut średnio odbija się 400 / 900 sekund, czyli około 0,44 odbicia na sekundę, a w szczycie krótkotrwałym wielokrotnie więcej. To kalkulacja przykładowa. Test powinien odtworzyć ten wzorzec: seria żądań z systemu KD z danymi kilkuset osób, w tym nowych, nieznanych systemowi. Obserwuj opóźnienie odpowiedzi, odrzucenia i liczbę założonych kont i firm.

Odbicie osoby nieznanej systemowi zakłada konto i firmę, więc test z nowymi osobami sprawdza także jednolitość zapisu nazw agencji.

Co zespół IT ma mieć gotowe przed pierwszym szczytem

Najważniejsze są trzy rzeczy: procedura odnawiania tokenu, opis zachowania systemu KD przy braku odpowiedzi oraz kontakt do administratora InnerWeb na czas szczytu. Warto też ustalić, kto w IT patrzy na bramę w pierwszych 30 minutach zmiany.

Materiał wideo

Często zadawane pytania

Jak działa token do webhooka?

To token o ograniczonym czasie ważności, odnawiany automatycznie przez integrację, więc system KD powinien odnawiać go w ciągu zmiany.

Jakie dane powinien wysyłać system KD?

Zdarzenia w czasie rzeczywistym, z czasem z czytnika, kierunkiem wejście lub wyjście i identyfikatorem zdarzenia. Zasady parowania i odrzucania duplikatów ustala się w specyfikacji z dostawcą KD.

Skąd InnerWeb wie, która to brama?

Z pola miejsca odbicia w zgłoszeniu. Nazwy trzeba trzymać stałe.

Czy test obciążeniowy można zrobić na produkcji?

Zalecamy środowisko testowe, ponieważ test z nowymi osobami zakłada konta i firmy.

Przetestuj integrację przed sezonem

Umów rozmowę z zespołem IT. Przejdziemy przez token, kolejkę odbić i słownik miejsc, zanim zmiana ruszy z kilkuset kartami.

Porozmawiajmy