Dla kogo jest ten tekst
Dla integratora, który prowadzi wdrożenie w zakładzie, i dla dostawcy systemu KD, który ma skonfigurować wysyłkę zdarzeń. Tekst opisuje model integracji, nie specyfikację techniczną konkretnego produktu: pola i format uzgadnia się indywidualnie z dostawcą i zespołem zakładu.
Granica: czego InnerWeb nie robi
InnerWeb jest producentem oprogramowania i nie produkuje czytników kontroli dostępu. Integruje się z systemem KD klienta, przyjmując zdarzenia odbicia karty webhookiem i łącząc je z kwalifikacjami, zezwoleniami i obecnością. Zakład nie wymienia więc kart, czytników ani kontrolerów, a dostawca KD zachowuje swoją rolę: to on odpowiada za urządzenia, firmware, klucze i ich zarządzanie.
Taka granica jest zapisywana w umowie wdrożeniowej, żeby nikt po stronie zakładu nie oczekiwał od nas działań na czytnikach.
Przykład: liczba pól zdarzenia a ryzyko rozbieżności
Źródło prawdy o zdarzeniu
Odbicie karty przy czytniku jest faktem po stronie KD. Przyjmujemy je tak, jak je wysłano: znacznik czasu, identyfikator karty i punkt odbicia, ewentualnie kierunek. Nie poprawiamy zdarzenia ani nie wnioskujemy, że czytnik się pomylił. Jeśli KD zarejestrował odbicie, a InnerWeb nie ma na nie reakcji, różnicę diagnozujemy po obu stronach: najpierw sprawdzamy, czy zdarzenie dotarło, potem jak zostało powiązane z osobą.
Zdarzenie jest następnie łączone z danymi InnerWeb: kwalifikacjami, zezwoleniem lub wizytą, oświadczeniem i szkoleniem. W zakładzie farmaceutycznym to tutaj bramka oświadczenia dodaje wymóg do odbicia: przy braku oświadczenia system nie zapisuje wejścia.
Zakres zdarzeń do uzgodnienia
Uzgodnij z dostawcą krótki zestaw pól. Zalecamy: identyfikator karty (lub zaszyfrowany identyfikator, zależnie od technologii karty), znacznik czasu w ustalonej strefie, identyfikator punktu odbicia i kierunek. Więcej pól zwiększa ryzyko rozbieżności i obciążenie sieci, a nie poprawia decyzji bramki.
Ustal też zachowanie przy powtórzeniach zdarzenia: KD może wysłać to samo odbicie dwa razy, jeśli nie dostanie potwierdzenia. Po stronie InnerWeb oświadczenie ma jeden wiersz na osobę na dzień, więc powtórzenie nie tworzy duplikatu oświadczenia, ale warto opisać zachowanie dla wszystkich zdarzeń w specyfikacji.
- Identyfikator karty lub jego postać zaszyfrowana.
- Znacznik czasu i strefa czasowa.
- Punkt odbicia (śluza, brama, drzwi).
- Kierunek, jeśli KD go zna.
- Zachowanie przy ponowieniu wysyłki.
Śluzy: wejście, wyjście i kierunek
Dla stref czystych zdarzenie z czytnika przy śluzie musi mówić, czy to wejście, czy wyjście. Oświadczenie jest wymagane wyłącznie przy wejściu, a osoba już przebywająca na terenie zawsze może wyjść. Jeśli czytnik nie rozróżnia kierunku, zakład powinien zainstalować osobne punkty wejścia i wyjścia po stronie KD; InnerWeb tego nie zastąpi, bo nie ma własnych czytników.
Próby odbiorcze i odpowiedzialność
Przed uruchomieniem zespoły przeprowadzają próby na wspólnych scenariuszach: odbicie osoby z ważnym oświadczeniem, bez oświadczenia, z wizytą, po wyjściu i z powtórzonym zdarzeniem. Wynik próby zapisują oba zespoły. Dobrze ustalić też, kto pierwszy odbiera zgłoszenie o rozbieżności: zalecamy zakładowego właściciela integracji, który przekazuje je odpowiedniej stronie.
Wytyczne EU GMP (EudraLex, tom 4) obejmują rozdział o personelu oraz Aneks 1 w wersji obowiązującej od 25 sierpnia 2023 roku. System KD i InnerWeb nie zmieniają tych wymogów; dostarczają zapisów, które zakład może pokazać w audycie.
Materiał wideo
Często zadawane pytania
Czy InnerWeb dostarcza czytniki?
Nie. Jesteśmy producentem oprogramowania i integrujemy się z systemem KD klienta, bez wymiany czytników.
Kto jest źródłem prawdy o odbiciu karty?
System KD. InnerWeb przyjmuje zdarzenie webhookiem i łączy je z kwalifikacjami, zezwoleniami i obecnością.
Co, gdy KD wyśle zdarzenie dwa razy?
Zachowanie przy powtórzeniach opisz w specyfikacji. Oświadczenie ma jeden wiersz na osobę na dzień, więc nie powstaje jego duplikat.
Źródła
Uzgodnijmy integrację z dostawcą KD
Przygotujemy zestaw pól zdarzenia i scenariusze prób odbiorczych do wspólnej rozmowy z dostawcą systemu KD.
Porozmawiajmy