FDS2610/Steuerkram
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
19 commits 1 branch 0 tags 2 MiB
Find a file
fds2610 08b99e3992 Fix #2: Ausgangsrechnung automatisch buchen beim Finalisieren 
Beim Finalisieren einer Rechnung wurde bisher kein Beleg und keine
Buchungszeilen erstellt – der Nutzer musste danach manuell "Buchen"
klicken, was nicht offensichtlich war.

- finalize() erstellt jetzt atomar Beleg + Buchungszeilen (via
  createBelegAndBookings) innerhalb derselben Transaktion
- Buchungslogik aus book() in private Methode extrahiert (DRY),
  book()-Route bleibt für bereits finalisierte, noch ungebuchte
  Rechnungen erhalten
- "Buchen"-Button in der Show-View entfernt (nicht mehr nötig)
2026-03-25 21:11:30 +01:00
.gitea/ISSUE_TEMPLATE minor changes 2026-03-25 14:35:29 +01:00
apache Initial commit 2026-03-25 00:19:33 +01:00
migrations Session-basierte Authentifizierung + Benutzerverwaltung 2026-03-25 15:28:07 +01:00
public Benutzer bearbeiten: Bearbeiten-Button + Update-Route 2026-03-25 15:50:07 +01:00
scripts Initial commit 2026-03-25 00:19:33 +01:00
src Fix #2: Ausgangsrechnung automatisch buchen beim Finalisieren 2026-03-25 21:11:30 +01:00
.env.example Session-basierte Authentifizierung + Benutzerverwaltung 2026-03-25 15:28:07 +01:00
.gitignore Bug gefixed 2026-03-25 13:34:47 +01:00
activate.sh added systemd service 2026-03-25 13:31:34 +01:00
Changes.md Changes.md wiederhergestellt und aktualisiert 2026-03-25 16:08:05 +01:00
composer.json Initial commit 2026-03-25 00:19:33 +01:00
docker-compose.yml Session-basierte Authentifizierung + Benutzerverwaltung 2026-03-25 15:28:07 +01:00
Dockerfile Dockerfile korrigiert - Hinweis von @nikomat@mastodontech.de 2026-03-25 08:07:41 +01:00
install.sh Changes.md erstellt, README.md und install.sh aktualisiert 2026-03-25 16:00:29 +01:00
LICENSE.md added LICENSE.md 2026-03-25 00:44:02 +01:00
README.md Changes.md erstellt, README.md und install.sh aktualisiert 2026-03-25 16:00:29 +01:00
steuerkram.service minor changes 2026-03-25 14:35:29 +01:00

README.md

Steuerkram

Self-hosted Buchhaltungs- und Steueranwendung für deutsche Freiberufler und Kleinunternehmer. Entwickelt als datensouveräne Alternative zu SaaS-Diensten.

Funktionsumfang

  • Kontenrahmen SKR03 – vollständiger Kontenrahmen mit ~80 vorbesetzten Konten (CRUD)
  • Belegverwaltung – Upload von PDF, PNG, TIFF und ZUGFeRD-XML; SHA-256 Integritätsprüfung
  • Buchungen – doppelte Buchführung; GoBD-konforme Trigger verhindern nachträgliche Manipulation
  • Kundenverwaltung – CRUD
  • Ausgangsrechnungen – DIN 5008 Layout, PDF-Export via mPDF
  • UStVA – Kennzahlen-Berechnung aus Buchungen, ELSTER XML-Export
  • EÜR – Jahresauswertung mit PDF-Export
  • Einstellungen – Firmendaten, Logo, ELSTER-Steuernummer
  • Benutzerverwaltung – Benutzer anlegen, bearbeiten, deaktivieren und löschen; session-basierte Authentifizierung mit 24 h Timeout

Tech Stack

Dieses Projekt wurden mit Unterstützung von Claude Code entwickelt.

PHP HTML CSS JavaScript

Schicht Technologie
Webserver Apache 2.4
Backend PHP 8.3 (MVC, kein Framework)
Datenbank MariaDB 11
PDF-Generierung mPDF 8.x
Frontend HTML, CSS, JavaScript (keine Bibliotheken)
Deployment Docker / Docker Compose

Voraussetzungen

Installation

Automatische Installation

Das Script install.sh übernimmt die gesamte Installation: es erkennt die Linux-Distribution, installiert git, curl und Docker, klont das Repository in das gewünschte Verzeichnis und legt die .env-Datei an.

Das Script muss vor dem Klonen des Repositories heruntergeladen werden – es erledigt das Klonen selbst:

curl -fsSL https://codeberg.org/fds2610/Steuerkram/raw/branch/main/install.sh -o install.sh
sudo bash install.sh

Das Script muss als root ausgeführt werden, da es Pakete installiert und ggf. den Docker-Dienst aktiviert. Mit sudo bash install.sh funktioniert das ohne dauerhaft als root angemeldet zu sein.

Nach der Installation die .env-Datei im gewählten Installationsverzeichnis anpassen (siehe Hinweis am Ende des Scripts) und anschließend die Container starten:

cd /opt/Steuerkram   # oder das gewählte Verzeichnis
docker compose up -d

Manuelle Installation

1. Repository klonen

git clone <repository-url> steuerkram
cd steuerkram

2. Konfiguration anpassen

Kopiere .env.example nach .env und passe die Werte an:

cp .env.example .env

DB_PASS=sicheres-passwort        # Datenbankpasswort – in docker-compose.yml spiegeln
APP_SECRET=zufaelliger-string    # Zufälligen langen String eintragen (für Sessions)

Außerdem in docker-compose.yml das MARIADB_PASSWORD im db-Service auf denselben Wert wie DB_PASS setzen.

3. Container starten

docker compose up -d

Beim ersten Start werden automatisch:

  • die Datenbank initialisiert (migrations/001_initial_schema.sql)
  • der SKR03-Kontenrahmen eingespielt (migrations/002_seed_skr03.sql)
  • das Docker-Image mit PHP-Abhängigkeiten (mPDF) gebaut

4. Anwendung aufrufen

http://localhost:8080

Beim ersten Aufruf erscheint die Ersteinrichtung: dort den ersten Benutzer-Account anlegen. Danach ist die Anwendung passwortgeschützt.

Weitere Benutzer können nach dem Login unter Benutzer in der Seitenleiste verwaltet werden.

5. Firmendaten hinterlegen

Nach dem ersten Login unter Einstellungen Firmendaten, Logo und ELSTER-Steuernummer eintragen. Diese Angaben erscheinen auf Ausgangsrechnungen und im EÜR-Export.

Port ändern

Der Standard-Port ist 8080. Um ihn zu ändern, passe in docker-compose.yml die ports-Zeile an:

ports:
  - "9090:80"   # Beispiel: Port 9090 auf dem Host

Datenpersistenz

Pfad Inhalt
./data/mariadb/ MariaDB-Datenbankdateien
Docker Volume uploads Hochgeladene Belege

Beide Pfade liegen außerhalb des Containers und bleiben bei docker compose down erhalten.

Backup

bash scripts/backup.sh

Das Skript erstellt ein Dump der Datenbank sowie ein Archiv der Uploads im Verzeichnis backups/.

Update

git pull
docker compose up -d --build

GoBD-Hinweise

  • Gebuchte Sätze können nicht geändert oder gelöscht werden (MariaDB BEFORE UPDATE/DELETE Trigger).
  • Korrekturen erfolgen ausschließlich über Stornobuchungen.
  • Jeder hochgeladene Beleg erhält einen SHA-256 Hash zur Integritätsprüfung.

Lizenz

License: MIT

Dieses Projekt steht unter der MIT-Lizenz – siehe LICENSE.md für Details.