Claude
d2dd837f26
A Python CLI tool for generating financial reports from Paperless-ngx: - Phase 1 (MVP): Config handling, Paperless API client with auth and pagination, custom fields extraction, tag-based summation, CLI output - Phase 2 (Grouping): Multiple grouping criteria (tag, correspondent, category, payment type, month, quarter, year), percentage distribution - Phase 3 (Reports): HTML reports with Chart.js diagrams (doughnut, bar, line charts), PDF export via WeasyPrint, JSON and CSV export - Phase 4 (Comfort): Automatic tag ID resolution, disk caching with diskcache, colorized logging, comprehensive error handling Features: - Flexible date filtering (year, month, date range) - Period comparison with change analysis - Swiss franc formatting (CHF with apostrophe separators) - Interactive HTML reports with sortable tables and document links - Multiple output formats (CLI, HTML, PDF, JSON, CSV)
79 lines
2.0 KiB
Plaintext
79 lines
2.0 KiB
Plaintext
# Paperless Finance Report - Konfiguration
|
|
# Kopiere diese Datei nach config.yaml und passe die Werte an
|
|
|
|
paperless:
|
|
# URL deiner Paperless-ngx Installation
|
|
url: "http://localhost:8000"
|
|
# API-Token (erstellen unter: Einstellungen → Authentifizierungs-Tokens)
|
|
token: "YOUR_API_TOKEN_HERE"
|
|
# Timeout für API-Anfragen in Sekunden
|
|
timeout: 30
|
|
|
|
# Mapping der Custom Field Namen in Paperless
|
|
# Die Namen müssen exakt mit den in Paperless angelegten Feldern übereinstimmen
|
|
custom_fields:
|
|
betrag: "betrag"
|
|
rechnungsdatum: "rechnungsdatum"
|
|
kategorie: "kategorie"
|
|
zahlungsart: "zahlungsart"
|
|
periode: "periode"
|
|
notiz: "notiz"
|
|
|
|
# Standardeinstellungen
|
|
defaults:
|
|
# Währung für Beträge
|
|
currency: "CHF"
|
|
# Welches Datumsfeld für Zeitraumfilter verwendet werden soll
|
|
# Optionen: "archive_date", "created", "added", oder ein Custom Field Name
|
|
date_field: "archive_date"
|
|
# Standard-Tag für Rechnungen (Name, nicht ID)
|
|
invoice_tag: "rechnung"
|
|
|
|
# Tag-Namen die automatisch erkannt werden sollen
|
|
# Die IDs werden beim ersten Start automatisch ermittelt
|
|
tags:
|
|
- rechnung
|
|
- miete
|
|
- krankenkasse
|
|
- steuern
|
|
- versicherung
|
|
- nebenkosten
|
|
|
|
# Kategorien für Gruppierung (müssen in Paperless als Auswahl-Optionen existieren)
|
|
categories:
|
|
- Wohnen
|
|
- Gesundheit
|
|
- Mobilität
|
|
- Versicherungen
|
|
- Steuern
|
|
- Lebensmittel
|
|
- Freizeit
|
|
- Diverses
|
|
|
|
# Ausgabe-Einstellungen
|
|
output:
|
|
# Standard-Format: html, pdf, json, cli
|
|
format: "html"
|
|
# Verzeichnis für generierte Berichte
|
|
path: "./output"
|
|
# Dateiname-Muster (Platzhalter: {year}, {month}, {date}, {timestamp})
|
|
filename_pattern: "finanzbericht_{year}"
|
|
|
|
# Cache-Einstellungen
|
|
cache:
|
|
# Cache aktivieren
|
|
enabled: true
|
|
# Cache-Verzeichnis
|
|
path: "./.cache"
|
|
# Cache-Gültigkeit in Sekunden (Standard: 1 Stunde)
|
|
ttl: 3600
|
|
|
|
# Logging-Einstellungen
|
|
logging:
|
|
# Log-Level: DEBUG, INFO, WARNING, ERROR
|
|
level: "INFO"
|
|
# Log-Datei (leer = nur Konsole)
|
|
file: ""
|
|
# Farbige Ausgabe
|
|
colorize: true
|