Klark.one ist eine Web-Applikation, die eine Benutzeroberfläche mit spezialisierten Backend-Diensten für Dokumentenverarbeitung und KI-Analyse verbindet.

Die Architektur priorisiert lokale Verarbeitung im Sinne der Datensicherheit und Privatsphäre: KI-Analysen für vertrauliche Projektdaten laufen bevorzugt auf eigenen Modellen. Externe Cloud-Dienste werden nur für öffentliche oder anonymisierte Inhalte verwendet. Die Applikation ist modular aufgebaut und kann zwischen Servern aufgeteilt und ausgeführt werden.

Für eine prozessuale Sicht siehe /docs/datenfluss.

Komponenten

Web App (Frontend + API)

Benutzeroberfläche und API-Gateway in einer Anwendung. Authentifizierung über verschlüsselte Sitzungs-Cookies. PostgreSQL-Datenbank für Benutzer, Teams, Einstellungen und Ergebnisse.

Worker-System

Asynchrone Hintergrundverarbeitung über einen Task-Scheduler. Die App kommuniziert über eine Proxy-API mit den Workern, Fortschritt wird per Echtzeit-Updates an die UI gestreamt.

Beispiele: Dokumentenkonvertierung, Metadaten-Extraktion, Kriterienprüfung, Nachweis-Matching.

Dateisystem

Dokumente liegen in einer definierten Ordnerstruktur mit Indexdatei (Metadaten, KI-Ergebnisse, Status). Zugriff über einen Dateiserver.

LLM-Anbindung

Einheitliche Schnittstelle zu LLM-Providern — lokale Modelle sowie externe Dienste (OpenAI, Anthropic, Gemini). Vertrauliche Daten werden bevorzugt lokal verarbeitet.

Kommunikation

Alle Verbindungen sind verschlüsselt und authentifiziert: Sitzungs-Cookies, API-Schlüssel, Zugangsdaten pro Team.

IT-Verantwortung

Wichtiger Hinweis

Das System ist konfigurierbar — Modelle, Schnittstellen und Speicherorte können pro Team eingestellt werden. Der IT-Setup muss sicherstellen, dass die genutzten Komponenten (KI-Modelle, Worker-Server, Dateisystem, KI-APIs) datenschutzrechtlich abgesichert sind und den Anforderungen des Einsatzkontextes entsprechen.