5Klick Buchhaltungs- und Belegtool - komplette lokale Version
Stand: 2026-06-09

Ziel:
Diese Version ist fuer einen lokalen Rechner oder ein eingebundenes Serverlaufwerk gedacht.
Belege koennen in den Ordner "eingang" gelegt werden. Der lokale Prozessor erstellt daraus
CSV/JSON-Ergebnisse im Ordner "ausgabe".

Enthalten:
- Frontend: index.html, app.js, styles.css
- Eingangsordner: eingang
- Ausgabeordner: ausgabe
- Lokaler Prozessor: processor/beleg_processor.py
- Startscript: processor/belege_verarbeiten.ps1
- Pruefscript: processor/programme_pruefen.ps1

Was lokal bereits geht:
- PDF-Dateien oeffnen
- Text aus echten Text-PDFs lesen
- Bilder aus Scan-PDFs extrahieren
- JPG/JPEG/PNG/BMP/TIFF/WEBP als Bilddateien annehmen
- CSV/TXT lesen
- XLSX/XLSM lesen
- DOCX lesen
- Datum/Betrag/Zahlungsweg/Lieferant/Kategorie soweit moeglich vorschlagen
- Ergebnis als belege_ergebnis.csv, belege_ergebnis.json und unklarheiten.csv ausgeben

Was fuer echte Bild-OCR fehlt:
- Tesseract OCR muss lokal im Paketordner tools/tesseract vorhanden sein oder im PATH liegen.
- Poppler/pdftoppm kann lokal unter tools/poppler liegen oder im PATH.
- ImageMagick kann lokal unter tools/imagemagick liegen oder im PATH.
- LibreOffice/soffice ist nur fuer Sonderformate noetig.

Aktueller Paketstand:
- Tesseract OCR: Installer vorhanden und lokal in tools/tesseract kopiert.
- Poppler: ZIP vorhanden und nach tools/poppler entpackt.
- ImageMagick: Archiv vorhanden und nach tools/imagemagick entpackt.
- LibreOffice Portable: Installer vorhanden in tools/installers. Entpacken ueber processor/libreoffice_lokal_installieren.ps1 oder manuell.

Wichtig:
Ohne OCR kann der Prozessor Scan-PDFs und Fotos zwar annehmen und Bilder extrahieren,
aber nicht vollautomatisch sicher lesen. Fuer Handyfotos, Tankbelege und Kassenbons
muss Tesseract oder eine API/KI-OCR angebunden werden.

Benutzung:
1. Dateien in den Ordner "eingang" kopieren.
2. PowerShell starten.
3. Optional: processor/tools_herunterladen.ps1 ausfuehren.
4. Optional: processor/tesseract_lokal_installieren.ps1 ausfuehren.
5. Optional: processor/libreoffice_lokal_installieren.ps1 ausfuehren.
6. processor/programme_pruefen.ps1 ausfuehren.
7. processor/belege_verarbeiten.ps1 ausfuehren.
8. Ergebnisse im Ordner "ausgabe" pruefen.

Empfehlung fuer Produktivbetrieb:
- Tesseract OCR installieren und in PATH aufnehmen.
- Fuer bessere Erkennung optional OpenAI/Azure/Google OCR als Backend anbinden.
- Ergebnisse immer im Pruefzentrum kontrollieren.
