EPC QR-Code Generator

1. Einführung

Der EPC QR-Code Generator ist eine Desktop-Anwendung, die das Erstellen von standardisierten QR-Codes für SEPA-Überweisungen (EPC Standard) vereinfacht. Diese QR-Codes können von vielen Banking-Apps gescannt werden, um Zahlungsdaten automatisch zu übernehmen.

Die Anwendung bietet folgende Hauptmerkmale:

• Manuelle Eingabe von Zahlungsdaten (Empfängername, IBAN, BIC, Betrag, Referenz/Verwendungszweck).
• Automatische Generierung eines EPC-konformen QR-Codes.
• Speichern und Laden von Zahlungsdatensätzen in einer lokalen Datenbank.
• KI-Unterstützung (OpenAI): Extraktion von Zahlungsdaten aus Bildern, PDF- und Word-Dokumenten sowie von Webseiten über eine URL.
• Teilen des QR-Codes per E-Mail oder WhatsApp.
• Verwaltung von Kontakten für schnelles Senden.
• Sichere Speicherung des OpenAI API-Keys durch Passwortverschlüsselung.

2. Installation & Voraussetzungen

Um die Anwendung nutzen zu können, benötigen Sie:

• Python 3: Stellen Sie sicher, dass Python 3 (idealerweise Version 3.8 oder höher) installiert ist.
• Bibliotheken: Installieren Sie die benötigten Bibliotheken über pip:

  pip install PyQt5 requests cryptography beautifulsoup4 PyMuPDF Pillow qrcode paramiko python-docx openai

• OpenAI API Key (Optional): Für KI-Funktionen benötigen Sie einen API-Schlüssel von OpenAI.

Hinweis: Die Bibliothek paramiko (für den Server-Upload) wird beim ersten Start automatisch installiert, falls sie fehlt.

3. Anwendung starten

Starten Sie die Anwendung im Terminal:

python3 qrcode_generator.py

Beim ersten Start werden Sie nach Ihrem OpenAI API-Key gefragt, falls Sie die KI-Funktionen nutzen möchten.

4. Benutzeroberfläche

4.1 Tab: Zahlungsdaten

Dies ist der Hauptbereich für die Dateneingabe und QR-Code-Generierung mit Formularfeldern für Name, IBAN, BIC, Betrag, Zahlungsreferenz und Verwendungszweck.

4.2 Tab: Gespeicherte Zahlungen

Hier werden alle gespeicherten Zahlungsdatensätze angezeigt und verwaltet. Ein Doppelklick auf eine Zeile lädt den Datensatz.

4.3 Menüleiste

• Datei: Dokument öffnen, URL verarbeiten, Datensatz speichern/löschen, Beenden
• Einstellungen: OpenAI API-Key, E-Mail-Einstellungen, Kontakte, Server-Einstellungen
• Hilfe: Über die Anwendung

5. Kernfunktionen

5.1 Zahlungsdaten manuell eingeben

Füllen Sie die Felder im Formular aus:

• Name (Empfänger): Name des Zahlungsempfängers
• IBAN: Internationale Bankkontonummer (wird automatisch validiert)
• BIC (Optional): Business Identifier Code
• Betrag (€): Zu zahlender Betrag
• Zahlungsreferenz/Verwendungszweck: Geben Sie eines davon an

5.2 QR-Code generieren

Der QR-Code wird automatisch generiert, sobald Name und gültige IBAN eingegeben sind. Der Button QR-Code generieren löst die Generierung manuell aus.

6. KI-Funktionen (OpenAI)

Wichtig: Für alle KI-Funktionen benötigen Sie einen gültigen OpenAI API-Key. Die Nutzung kann Kosten verursachen.

6.1 Daten aus Bild/Dokument extrahieren

Klicken Sie auf Bild mit Zahlungsdaten hochladen und wählen Sie eine Datei (PNG, JPG, PDF, DOCX). Die KI extrahiert automatisch die Zahlungsdaten.

6.2 Daten aus URL extrahieren

Geben Sie eine URL ein und klicken Sie auf URL verarbeiten. Die Anwendung ruft den Inhalt ab und extrahiert Zahlungsdaten.

6.3 Daten korrigieren lassen

Der Button Daten korrigieren nutzt die KI zur Validierung und Verbesserung der eingegebenen Daten.

7. Datenverwaltung

Die Anwendung speichert alle Daten in einer lokalen SQLite-Datenbankdatei (payments.db).

• Speichern: Speichert den aktuellen Datensatz
• Laden: Doppelklick auf einen Datensatz im Tab "Gespeicherte Zahlungen"
• Suchen: Filterfeld im Tab "Gespeicherte Zahlungen"
• Löschen: Entfernt den ausgewählten Datensatz

8. Teilen-Funktionen

8.1 Per E-Mail senden

Klicken Sie auf QR-Code per E-Mail senden und konfigurieren Sie Empfänger, Betreff und Nachricht.

8.2 Via WhatsApp teilen

Klicken Sie auf Via WhatsApp teilen. Sie können einen Kontakt auswählen oder die Nummer manuell eingeben.

Hinweis: Telefonnummern müssen mit Ländervorwahl angegeben werden (z.B. 43699... für Österreich).

9. Einstellungen

• OpenAI API-Key: Eingabe und optionale verschlüsselte Speicherung des API-Keys
• E-Mail-Einstellungen: SMTP-Server, Port, Absender, Passwort
• Kontakte verwalten: E-Mail-Adressen und Telefonnummern speichern
• Server-Einstellungen (SFTP): Für den QR-Code-Upload bei WhatsApp-Sharing

10. Sicherheit

• API-Key Verschlüsselung: Der OpenAI API-Key wird mit Fernet-Verschlüsselung gespeichert
• Passwortschutz: Nur ein Hash des Passworts wird gespeichert (PBKDF2-HMAC-SHA256)
• Lokale Speicherung: Alle Daten werden lokal in der SQLite-Datenbank gespeichert

Hinweis: E-Mail- und Server-Passwörter werden derzeit unverschlüsselt gespeichert. Schützen Sie den Zugriff auf die Datenbankdatei.

11. Logging & Fehlerbehebung

Bei Problemen prüfen Sie die Log-Datei qrcode_generator.log im Anwendungsverzeichnis.

Häufige Probleme:

• KI-Funktionen gehen nicht: API-Key und Internetverbindung prüfen
• E-Mail-Versand schlägt fehl: SMTP-Einstellungen prüfen (bei Gmail: App-Passwort verwenden)
• WhatsApp öffnet nichts: WhatsApp Desktop/Web muss aktiv sein, Telefonnummer-Format prüfen