MiniKassenbuch

A simple PHP and Javascript application to manage accounting (for german law)

Eine simple PHP & Javascript Applikation zum führen einfacher Kassenbücher & Vereinskassen

Build Status

Docker

Direkt loslegen:

git clone https://github.com/TSGames/MiniKassenbuch
docker-compose up -d

anschließend http://localhost:8080/ aurufen. (Alternativ kann auch der Inhalt der docker-compose.yml kopiert werden)

Entwickeln mit Docker

git clone https://github.com/TSGames/MiniKassenbuch
cd MiniKassenbuch
composer install
docker-compose -f docker-compose.dev.yml up

Releases

Direkt loslegen & installieren: Auf der Release-Page gibt es fertige Binaries zum kopieren auf einen PHP-Server: https://github.com/TSGames/MiniKassenbuch/releases

Ziel

Ziel soll es sein, eine offene, kostenfreie Plattform für die Verwaltung von Kassenbeständen oder Konten durchzuführen. Einfache Statistiken sollen bei der Auswertung helfen.

Das System ist insbesondere an Vereine, private Personen oder zur persönlichen Benutzung ausgerichtet.

Aktuell ist das System für kleinere Datenbestände ausgelegt. Performancetests bis ca. 100.000 Buchungen waren, je nach Serverperformance, erfolgreich. Das System hat keine spezifischen Performance-Optimierungen für große Datenmengen.

Features

• Verwaltung von Kasse und bis zu 6 Bankkonten
• Integrierter Login mit Nutzername + Passwort
• Kategorisierung von einzelnen Buchungen
• Intelligente Kategorieerkennung nach Eingabe von Buchungen
• Speichern von Bemerkungen und beliebigen Dokumenten (PDF, JPG, ...) an Buchungen
• Import-Konfigurator für CSV-Import von Bankdaten
• Statistik-Auswertung für gesamten Zeitraum + Jahr
• Export pro Monat
• 1-Klick Backup des gesamten Datenbestands
• Responsive-Design (Desktop + Mobile optimiert)

Installation

Das System muss mittels

./update-composer.sh
php composer.phar install

konfiguriert werden.

Alternativ können Binaries (hier bezogen werden. Ein PHP 7.x Webserver mit Unterstützung für SQLite wird benötigt.

Konfiguration unter Debian oder Ubuntu mit Apache

Pakete installieren

apt install libapache2-mod-php php-sqlite3

Webserver konfigurieren

Falls der Webserver nur diesen einen Virtual Host zur Verfügung stellen soll, können die folgenden Zeilen in /etc/apache2/sites-enabled/000-default.conf anstelle der bestehenden DocumentRoot-Zeile eingetragen werden. (Wer mehrere Virtual Hosts nutzt, sollte wissen, wie diese Zeilen in die bestehende Konfiguration zu integrieren sind.)

	DocumentRoot /pfad/zum/MiniKassenbuch/public
	<Directory /pfad/zum/MiniKassenbuch/public/>
		Options Indexes FollowSymLinks
		AllowOverride All
	</Directory>

Natürlich muss /pfad/zum/MiniKassenbuch durch den Installationspfad auf dem System ersetzt werden.

Dem Webserver muss Schreibzugriff auf das Verzeichnis gegeben werden, damit die Datenbank (storage.sqlite) und die Dokumente (documents/*) angelegt werden können:

chmod g+w /pfad/zum/MiniKassenbuch
chgrp www-data /pfad/zum/MiniKassenbuch

Erster Login

Nach dem ersten Hochladen der Webanwendung und Aufruf der Seite muss ein Login-Screen inkl. einer Hinweis-Meldung, dass es sich um den ersten Login handelt, erscheinen. Sollte dieser Hinweis nicht erscheinen, auf jeden Fall die Zugangsdaten zurücksetzen (s. unten)! Die nun erfolgende Eingabe wird für spätere Zugriffe als Login verwendet.

Login zurücksetzen

Der Login ist (Passwort verschlüsselt) in der Datei src/authentication.json gespeichert. Diese kann auf dem Server gelöscht werden, der anschließend erfolgende Login wird wieder für zukünftige Zugriffe verwendet

Screenshots

Frameworks

Das Projekt nutzt u.a. folgende Frameworks oder Toolkits

• composer
• slim
• twig
• materialize.css
• material icons
• jQuery
• Google Charts