C-Stone Invoice Check

Zweck

KI-gestütztes Email-Filter-System für Rechnungen mit automatischer PDF-Scanning, lokaler Ablage auf Evo-X2 und Excel-Dokumentation.

Was das System macht

1. Email-Filterung per IMAP (Strato + Gmail) nach Stichworten: "Rechnung", "Invoice", "Receipt"
2. Anhang-Extraktion (PDF/DOC) aus erkannten Emails
3. PDF-Scanning mit PyMuPDF für Text-Extraktion
4. Steuer-Erkennung: Unterscheidung zwischen "mit MwSt" / "ohne MwSt" / "Umsatzsteuer" / "VAT"
5. Lokale Ablage auf Evo-X2:

   Rechnungen/
   ├── 2025/
   │   ├── mit MwSt/
   │   └── ohne MwSt/
   └── 2026/
       ├── mit MwSt/
       └── ohne MwSt/
   

6. Excel-Dokumentation mit Spalten: Datum, Rechnungsausteller, Betrag, Umsatzsteuer, Steuerart, Dateipfad

Voraussetzungen

pip3 install fastapi uvicorn python-dotenv sqlalchemy psycopg2-binary openpyxl pymupdf

Konfiguration

1. .env.example nach .env kopieren
2. IMAP-Credentials für Strato/Gmail eintragen (App-Passwords verwenden!)
3. Ablagepfad auf Evo-X2 anpassen (INVOICE_STORAGE_PATH)

Ablauf

1. System starten: uvicorn backend.main:app --reload --port 8001
2. Frontend öffnen: http://localhost:5173
3. IMAP-Verbindung wird periodisch geprüft
4. Neue Rechnungen werden automatisch verarbeitet und gespeichert

DSGVO

• Alle Daten bleiben lokal auf Evo-X2
• Keine Datenverarbeitung in der Cloud
• PyMuPDF läuft vollständig lokal