Steuerkram/README.md

Steuerkram

Self-hosted Buchhaltungs- und Steueranwendung für deutsche Freiberufler und Kleinunternehmer. Entwickelt als datensouveräne Alternative zu SaaS-Diensten – mit Unterstützung von Claude Code.

---

Funktionsumfang

Bereich	Beschreibung
Kontenrahmen SKR03	DATEV-konform, 157 Konten, mit UStVA-Kennzahlen und EÜR-Zeilennummern
Belegverwaltung	PDF, PNG, TIFF, ZUGFeRD-XML; SHA-256 Integritätsprüfung; optionale KI-Kontierung
Buchungen	EÜR-Modell (Einnahme/Ausgabe); GoBD-konforme Trigger; Stornobuchungen; Journal
Anlagevermögen	Anlagenspiegel; automatische Anlagen-Nummerierung; Buchungsworkflow mit Asset-Verknüpfung
Ausgangsrechnungen	DIN 5008, PDF-Export via mPDF
UStVA	Kennzahlen-Berechnung, ELSTER XML-Export, Drill-down
EÜR	Jahresauswertung, PDF-Export, Drill-down
Kundenverwaltung	CRUD
Einstellungen	Firmendaten, Logo, ELSTER-Steuernummer, Nummernkreise
Benutzerverwaltung	Mehrbenutzer, Session-Auth mit 24 h Timeout

---

Schnellstart

curl -fsSL https://codeberg.org/fds2610/Steuerkram/raw/branch/main/install.sh -o install.sh
sudo bash install.sh
cd /opt/Steuerkram
docker compose up -d

Anwendung aufrufen: http://localhost:8080

---

Dokumentation

Dokument	Inhalt
Installation	Docker-Setup, Systemd-Service, Port, Upload-Limit
Konfiguration	Firmendaten, Nummernkreise, KI-Beleganalyse, Nextcloud-Import
Funktionen	Alle Features im Detail
Anlagevermögen	Anlagenspiegel, Buchungsworkflow, Nummernkreis
Update & Backup	Update-Anleitung, Backup, Datenpersistenz
Automatisierung	Automatisierungsagent, Ideenagent, Support
Datenbankstruktur	Tabellen, Spalten, Fremdschlüssel, GoBD-Mechanismen
Berechnungslogik	UStVA-Kennzahlen und EÜR-Zuordnungsregeln
Kontenrahmen	Vollständige SKR03-Kontenliste

---

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.