Garten Rechnungen erstellen

Vorbedingungen

Node mit npm installiert mit mindestens Version 18 siehe node.js Downloads

Einrichtung

diese Git Projekt klonen
npm ci im Projektverzeichniss ausführen
Abhängige Dateien in einen Unterordner namens data hinzufügen a. logo.png Logo welches als Absender auf den Brief gedruckt werden soll b. mitgliederliste.xlsx Excel Datei mit den Daten siehe Struktur in der mitgliederliste c. bills Ordner in den die Rechnungen als Pdf erstellt werden sollen

Struktur im Excel mitgliederliste.xlsx

Damit die Daten korrekt aus dem Excel gelesen werden können müssen die folgenden Reiter mit extakt dem angegebenen Namen vorhanden sein

Ein Beispiel Excel mit der geforderten Struktur ist im Ordner example_data hinterlegt.

Mitgliederliste

Die folgende Tabelle Zeigt die Mindestandorderung an das Tabellenblatt Mitgliederliste. Wichtig ist vor allem die Reihenfolge.

Parz.	Name	Vorname	Adresse	PLZ	Ort	Tel.	Aa			Spr.	Vorstand
Parzellen nummer	Name als text	Vorname als Text	Strasse und Hausnummer	Postleitzahl	Ortschaftsnamen	Telefon (wird nicht benötigt)	Anzahl Aren als Zahlenwert	Leere Spalte	Leere Spalte	Sprache 'D' oder 'F'	'J' falls Mitglied Vorstansmitglied ist ansonsten leer

pachtzins

Diese Tabelle muss explizit so ausgefüllt werden alle Einträge sind in derselben Währung als Zahl anzugeben. Im gegensatz zur Tabelle Mitgliederliste zählt hier nur die erste Zeile nach dem Titel.

pachtzinz	wasserbezug	GF Abonement	Strom	Versicherung	Mitgliederbeitrag	Reparaturfonds	Verwaltungskosten
Zins pro Are	Wasserkosten pro Are	Kosten für das Abonement des "Gartenfreund"	Stromkosten pauschal	Versicherungskosten pauschal	Mitgliederbeitrag pauschal	Beitrag an den Reparaturfonds pauschal	Beitrag an die Verwaltungskosten pauschal

Rechnungsdetails

Auch diese Tabelle muss explizit so ausgefüllt werden Hierbei sind die Spalten massgebend. Die erste Spalte ist die Bezeichnung, während die zweite Spalte die Werte beinhaltet


Name	Name in der Adresszeile
Adresse	Adresse ohne Hausnummer
Adress Nummer	Hausnummer
Postleitzahl	Postleitzahl
Stadt	Ortsangabe ohne plz
Iban Nummer	gültige Iban Nummer
Ueberschrift DE	Überschrift im Brief auf Deutsch
Ueberschrift FR	Überschrift im Brief auf Französisch

Anwendung

Build für eine mit Node ausführbare .js Datei

Das Projekt ist in Typescript geschrieben. Damit es mit Node ausführen kann muss das Script npm run build ausgeführt werden. Nach erfolgreichen ausführen ist die transpilierte JavaScript Datei index.js unter dist.

Programm mit Node laufen lassen

Vorbedingung hierfür ist ein vorhergehendes npm run build und die benötigten Dateien im Ordner Vorbedingungen data

Skript um das Programm zu starten npm run start Nach erfolgreichem Lauf befinden sich die Rechnungen unter data/bills

Bundle erstellen

Nur notwendig, wenn die Datei in einer einzigen JavaScript datei ohne Abhängigkeiten benötigt wird z.B. um daraus eine Ausführbare Datei zu erstellen. Skript npm run bundle. Nach erfolgreichem Bundle befindet sich die JavaScript Datei main.js unter dem Ordner dist.

Ausführbare Dateien erstellen

Vorbedingung hierfür ist, dass eine gebündelte main.js Datei vorhanden ist.

Skript npm run exec. Nach erfolgreichem erstellen, befinden sich im Arbeitsverzeichniss drei neue Dateien

main-win.exe (für Windows)
main-linux (für Linux)
main-macos (für Mac)

Welche auf den jeweiligen Systemen (und dem Ordner data) direkt ausführen lassen.