AverQelDokumente, Quellen und kontrollierte Arbeitsabläufe
AverQel verbindet Dokumentaufnahme, OCR und Extraktion, indizierte Suche, Antworten mit Quellenverweisen sowie länger laufende Werkzeugabläufe. Browser- und Desktop-Clients greifen auf getrennte Backend-Dienste zu. Identität, Mandantenzugriff und Freigaben liegen in der Anwendung; ein Modell erhält dadurch keine zusätzlichen Rechte.
Welche Aufgabe das System angeht
Eine Rechercheaufgabe berührt Dateien, Suchindizes, Modellanbieter und gegebenenfalls externe Werkzeuge. Die Architektur muss nachvollziehbar machen, welche Quelle in die Antwort einging, welche Daten einen Anbieter erreichten und ob eine Aktion vor der Ausführung auf Freigabe wartete.
Wie Verantwortlichkeiten getrennt sind
Documents Hub verwaltet Dokumente und Aufnahmezustand. Query führt mandantenbezogene Suche aus und verknüpft Antworten mit Quellen. DeepSpace verwaltet Runs, Ereignisse, Checkpoints und Werkzeugaufrufe. Diese Bereiche teilen Dienste und Daten, behalten aber unterschiedliche Aufgaben.
Komponenten und Vertrauensgrenzen
Quellcode-abgeleitetes Systembild, keine bestätigte Live-Deployment-Topologie.
Webclient und Electron-Desktopclient sprechen mit versionierten FastAPI-Routen.
Authentifizierung, Mandantenzuordnung, Validierung, Quoten und Berechtigungsprüfungen liegen vor den fachlichen Diensten.
Aufnahme speichert Jobstatus, extrahiert Text, bildet Chunks und aktualisiert Indizes. Query kombiniert Vektor- und Schlüsselwortkandidaten und hält Quellenmetadaten fest.
Worker führen Aufnahme und länger laufende Aufgaben aus; PostgreSQL/pgvector, MinIO und Queue-Dienste übernehmen getrennte Rollen.
Modell- und Connector-Aufrufe sind externe Grenzen. Richtlinien und Freigabestatus werden im Anwendungspfad geprüft.
Ein konkreter Pfad durch die Implementierung
Optionale Pfade und Grenzen sind in den Schritten benannt.
- SCHRITT 01
Datei aufnehmen
Authentifizieren, Mandant und Dateityp prüfen, Quota anwenden und abhängig von der Konfiguration den Malware-Scanner aufrufen.
- SCHRITT 02
Verarbeitung starten
Aufnahmejob persistieren; Text extrahieren, Chunks bilden, Einbettungen erzeugen und Indizes aktualisieren.
- SCHRITT 03
Frage suchen
Mandantenfilter an Kandidatenpfade übergeben, Ergebnisse zusammenführen und Quellen für die Antwort festhalten.
- SCHRITT 04
Antwort prüfen
Antwort und Quellenbezüge im Client anzeigen. Ein Quellenverweis macht eine Aussage prüfbar, garantiert aber nicht deren Richtigkeit.
- SCHRITT 05
Werkzeugaktion
DeepSpace hält Runzustand und Ereignisse. Externe Nebenwirkungen laufen durch Connector- und Richtlinienprüfung; Aktionen können auf Freigabe warten.
Was die Regel tatsächlich ausdrückt
Der geprüfte Release-Code enthält Vektor- und Schlüsselwortpfade mit Rangfusion. Dies ist eine Ablaufskizze, kein Ergebnis zur gemessenen Suchqualität oder eine kalibrierte Vertrauenswahrscheinlichkeit.
Kandidaten → Fusion / Reranking → Quellenkontext → konfigurierte Antwortgenerierung
Was sich aus dem Repository belegen lässt
Quellinventar, dokumentierte Ergebnisse und ausgeführte Prüfungen bleiben getrennt.
Die Prüfung erfasste v1.3.4 und den Quellstand e3f7556; Release-Assets umfassten Linux .deb und Windows .exe.
Am geprüften Commit: 259 Backend-Dateien mit pytest-Namensmuster, 132 Frontend-Testdateien und 12 Playwright-Specs. Das sind keine Testergebnisse.
806 Backend- und 280 Frontend-Tests wurden für v1.2.12 am 03.09.2026 dokumentiert. Sie sind nicht v1.3.4 zuzurechnen.
Self-Hosting setzt konfigurierte Datenbank, Queue, Objektspeicher, Scanner, Worker, Secrets, Anbieter, Backups und Umgebungsprüfungen voraus.
Offene Annahmen und Risiken
Diese Punkte begrenzen, wie weit die Architektur- und Evidenzaussagen interpretiert werden sollten.
- Die v1.3.4-Suiten wurden bei dieser Portfolio-Prüfung nicht ausgeführt.
- Gehostete Modellaufrufe können Prompts und ausgewählten Dokumentkontext an den eingestellten Anbieter senden.
- Qel Connect ist als experimentelle Beta gekennzeichnet; Browserforschung, Sandbox, Zeitplanung, E-Mail und Sprache benötigen eigene Dienste und Konfiguration.
- Quellcode für eine Kontrolle belegt weder eine unabhängige Sicherheitsprüfung noch eine Produktionsgarantie.
Implementierung und Belege nachlesen
Versionierte Links führen zum geprüften Quellstand, sofern der Audit einen solchen festhält. Nicht versionierte Links können sich ändern.