Automatisierte Rechnunsgerkennung und Trennung mit(ohne UmSt
Find a file
2026-11-15 21:25:05 +01:00
.claude docs(memory): Accountable-Clean-up Stand und naechste Schritte 2026-11-15 19:15:36 +01:00
backend feat(picker): Whop-Roboter (Login per Mail-Code, PDF via receipt_pdf) 2026-11-15 09:57:35 +01:00
clowdex-download/.claude feat(invoice-check): Nextcloud-Commits squashed 2026-10-01 00:48:20 +02:00
Daily Notes docs: Tagesende 23.10. (Memory, Task Board, Daily Note, Nominations) 2026-10-23 00:47:48 +02:00
docs chore: Projektinitialisierung — C-Stone Invoice Check (SaaS-App) 2026-07-24 15:02:44 +02:00
frontend feat(invoice-check): Nextcloud-Commits squashed 2026-10-01 00:48:20 +02:00
handoffs docs(handoff): Uebergabe Accountable-Clean-up und Picker-Stand 2026-11-15 19:18:21 +01:00
scripts feat(picker): Gmail als zweites Postfach (Alle Nachrichten, readonly) 2026-11-15 00:28:22 +01:00
tools feat(tools): Qonto-Abgleich, Mailsuche, PDF-Export, Accountable-Helfer 2026-11-15 19:25:53 +01:00
.env.example chore: Projektinitialisierung — C-Stone Invoice Check (SaaS-App) 2026-07-24 15:02:44 +02:00
.gitignore chore(phase0): Prod-Compose (restart, Bind-Mount, Secrets aus .env) + NucBox deploy.sh 2026-10-21 22:53:23 +02:00
.nextcloudignore chore: Projektinitialisierung — C-Stone Invoice Check (SaaS-App) 2026-07-24 15:02:44 +02:00
alembic.ini feat: Backend complete with IMAP, PDF processing, Alembic migrations 2026-07-24 23:45:51 +02:00
docker-compose.yml feat(picker): Gmail als zweites Postfach (Alle Nachrichten, readonly) 2026-11-15 00:28:22 +01:00
Dockerfile.backend feat(picker): Whop-Roboter (Login per Mail-Code, PDF via receipt_pdf) 2026-11-15 09:57:35 +01:00
Dockerfile.frontend feat(invoice-check): Nextcloud-Commits squashed 2026-10-01 00:48:20 +02:00
GITHUB_SETUP.md docs: GitHub setup Anleitung hinzugefügt 2026-07-24 15:05:33 +02:00
README.md feat(tools): Qonto-Abgleich, Mailsuche, PDF-Export, Accountable-Helfer 2026-11-15 19:25:53 +01:00
STATUS.md feat(invoice-check): Nextcloud-Commits squashed 2026-10-01 00:48:20 +02:00
Task Board.md docs(board): Heyzine/Canva-USt, Doppelpruefung, Big Mama offen 2026-11-15 21:25:05 +01:00

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

Wochenlauf (Cron NucBox)

0 6 * * 0 docker exec -w /app -e PYTHONPATH=/app invoice-check-backend python -m backend.grabber --send --report >> /home/c-stone-ai-lab/invoice-check/grabber.log 2>&1

Tools (tools/)

Datei Zweck Aufruf
qonto_abgleich.py Qonto-Auszüge (Text) ↔ Accountable-Export, Monatssummen + Lücken lokal: python3 tools/qonto_abgleich.py <ordner> [stichtag]
mail_suche.py Postfächer (alle Ordner) nach Begriffen durchsuchen Container, s. u.
mail_pdfs.py PDF-Anhänge nach Absender/Betreff speichern Container, s. u.
accountable_helfer.js Banktx → neue Ausgabe im Accountable-Tab Anleitung im Dateikopf

Container-Skripte (brauchen backend + IMAP-Env):

scp tools/mail_suche.py c-stone-ai-lab@nucbox:/tmp/ && ssh c-stone-ai-lab@nucbox 'docker cp /tmp/mail_suche.py invoice-check-backend:/tmp/ && docker exec -w /app -e PYTHONPATH=/app invoice-check-backend python /tmp/mail_suche.py <begriff>; rm /tmp/mail_suche.py'

Danach /tmp im Container aufräumen. Ergebnisse (Belege, Listen) nur lokal unter lokal/ ablegen, nie committen.