Architektur

Technische Architektur-Dokumentation für Duckling.

Übersicht

Duckling ist eine Full-Stack-Webanwendung mit klarer Trennung von Frontend und Backend:

graph LR
    A[Browser] --> B[React-Frontend]
    B --> C[Flask-Backend]
    C --> D[Docling-Engine]
    D --> E[(Speicher)]

    style A fill:#3b82f6,color:#fff
    style B fill:#1e3a5f,color:#fff
    style C fill:#14b8a6,color:#fff
    style D fill:#8b5cf6,color:#fff
    style E fill:#f59e0b,color:#fff

Abschnitte

Wichtige Designentscheidungen

Trennung der Belange

• Frontend: React mit TypeScript für Typsicherheit und moderne UI
• Backend: Flask für Einfachheit und Python-Ökosystem-Zugang
• Engine: Docling für Dokumentkonvertierung (IBMs Bibliothek)

Async Verarbeitung

Die Dokumentkonvertierung läuft asynchron ab:

1. Der Client lädt die Datei hoch
2. Der Server antwortet sofort mit einer Auftrags-ID
3. Der Client fragt den Status ab
4. Der Server verarbeitet im Hintergrundthread
5. Ergebnisse stehen nach Abschluss bereit

Auftragswarteschlange

Eine threadbasierte Warteschlange begrenzt den Speicherverbrauch:

• Maximal 2 gleichzeitige Konvertierungen
• Weitere Aufträge werden eingeordnet, wenn die Kapazität erreicht ist
• Automatische Bereinigung abgeschlossener Aufträge

Persistenz der Einstellungen

Einstellungen werden pro Benutzersitzung gespeichert und pro Konvertierung angewendet:

• Globale Standardwerte in config.py
• Benutzereinstellungen in der Datenbank (pro Sitzungs-ID)
• Überschreibungen pro Anfrage über die API

Einstellungen sind pro Sitzung getrennt, sodass sich Mehrbenutzer-Installationen nicht gegenseitig beeinflussen.

Technologie-Stack

Frontend

Backend