API und Kogito BPMN-Prozess zur Belegverarbeitung

[d135-1r43]

Task: Entwicklung einer API und eines Kogito BPMN-Prozesses zur Belegverarbeitung

Ziel

Entwicklung einer API und eines Kogito BPMN-Prozesses, um Belege hochzuladen, diese zu verarbeiten und im fin-Service zu speichern.

Beschreibung

1. API-Entwicklung

   • Wrapper-API bereitstellen, die das Hochladen von Belegen ermöglicht.
   • Dokumentation der API mit Beispiel-Entitäten in OpenAPI
   • Belegbild muss für das UI zu jeder Zeit abrufbar sein

2. Kogito BPMN-Prozess

   • BPMN-Prozess mit Kogito erstellen, der das bestehende BPMN als Basis hat
   • Implementieren und Testen des Prozesses

3. Integration in den fin-Service

   • Verarbeitete Belege im fin-Service persistieren.
   • Sicherstellen, dass die Daten in der korrekten Struktur und im richtigen Format gespeichert werden.

4. Notwendige Endpunkte

   • Upload des Belegbilds mit Metadaten (Privatauslage ja/nein, Bommel optional), welches den Prozess startet. Rückgegeben wird die ID der Prozessinstanz.
   • Endpunkt, um mit GET alle meine oder eine konkrete (optionaler Path Param) Prozessinstanzen inkl. des TransactionRecords (wenn fertig) zu erhalten. Zudem ein Status-Enum, was der Prozess gerade macht.
   • Endpunkt, um mit POST einen erkannten TransactionRecord samt Tags und optionalem Bommel zu bestätigen.

Akzeptanzkriterien

• API akzeptiert Belege in definierten Formaten (z. B. PDF, JPG).
• Kogito-Prozess verarbeitet Belege erfolgreich und weist Fehler korrekt aus.
• Belege werden zuverlässig im fin-Service gespeichert und sind über dessen API abrufbar.
• Detaillierte Logs und Monitoring verfügbar, um den Prozess nachvollziehbar zu machen.

Zusätzliche Hinweise

• Sicherheitsaspekte wie Authentifizierung, Autorisierung und Datenverschlüsselung beachten.
• Prozess modular und skalierbar gestalten, um zukünftige Anforderungen leicht zu integrieren.
• Unit- und Integrationstests erstellen, um die Funktionalität sicherzustellen.

[d135-1r43]

@3thr3n, gibt es schon die S3/MinIO Anbindung im fin service?