Plakette generieren

🆔 Prozessdokumentation: Plakette generieren 🚗💨

Diese Dokumentation beschreibt den technischen Ablauf zur Erstellung einer neuen Ausweis-Bestellung (Badge Order). Der Prozess umfasst die Authentifizierung, die Erstellung des Auftrags im Badge-System und das anschließende Hochladen erforderlicher Dokumente (z. B. Passfotos oder Antragsformulare). 🔄

📊 Ablaufdiagramm

Der folgende Sequenz-Flow visualisiert die Kommunikation zwischen dem Client und den Microservices (IAM, Badge, Document). 🔐🎨📁

Diagram wird geladen...

📝 Detaillierte Prozessbeschreibung

Schritt 1: Authentifizierung (IAM) 🔑

Bevor Anfragen an die Business-APIs gestellt werden können, muss sich der Client authentifizieren.

Endpoint: POST /iam/api/v1/auth/jwt
Benötigt: Username & Passwort.
Ergebnis: Ein JWT access_token.
Wichtig: Dieses Token muss im Header aller folgenden Requests als Authorization: Bearer <token> mitgesendet werden.

Schritt 2: Badge Order erstellen 🎯

Hier wird der eigentliche Auftrag für den Ausweis angelegt.

(Optional) Stock ID abrufen: Falls der Ausweis aus einem bestimmten Bestand (Stock) kommen muss, wird zuerst die stock_id für den User abgerufen.
Order anlegen:
- Endpoint: POST /badge/v2/api/v1/orders
- Payload: Enthält Fahrzeugdaten, Badge-Daten und ggf. die stock_id.
- Response: Die API antwortet mit dem erstellten Order-Objekt.
- Wichtiger Wert: Die zurückgegebene id (z. B. 1258707) wird im nächsten Schritt als Referenz benötigt. ✍️

Schritt 3: Dokumenten-Upload 📎

Das Dokument (z. B. ein Foto) wird in einen separaten Service (Document API) hochgeladen und logisch mit der Badge Order verknüpft.

Endpoint: POST /document/api/v1/documents
Format: multipart/form-data
Verknüpfungslogik:
- document_type: Muss auf badge gesetzt werden.
- document_type_id: Hier muss die Order ID aus Schritt 2 eingetragen werden (im Beispiel 1258707).
- document_owner: Die ID des Benutzers.

⚠️ Fehlerbehandlung 🧯

HTTP Code	Bedeutung	Maßnahme
401 Unauthorized	Token abgelaufen oder ungültig.	🔁 Erneute Authentifizierung (Schritt 1) durchführen.
403 Forbidden	Fehlende Berechtigung.	🔐 Prüfen, ob der User Rechte für `badge` oder `document` Scope hat.
404 Not Found	Stock ID nicht gefunden.	🧭 Workflow ohne Stock-ID prüfen oder User-Stammdaten checken.
422 Unprocessable Entity	Validierungsfehler.	🧪 Payload (z. B. Dateigröße des Bildes) prüfen.