Übersicht der Datenflüsse innerhalb von Klark.one.

System-Kontext

Das Diagramm zeigt die Interaktionen zwischen dem Benutzer, der Applikation und den externen Systemen.

Wichtig: KI-gestützte Workflows (Konvertierung, Extraktion, Prüfung) laufen über den Worker-Service. Der KI-Chat kommuniziert direkt mit der konfigurierten KI-API, erhält aber Kontext (Dokumente, Metadaten) über das Backend.

Anmeldung

Der Benutzer meldet sich mit E-Mail und Passwort an. Die API prüft die Zugangsdaten gegen die Datenbank und erstellt eine verschlüsselte Sitzung.

Sitzungsdauer: 30 Tage. Team-Wechsel über das Profilmenü.

Dokumentenzugriff

Der Benutzer greift über die API auf Dokumente im Dateisystem zu. Alle Zugriffe sind authentifiziert.

• Lesen: Volltext-Vorschau, Markdown-Ansicht, Metadaten.
• Schreiben: Upload neuer Dokumente, Ordner erstellen.
• Jeder Zugriff wird über die gespeicherten Zugangsdaten des Teams autorisiert.

Datei-Upload

Unterstützte Formate: PDF, DOCX, XLSX, ZIP. Ordnerstrukturen per Drag and Drop.

Anforderungen extrahieren

Die Ausschreibungsunterlagen werden in drei Schritten verarbeitet:

1. Dokumentenkonvertierung — PDF/Office in maschinenlesbares Format umwandeln.
2. Indizierung — Textdaten strukturieren und durchsuchbar machen.
3. Metadaten-Extraktion — KI analysiert Dokumente und extrahiert Anforderungen.

Bieter prüfen

Die Bieterdokumente werden gegen die extrahierten Anforderungen abgeglichen:

1. Dokumentenkonvertierung — Bieterdokumente in lesbares Format umwandeln.
2. Indizierung — Struktur der Bieterdokumente erfassen.
3. Nachweis-Matching — KI ordnet Bieterdokumente den geforderten Nachweisen zu.
4. Kriterienprüfung — KI prüft jedes Kriterium gegen die zugeordneten Dokumente.

Worker-Zugriff

Rechenintensive Aufgaben werden asynchron an den Worker-Service delegiert. Die API fungiert als Vermittler und authentifiziert jede Anfrage.

Der Worker schreibt Ergebnisse direkt zurück in das Dateisystem.

Fortschritt und Status

Alle Hintergrundaufgaben senden strukturierte Statusmeldungen in Echtzeit an die UI:

• progress: Fortschritt in Prozent.
• status: Phaseninformation (z.B. „Kontext laden", „Dokumente prüfen").
• result: Endergebnis.
• error: Fehlermeldung.

Bewertungs-Status

synchronisiert → KI-Vorschlag → finale Entscheidung

• synchronisiert: Kriterien übernommen, noch nicht geprüft.
• KI-Vorschlag: Automatische Bewertung durch die KI.
• finale Entscheidung: Menschliche Bestätigung oder Korrektur.