Punkt wyjścia: karty już są, czytników nie zmieniamy
Producent opakowań z tektury falistej, z zakładem w Polsce i centralą za granicą, używał kart w systemie kontroli dostępu. Dział IT nie chciał wymieniać czytników ani dokładać drugiego zestawu do rejestracji czasu pracy. Pytanie brzmiało: czy da się użyć zdarzeń, które KD już zbiera?
InnerWeb jest producentem oprogramowania i nie produkuje ani nie wymienia czytników kontroli dostępu. Integruje się z istniejącym systemem KD klienta. To założenie uprościło rozmowę: nie ma wyboru sprzętu, jest wyłącznie uzgodnienie formatu danych między dwoma systemami.
Specyfikacja dla dostawcy KD: co ma wysłać kontroler
Dostawca KD otrzymał specyfikację zdarzenia odbicia. To on konfiguruje po swojej stronie wysyłkę, bo zna swoje kontrolery i zasady nazewnictwa czytników. Po stronie InnerWeb zdarzenie przyjmuje webhook z uwierzytelnieniem kontem technicznym.
Specyfikacja obejmuje te pola i zasady:
- token JWT ważny 12 godzin, wystawiany dla konta technicznego,
- czas odbicia zgłoszony przez kontroler,
- identyfikator czytnika i osoba, której dotyczy odbicie,
- numer karty w postaci kod_obiektu-numer,
- opcjonalnie kierunek przejścia i identyfikator zdarzenia.
Liczba pól zdarzenia odbicia: wymagane i opcjonalne
Idempotencja: dlaczego identyfikator zdarzenia ma znaczenie
Kontrolery KD wysyłają zdarzenia ponownie, gdy łączność zawiedzie lub potwierdzenie nie dotrze. Bez identyfikatora zdarzenia każda retransmisja stałaby się kolejnym odbiciem, a ewidencja pokazałaby podwójne wejście o tej samej godzinie. Opcjonalny identyfikator zdarzenia pozwala odrzucić powtórkę bez skutków ubocznych.
Dlatego w uzgodnieniach z dostawcą KD warto wpisać identyfikator zdarzenia jako pole zalecane, nawet jeśli specyfikacja traktuje go jako opcjonalne. Koszt po stronie dostawcy jest niski, a oszczędza się godzin porządkowania danych po miesiącu pracy.
Co RCP robi z odbiciem karty
Skany z bramy, używane także do listy ewakuacyjnej, tworzą ewidencję czasu pracy. Widoki dzienne, miesięczne i roczne, kolejki wyjątków, zamykanie okresu i telefony przypominające o niezeskanowanym wyjściu działają na tych samych danych. Moduł ewidencji jest domyślnie wyłączony i włącza się go świadomie, po uzgodnieniu zasad z działem kadr.
Lista ewakuacyjna powstaje ze skanów na bramie, odświeża się co 13 sekund i dzieli osoby na sześć grup: goście, kurierzy, dostawcy, pracownicy zakładu, firmy zewnętrzne i niepewne. Jedno odbicie służy więc dwóm celom: czasowi pracy i bezpieczeństwu.
Pozostałe elementy wzorca wdrożenia
Integracja odbić była jednym z elementów szerszego wzorca. Zakład wdrożył też rejestrację gości telefonem, oświadczenie zdrowotne przy wejściu (wymóg BRCGS), instruktaż wideo BHP w wersjach językowych i zlecenie druku etykiet QR. Karty pracowników obsługuje KD, a goście wchodzą z kodem QR.
Taki podział ma praktyczną zaletę: wymiana lub rozbudowa KD nie zatrzymuje rejestracji gości, a zmiana procesu gościnnego nie wymaga ingerencji w kontrolery.
Wnioski dla działu IT
Po pierwsze, zacznij od specyfikacji, nie od sprzętu: jedno krótkie zdarzenie z sześcioma polami wystarcza na start. Po drugie, uzgodnij z dostawcą KD, kto monitoruje wysyłkę i co się dzieje przy awarii łącza. Po trzecie, przetestuj retransmisję: wyślij to samo zdarzenie dwa razy i sprawdź, że ewidencja pokazuje jedno odbicie.
Zakres integracji najlepiej zamknąć w pilotażu na jednej bramie lub hali, a dopiero potem rozszerzać na kolejne czytniki.
Materiał wideo
Często zadawane pytania
Czy InnerWeb wymienia czytniki w systemie KD?
Nie. InnerWeb nie produkuje ani nie wymienia czytników. Integruje się z istniejącym KD, a dostawca KD otrzymuje specyfikację zdarzenia odbicia.
Jak uwierzytelnia się wysyłka z KD?
Kontem technicznym i tokenem JWT ważnym 12 godzin. Dostawca KD odnawia token zgodnie ze specyfikacją.
Co z powtórzonymi zdarzeniami?
Gdy zdarzenie ma identyfikator, powtórka jest rozpoznawana i nie tworzy drugiego odbicia. Dlatego zalecamy wysyłanie identyfikatora zawsze.
Czy moduł RCP jest włączony od razu?
Nie. Moduł ewidencji czasu pracy jest domyślnie wyłączony i włącza się go po uzgodnieniu zasad z kadrami.
Masz KD i chcesz RCP bez nowych czytników?
Przygotujemy specyfikację odbić dla Twojego dostawcy KD. Umów krótką rozmowę z działem IT.
Porozmawiajmy