48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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
|