Dokumentation & Setup-Guide.

01Voraussetzungen

Die Plattform ist bewusst anspruchslos gehalten. Sie läuft auf jedem Hoster, der einen modernen PHP-Stack mit MySQL bereitstellt. Eine eigene Domain ist nicht erforderlich — eine Subdomain oder ein Unterordner reichen.

PHP-Erweiterungen

Folgende PHP-Erweiterungen müssen aktiv sein. Auf den meisten Hostern sind sie es bereits:

• pdo_mysql — Datenbank­verbindung
• mbstring — Mehrbyte-String-Verarbeitung (Umlaute)
• json — JSON-Serialisierung
• session — Login & Authentifizierung
• gd oder imagick — Bild-Upload & Thumbnails

02Installation in 4 Schritten

Vom Download bis zum ersten Login. Der Wizard erledigt fast alles selbst — du tippst nur die Datenbank-Zugangsdaten ein.

Schritt 1 — Dateien herunterladen

Lade das aktuelle ZIP von der Release-Seite herunter und entpacke es lokal:

# aktuelles Release herunterladen
curl -O https://example.com/geschaeftsbuch-v4.7.zip

# entpacken
unzip geschaeftsbuch-v4.7.zip

# Inhalt prüfen
ls geschaeftsbuch/
# → 32 PHP-Dateien, assets/, includes/, api/, setup.php

Schritt 2 — Auf den Hoster laden

Lade den entpackten Ordner per FTP, SFTP oder SCP in das öffentliche Verzeichnis deines Hosters (meist htdocs/, public_html/ oder www/):

# mit SCP
scp -r geschaeftsbuch/ user@dein-hoster.de:/var/www/

# oder per FTP-Client (FileZilla, Cyberduck, WinSCP)
# Ziel: htdocs/ oder public_html/

Schritt 3 — Datenbank anlegen

Erstelle eine leere MySQL-Datenbank über das Hoster-Panel oder phpMyAdmin. Du brauchst:

• Den Datenbank-Namen (z. B. db_12345_main)
• Den Benutzernamen (z. B. USER12345)
• Das Passwort
• Den Host (meist localhost, bei Lima-City: USERID.lima-db.de)

Schritt 4 — Setup-Wizard starten

Öffne im Browser:

https://deine-domain.de/setup.php

Der Wizard führt dich durch:

1. Site-Title — wie soll dein Geschäft heißen? (z.B. „Mein Tabakhandel", „Westliche Pferderanche", „Familien-Farm"…)
2. Datenbank-Verbindung — die vier Werte aus Schritt 3
3. Verbindungstest — der Wizard prüft, ob er die Datenbank erreicht
4. Erster Benutzer — Name & Passwort für den Admin-Account

03Erstkonfiguration

Nach dem Setup ist die Plattform funktionsfähig — aber leer. Diese Reihenfolge hat sich für die ersten 30 Minuten bewährt:

1. Mitarbeiter anlegen unter Mitarbeiter → Neuer Eintrag. Auch wenn du allein arbeitest: einer reicht für den Anfang.
2. Berechtigungen prüfen unter Berechtigungen. Die Standard-Rollen (Admin / Leitung / Mitarbeiter) sind sinnvoll vorbelegt — anpassen kannst du später.
3. Geschäftspartner / Lieferanten erfassen, falls du gleich Bestellungen anlegen willst.
4. Erste Mitteilung ans Team — Geschäftsregeln, Hinweise, To-Dos.
5. Module deaktivieren, die du nicht brauchst (siehe unten).

04config.php manuell bearbeiten

Wenn du Einstellungen nachträglich ändern willst (Datenbank wechseln, Site-Title anpassen, Sicherheits­einstellungen schärfen), bearbeitest du die Datei includes/config.php direkt:

<?php
/**
 * Geschäftsbuch — Konfiguration
 */

// Datenbank-Einstellungen
define('DB_HOST', 'localhost');
define('DB_NAME', 'mein_geschaeftsbuch');
define('DB_USER', 'mein_user');
define('DB_PASS', 'sicheres_passwort');

// Session-Einstellungen — pro Deployment einzigartig
define('SESSION_NAME', 'mein_geschaeft_session');
define('SESSION_LIFETIME', 86400);  // 24 Stunden

// Branding
define('SITE_TITLE', 'Mein Geschäft');
define('SITE_SUBTITLE', 'Geschaeftsverwaltung');

// Auslage — maximale Plätze
define('AUSLAGE_MAX_PLAETZE', 100);

// Zeitzone
date_default_timezone_set('Europe/Berlin');

// Setup-Schutz — nicht ändern
define('SETUP_COMPLETE', true);

// Output Buffering — verhindert "headers already sent"
ob_start();

// Error Reporting (Produktion: 0, Entwicklung: E_ALL)
error_reporting(0);
ini_set('display_errors', 0);

05Berechtigungen vergeben

Das Permissions-System ist das Herz der Plattform. Drei Standard-Rollen sind vorgegeben, weitere kannst du beliebig anlegen.

Berechtigungen kannst du auf zwei Ebenen vergeben:

• Per Rolle — gilt für alle Mitarbeiter dieser Rolle. Sinnvoll für allgemeine Regelungen.
• Per Mitarbeiter (Override) — schaltet einzelne Module für einen einzelnen Mitarbeiter zusätzlich frei oder ab. Sinnvoll für Sonderfälle.

06Branding & Look

Jedes Deployment kann individuell gestaltet werden — vom Site-Title über Akzentfarben bis hin zu eigenen Logos. Drei Anpassungs­ebenen:

Ebene 1 — Texte

Site-Title und Untertitel werden über config.php gesetzt (siehe oben). Erscheinen im Browser-Tab, im Header und im Login.

Ebene 2 — Farbschema

Die Farben sind als CSS-Variablen in assets/css/style.css hinterlegt. Editiere die :root-Sektion:

:root {
  --accent: #f0a83e;       /* Hauptakzent */
  --accent-deep: #c98220;  /* dunkler Akzent */
  --bg: #0a0908;           /* Hintergrund */
  --surface: #141210;      /* Panels */
  --text: #f5f1e8;         /* Haupttext */
}

Ebene 3 — Logo & Favicon

Logo und Favicon liegen unter assets/img/. Ersetze einfach die Dateien logo.svg und favicon.ico — die Plattform lädt automatisch das, was im Verzeichnis liegt.

07Module aktivieren / deaktivieren

Nicht jedes Geschäft braucht jedes Modul. Ein Tabakhandel braucht keine Stallverwaltung, eine Pferderanche keinen Schnellverkauf-POS. Module werden auf zwei Wegen abgeschaltet:

Variante A — Über die Berechtigungen

Wenn alle Rollen kein Recht für ein Modul haben, ist es de facto deaktiviert. Schnell, kein Code-Eingriff nötig.

Variante B — Datei entfernen

Wenn du das Modul gar nicht brauchst, kannst du die entsprechende PHP-Datei einfach löschen. Die Navigation prüft, welche Dateien existieren, und blendet fehlende automatisch aus.

# Beispiel: Schnellverkauf wird nicht gebraucht
rm schnellverkauf.php

# Modul ist sofort weg — auch aus der Navigation

08Modul-Rechte feinjustieren

Innerhalb eines aktiven Moduls kannst du jede Aktion einzeln freischalten oder sperren. Die Aktions­ebenen sind durchgängig:

• view — der Mitarbeiter sieht das Modul in der Navigation und kann Listen einsehen
• create — neue Einträge anlegen
• edit — bestehende Einträge bearbeiten
• delete — Einträge löschen (Undo bleibt verfügbar)
• export — Daten als CSV / PDF exportieren

Beispiel: Eine Aushilfe darf das Kassenbuch sehen (view) und Buchungen anlegen (create), aber nichts ändern oder löschen. Genau das stellst du in der Rollen­konfiguration ein.

09Backup

Die Plattform speichert alle Geschäftsdaten in der MySQL-Datenbank. Backup heißt deshalb: Datenbank-Dump. Dazu Bilder und die config.php sichern, fertig.

Datenbank-Dump per CLI

# vollständiger Dump
mysqldump -u DB_USER -p DB_NAME > backup_$(date +%Y-%m-%d).sql

# mit Komprimierung
mysqldump -u DB_USER -p DB_NAME | gzip > backup_$(date +%Y-%m-%d).sql.gz

Per phpMyAdmin

Datenbank auswählen → „Exportieren" → Format „SQL" → „OK". Die Datei landet im Download-Ordner.

Empfohlener Backup-Rhythmus

• Täglich — automatisch via Cron-Job, mindestens 7 Tage Aufbewahrung
• Wöchentlich — manuelle Sicherung lokal speichern
• Vor jedem Update — Pflicht, ohne Diskussion

10Updates einspielen

Updates kommen als ZIP. Der Ablauf ist immer derselbe:

1. Backup machen. Datenbank dumpen, config.php kopieren.
2. ZIP entpacken in einen separaten Ordner.
3. Alle Dateien außer config.php ersetzen auf dem Server.
4. Erste Seite aufrufen. Module migrieren ihre Tabellen automatisch beim ersten Aufruf — neue Spalten werden ergänzt, neue Tabellen entstehen.
5. Changelog lesen, falls Migrations­schritte oder Konfigurationsänderungen erforderlich sind.

11Troubleshooting

Die häufigsten Probleme und ihre Lösungen: