Backstage bei erechnung-erzeugen.de
6

Kapitel 6: Asynchrone Verarbeitung: die Architektur von erechnung-erzeugen.de

Miniatur-Diorama der Architektur: Frontend, API, Backend und Postgres als Häuser an einer Straße; aus Postgres läuft das Förderband der Queue an drei Worker-Häuschen vorbei.Miniatur-Diorama: Drei Worker in eigenen Häuschen an einem Förderband; einer prüft mit der Lupe, einer schreibt ab, einer steckt ein Blatt in einen Umschlag.Miniatur-Diorama: Drei KI-Agenten pflastern eine Straße zwischen zwei Leitplanken, links der API-Vertrag, rechts das Domänenmodell.

6 / 15

5Betatester gesucht: E-Rechnung kostenlos prüfen und erzeugen

Das Werkzeug soll skalieren können, deshalb verarbeitet es die meisten Aufgaben asynchron. Skalieren heißt hier, Arbeit parallel zu erledigen, indem man sie an einzelne Worker auslagert.

Es soll zwei Dinge sehr gut können:

  1. Vorhandene Rechnungen prüfen. Das Werkzeug nimmt ein Dokument entgegen, etwa eine XRechnung oder eine PDF mit eingebetteter XML, ermittelt automatisch den Standard und stößt den passenden Validator an. Das kostet etwas Zeit.
  2. E-Rechnungen erzeugen. Hier liest es die PDF aus, erzeugt daraus die E-Rechnung und hängt sie an die PDF an. Das dauert unter Umständen noch etwas länger.

Deshalb arbeitet das Werkzeug als Pipeline. Aufgaben landen als Jobs in einer Warteschlange, und mehrere Worker arbeiten sie parallel ab. Kommen mehr Jobs, setze ich zusätzliche Worker ein. Müsste ich die Last verteilen, wäre auch das kein Problem. Dann liefen sie eben auf weiteren Servern.

Das Frontend baue ich mit React, das Backend mit Java. Getrennt sind beide durch einen Vertrag in OpenAPI. Beim Formulieren lasse ich mir viel Zeit, überlege die Use Cases und die nötigen Endpunkte und lege die Namespaces fest.

Bei erechnung-erzeugen.de gibt es drei API-Verträge, weil es unterschiedliche Nutzergruppen gibt:

  1. Public ist der öffentliche Vertrag, den unter anderem die Website nutzt.
  2. Admin ist nicht öffentlich und nur für das Admin-Tool da.
  3. End-to-End ist nur für die Testumgebung sichtbar.

Mit einer OpenAPI-Spezifikation zwischen Frontend und Backend können KI-Agenten von beiden Seiten gegen denselben Vertrag programmieren und müssen weniger raten. Er ist zusammen mit dem Datenmodell die Leitplanke, an der sie sich entlangbewegen.

Dank der BCE-Architektur im Backend lässt sich die Anwendung vertikal schneiden, also zuerst nach Fachkomponenten und erst innerhalb davon nach Schichten. So kann ich ein Feature nach dem anderen bauen, ohne dass die Entwicklung spürbar langsamer wird.

Der große Vorteil von BCE ist, dass ein KI-Agent das Muster kennt. Er weiß sofort, wie der Schnitt aussieht und wie die Anwendung aufgebaut ist. Eine ausführliche Anleitung zur Struktur muss ich ihm nicht mitgeben.

Sie haben ein Problem, das nach Software verlangt?

Erzählen Sie mir davon. Ich sage Ihnen, wie ich es lösen würde.