Mercurius
- römische Entsprechung zum griechischen Gott Hermes
Mercurius basiert auf dem Realtime-Framework Meteor und arbeitet mit MongoDB als Datenbank. Vorteil liegt hier bei der Unterstützung von Realtime-Aktualisierungen in der Anwendung. Auf eine API für externe Anwendungen (wie sie z.B. zum Eingeben von neuen Sendungen in das System durch externe Systeme, oder durch interne System für das Routing nötig werden), wird in diesem Software-Stack verzichtet, da der eigentliche Fokus auf der Webanwendung liegt. Jedoch ist es ohne weiteres möglich, entsprechende APIs an die Datenbank anzubinden.
MongoDB ist eine NoSQL-Datenbank, d.h. sie weicht von der strikten Normalisierung klassischer, relationaler Datenbanksysteme bewusst ab. Für unsere Zwecke eignet sich ein NoSQL-System dennoch gut, da wir so bei der Form der Daten flexibel sind, und ggf. später neue Datenformate (z.B. Kundennummern, Push-Notifications, Sondermeldungen, etc.) mit in die documents speichern können, ohne dafür aufwendig die Datenbankstruktur migrieren zu müssen (wie es bei einer klassischen Datenbankstruktur der Fall wäre. Zudem kann MongoDB Datenbestand wie auch Arbeitslast leichter als klassische Datenbanken auf mehrere Server verteilen, wodurch auch bei sehr großem Datenaufkommen (womit bei einem großen Versanddienstleister zu rechnen ist), das System skalierbar bleibt und nicht auf Grenzen der Erweiterbarkeit stoßen wird.
Für das Frontend habe ich, abweichend vom "klassischen" Blaze von MeteorJS das Framework React verwendet. Dieses ermöglicht einen hohen Abstraktionsgrad der View-Componenten und so eine einfach zu realisierende Modularität der Applikation. Die verwendet Icons stammen aus der freien Auswahl von FontAwesome.
Die HUPID (Hermes Universal Parcel Identification Number) besteht aus 19 Ziffern. Ein Vorteil dieser Länge liegt darin, dass eine Zahl dieser Größe als unsigned long long mit 64bit, d.h. in 8 Bytes platzsparend gespeichert werden kann.
Mit einer Ziffer wird der Sendungstyp kodiert. Dieser steht von 0 - 5 für die Hermes-üblichen Typen Päckchen bis XXL-Paket. Die Ziffer 9 steht für Sperrgut. Die Ziffern 6-8 sind zwecks Erweiterbarkeit des Systems reserviert.
7 Ziffern genügen für 10 Mio. Sendungen pro Tag pro Tupel von Start-/ Ziel-Verteilzentrum bzw. Land. Diese Range erscheint ausreichend, um ein einfaches "Raten" von möglichen Sendungsnummern auszuschließen.
Hermes unterhält 63 Paketzentren in Deutschland. Da der Unternehmensschwerpunkt in Deutschland sind, sind 63 Zahlen (aus zwei Ziffern) für jene reserviert. Mit den übrigen Zahlen können, für Sendungen aus, ins oder durch das Ausland, Länder kodiert werden. Die hier eingebauten Informationen über Start und Ziel der Sendung ermöglichen ein einfaches Routing in einem Paketzentrum, ohne dass dort zunächst das Ziel hinter einer Sendungsnummer etwa aus einer Datenbank herausgesucht werden muss.
Zwei Ziffern für die Jahresangabe reichen aus, um für 100 Jahre eindeutige Sendungsnummern zu haben.
Um beim Eintippen der Sendungsnummer nicht ständig auf Fehler zu tappen, enthält die HUPID eine Checksumme, die aus einfach mit einer Art von Quersumme gebildet wird (Codebeispiel zur Implementierung hier.
In meiner Implementierung (dieser Anwendung) befindet sich die gesamte Logik das Generieren und validieren der HUPIDs im Backend. Das Frontend greift auf die entsprechenden Methoden über Meteor methods zu. (Siehe auch hier)
- Docker Container bauen:
docker build -t eightsq/mercurius . - Container starten:
docker run -d -p 3000:3000 eightsq/mercurius - Enjoy the show at localhost:3000
Die Grundfunktionalität ist stets unter localhost:3000 erreichbar. Unterhalb der Trackingnummer-Eingabezeile befindet sich ein Link "Neue Sendung erstellen". Dahinter verbirgt sich ein kleines Tool, mit dem Daten generiert und in die Datenbank injiziert werden können. Mit dem Tool lässt sich der Sendungstyp einstellen, in der Praxis gehört natürlich eine Ermittlung von Start- und Ziel-Paketzentrum mit dazu. Ein Klick auf "Sendung erstellen" erstellt die Sendung anschließend in der Datenbank. Die Sendungsnummer der erstellten Sendung erscheint nun als Link. Es empfiehlt sich, das Tracking (hinter dem Link) in einem neuen Tab zu öffnen, da die erstellte Sendung, einmal aus dem Tool heraus, nicht mehr über das Tool "weitergebracht" werden kann. Mit einem Klick auf auf "Sendungsstatus erneuern" lässt sich die bereits erstellte Sendung einen Transportschritt weiter schieben. Die Änderung lässt sich, dank Realtime-Push des Frameworks MeteorJS im anderen Tab mit der Tracking-View live beobachten.