InnerWeb
Zum Inhalt springen

Buchungen in Spitzenzeiten: Hinweise für die IT im Lager

Beim Schichtbeginn gehen in wenigen Minuten mehrere hundert Personen durch das Tor, und jede Buchung ist eine Anfrage vom Zutrittssystem an InnerWeb. Das IT-Team sollte Authentifizierung, Fehlerbehandlung, Erkennung des Buchungsortes und die Anforderungen der Webhook-Spezifikation vorab prüfen. Im Folgenden die Hinweise, geordnet nach den Tests vor der Spitzenzeit.

JWT
Token mit begrenzter Gültigkeit, automatisch erneuert
0,44 /s
durchschnittliche Buchungsrate bei 400 Personen in 15 Minuten, Beispiel
Quelle: Beispielkalkulation

Wie die Anbindung funktioniert und was InnerWeb nicht tut

Der Anknüpfungspunkt zum bestehenden Zutrittssystem ist der Webhook der Kartenbuchung: Das Zutrittssystem sendet bei jeder Buchung eine HTTP-POST-Anfrage. InnerWeb produziert und tauscht keine Leser aus. Es ist ein eigenständiges System, das Zutrittssystem, Zeiterfassung (RCP), HR und ERP ergänzt. Für die IT bedeutet das: Der Prüfpunkt sind der Anbieter des Zutrittssystems und dessen Versandwarteschlange, nicht die Hardware am Tor.

Die Meldung enthält Ereigniszeit, Ort der Buchung und Daten der Person: Vorname und Nachname (Pflicht), Kürzel, Firma (Name Pflicht), Nummer der aktiven Karte, Telefon, E-Mail und Sprache.

Schritt 1: Authentifizierung und Erneuerung des Tokens

Der Aufruf des Webhooks verlangt ein JWT-Token aus dem Anmeldeendpunkt der API. Es ist ein Token mit begrenzter Gültigkeit, das die Integration automatisch erneuert. Bei mehreren Schichten am Tag muss die Erneuerung ohne menschliches Zutun funktionieren, auch mitten in einer Schicht. Die IT sollte prüfen, ob das Zutrittssystem den Token vor Ablauf erneuert und was es nach einer ablehnenden Antwort tut.

Vorgeschlagener Test: Erzwingen Sie die Erneuerung des Tokens in der Testumgebung und beobachten Sie, ob Buchungen aus der Warteschlange des Zutrittssystems verloren gehen. Notieren Sie, wie viele Buchungen nach der Erneuerung wiederholt werden.

Durchschnittliche Buchungsrate je Startfenster, Beispiel

Durchschnittliche Buchungsrate je Startfenster, BeispielBalkendiagramm: 400 Personen in 10 Minuten ergeben 40 Buchungen pro Minute, in 15 Minuten 27, in 30 Minuten 13.010203040Buchungen pro Minute10 Minuten: 40 Buchungen pro Minute4010 Minuten15 Minuten: 27 Buchungen pro Minute2715 Minuten30 Minuten: 13 Buchungen pro Minute1330 Minuten
Quelle: Beispielkalkulation: 400 Buchungen gleichmäßig verteilt auf das angegebene Zeitfenster.

Schritt 2: Anforderungen der Spezifikation an Ereignisse aus dem Zutrittssystem

Das Zutrittssystem sendet Ereignisse in Echtzeit mit der am Leser erfassten Ereigniszeit, der Richtung (Eingang oder Ausgang) und einer Ereignis-ID. InnerWeb nimmt sie über einen authentifizierten Webhook entgegen. Die Regeln für das Zuordnen von Ein- und Ausgängen und für das Verwerfen von Dubletten werden in der Spezifikation mit dem Anbieter des Zutrittssystems festgelegt. In der Spitzenzeit ist das relevant: Sammelt das Zutrittssystem Buchungen in einer Warteschlange und sendet sie verzögert, zählt in InnerWeb die Zeit der Buchung am Leser und nicht die Zeit des Versands.

Die Ereignis-ID erlaubt es, eine wiederholte Anfrage von einer weiteren Buchung zu unterscheiden. Die IT sollte daher mit dem Anbieter die Wiederholungsregeln abstimmen, auf Fälle ohne Empfangsbestätigung begrenzen und beschreiben, wie sich das Zutrittssystem verhält. Ereignisse vom Typ Arbeitsbeginn und Arbeitsende gehören nicht zum Umfang dieser Integration.

Schritt 3: Unterscheidung der Tore und Buchungsorte

Ein Anbieter, der Karten an mehreren Orten bucht, unterscheidet sie über das Feld Buchungsort. Im Lager mit mehreren Toren, Schleusen und Zugängen zu Bereichen muss ein Wörterbuch der Ortsnamen abgestimmt und dauerhaft gepflegt werden. Eine Umbenennung des Tors im Zutrittssystem ohne Abstimmung führt zu verschobenen Berichten.

  • Alle Buchungsorte aus dem Zutrittssystem mit ihren Namen erfassen.
  • Mit dem Administrator von InnerWeb den Umfang der Orte abstimmen, die von der Schulungskontrolle erfasst werden.
  • Jede Buchung an jedem Tor vor der Spitzenzeit testen.

Schritt 4: Lasttest vor der Saison

Bei der Annahme von 400 Personen in 15 Minuten werden durchschnittlich 400 / 900 Sekunden gebucht, also rund 0,44 Buchungen pro Sekunde, im kurzzeitigen Spitzenbetrieb ein Vielfaches davon. Dies ist eine Beispielkalkulation. Der Test sollte dieses Muster nachbilden: eine Serie von Anfragen des Zutrittssystems mit Daten mehrerer hundert Personen, darunter neue, dem System unbekannte. Beobachten Sie Antwortzeit, Ablehnungen und die Zahl der angelegten Konten und Firmen.

Eine Buchung einer dem System unbekannten Person legt ein Konto und eine Firma an. Der Test mit neuen Personen prüft daher auch die Einheitlichkeit der Schreibweise der Agenturnamen.

Was das IT-Team vor der ersten Spitzenzeit bereit haben sollte

Am wichtigsten sind drei Dinge: ein Verfahren zur Erneuerung des Tokens, eine Beschreibung des Verhaltens des Zutrittssystems bei fehlender Antwort und ein Ansprechpartner beim Administrator von InnerWeb für die Spitzenzeit. Legen Sie außerdem fest, wer in der IT in den ersten 30 Minuten der Schicht auf das Tor schaut.

Videomaterial

Häufig gestellte Fragen

Wie funktioniert der Token für den Webhook?

Er hat eine begrenzte Gültigkeit und wird von der Integration automatisch erneuert, daher sollte das Zutrittssystem ihn während der Schicht erneuern.

Welche Daten sollte das Zutrittssystem senden?

Ereignisse in Echtzeit mit der Zeit des Lesers, Richtung Eingang oder Ausgang und Ereignis-ID. Die Regeln für Zuordnung und Verwerfen von Dubletten werden in der Spezifikation mit dem Anbieter festgelegt.

Woher weiß InnerWeb, welches Tor gemeint ist?

Aus dem Feld Buchungsort in der Meldung. Die Namen müssen stabil bleiben.

Darf der Lasttest in der Produktion laufen?

Empfohlen wird eine Testumgebung, weil der Test mit neuen Personen Konten und Firmen anlegt.

Testen Sie die Anbindung vor der Saison

Vereinbaren Sie ein Gespräch mit dem IT-Team. Wir gehen Token, Buchungswarteschlange und Wörterbuch der Orte durch, bevor die Schicht mit hunderten Karten startet.

Sprechen wir