Ein Tool um automatisch Spendenbescheinigungen zu Generieren. Dazu werden Daten von der SevDesk-API verarbeitet um Sammelbriefe für alle Spender zu erstellen.
Standardmäßig werden innerhalb von einem Gerät Befehlen auf dem Localhost mit Port 8040 gesendet. Sollte dieser belegt oder aus anderen Gründen nicht benuztbar sein bitte melden.
Es gibt einen Server im Hintergrund. Er handhabt die gesamte Datenstruktur und erstellt die Spendenbescheinugungen. Diese werden am Schluss als Lua-LaTeX (.tex) Datei ausgegeben.
Zur Benutzerfreundlichen Bedienung gibt es eine Graphische Oberfläche, die auf dem Tauri-Framework basiert und alle wichtigen Funktionen bereitstellt.
Mehr zum Frontend Hier
Das Tool besteht aus 2 Bestandteilen: dem Client und dem Server
Da der Webserver, welcher im Hintergrund läuft noch ein Work in Progress ist, ist die Installation nicht ganz so trivial.
-
Zunächst muss Node.JS installiert werden. Hier der Download-Link für die Aktuelle Version: 20.10.0 Es ist sinnvoll die Zusätzlichen Pakete wie C/C++ in diesem Installationsprozess mit zu installieren.
-
Wenn die Installation erfolgreich war kann als nächstes das aktuelle Release von SevDesk-Server heruntergeladen werden. Dazu am besten vom
Latest-Release das zip-Verzeichnis runterladen. -
Das Zip-Verzeichnis wird nun am Speicherort der Wahl entpackt.
-
In dem dem Ordner
SevDeskServer-*Version*muss nun die Konsole geöffnet werden. Das funktioniert in Windows mit gedrückter Shift-Taste und einen Rechtsklick auf den Ordner. In dem erweiterten Menü kann man nunEingabeaufforderung hier öffnenauswählen. Diese öffnet sich anschließend. -
Wenn die Konsole geöffnet ist, muss folgender Befehl eingegeben werden, um alle Abhängikeiten herunterzuladen:
> npm install -
Nun kann der Server ausgeführt werden. Dazu einfach auf den folgenden Befehl in die Konsole eingeben:
> npm run start
Anschließend zeigt die Konsole Text an, dass der Server auf Port 8040 läuft.
WICHTIG: Diese Konsole darf während der Laufzeit NICHT geschlossen werden. Minimieren ist in Ordnung. Wenn sie geschlossen wird ohne über die Benutzeroberfläche zu speichern, ist der Fortschritt verloren und es muss von vorne begonnen werden.
Da es nicht besonders schön und praktisch ist eine Konsole zu bedienen, gibt es für diese Anwendung eine Benutzeroberfläche. Diese ist deutlich leichter zu installieren. Dazu muss lediglich der Installer aus dem Aktuellen Release heruntergeladen werden. Dieser führt anschließend durch den gesamten Installationsprozess.
WICHTIG: Um das Tool sauber nutzen zu können muss der Server laufen, BEVOR die Benutzeroberfläche gestartet wird.
Zunächst muss der API-Schlüssen von SevDesk generiert werden. Dieser kann anschließend im GUI eingefügt und gespeichert werden. Dazu auf Einstellungen > Authorisierungs-Token
Hier kann der Schlüssel eingegeben werden.
Dieser Prozess muss nur beim ersten einrichten gemacht werden.
Anschließend kann das Jahr ausgewählt werden für das die Spendenbescheinigungen erstellt werden sollen. Danach auf Daten neu von SevDesk holen klicken. Nun werden alle Daten importiert.
Diese Funktion kann einige Sekunden dauern.
Wenn alle Daten angekommen sind wird automatisch das Fenster gewechselt zu einer Ansicht in der man alle Spender aus dem ausgewählten Jahr sieht.
Hier stehen (hoffentlich) alle relevanten Daten, um mögliche Fehler zu finden und diese zu beheben.
Es gibt effektiv 2 unterschiedliche Fenster zwischen denen hin und her gewechselt werden kann. Das erste ist die Start-Ansicht. Hier ist das aktuell zu bearbeitende Jahr sichtbar, sowie der Fortschritt. Ein Klick auf das Haus im oberen Linken Eck führt direkt zur Startseite zurück.
Wenn die Daten neu importiert werden beginnt jeder Datensatz bei Offen. Ein Klick in der Tabelle auf die Spalte "Offen" zeigt die untenstehende beispielhafte Liste. Zunächst muss jeder Datensatz geprüft werden, ob Daten stimmen und ob die Spender vollständig sind (also voller Name, Adresse, usw.)
Einzelne Spenden werden über den kleinen Pfeil in der Spalte "Mehr" sichtbar. Ein erneuter Klick lässt diese wieder verschwinden.
Bei jedem Spender der geprüft ist, kann das Kästchen in der ersten Spalte für den jeweiligen Spender angeklickt werden. Wenn alle auf einmal ausgewählt werden sollen, kann das Kästchen in der blauen Zeile angeklickt werden.
Wenn nun die Daten geprüft und ausgewählt sind kann auf den Knopf LaTeX datei aus ausgewählten Elementen erstellen geklickt werden. Diese Elemente verschwinden aus der aktuell angezeigten Tabelle und werden in den nächsten Status verschoben.
Die LaTeX Datei wurde erstellt und befindet sich im Downloads-Ordner.
Diese kann nun in Overleaf importiert werden und zu einem PDF kompiliert werden.
Nun oder nach dem Ausdrucken können erneut die Daten aus der Tabelle im Status Prüfen gecheckt werden, ob alles passt. Ist das der Fall, kann das kästchen für den Spender erneut angeklickt werden und auf "Ausgewählte Geprüft" geklickt werden. Für diese Spender ist der Prozess nun abgeschlossen.
Sollten sich Fehler in den Daten befinden, müssen diese über SevDesk korrigiert und dann erneut, wie oben beschrieben neu Importiert werden. dazu können die einzelnen Spender ausgewählt und gelöscht werden.
WICHTIG Das löscht nicht die Daten in SevDesk sondern nur in diesem Tool. Die Daten können immer wieder neu aus SevDesk importiert werden.
Aktuell werden dabei alle Elemente überschrieben egal, was für einen Status sie bereits erreicht haben. Das kann sich in der Zukunft ändern, sollte das gewünscht sein.
Sollten Fehler auftreten ist in der Benuteroberfläche die Email-Adresse und eine Telefonnummer zu finden. Bei Fragen am besten per WhatsApp oder Mail. Bei ganz dringenden Fällen anrufen.
Bei Wünschen zur Erweiterung oder veränderung von Funktionen oder Aussehen gerne auch per Mail oder über ein Issue auf Github.
