Mehrkassenbetrieb konfigurieren

Im Mehrkassenmodus teilen mehrere Kassen im selben Geschäft in Echtzeit die Datenbank: Produkte, Kunden, Verkäufe, Benutzer, Bestand. Einfache Architektur: Eine Kasse hostet den PostgreSQL-Server (die Hauptkasse), die anderen verbinden sich damit (die Nebenkassen).

Architektur

                      ┌─────────────────────┐
                      │   HAUPTKASSE        │
                      │   - AuraPOS         │
                      │   - PostgreSQL 18   │
                      │   192.168.1.10      │
                      └──────────┬──────────┘
                                 │ Port 5432
              ┌──────────────────┼──────────────────┐
              │                  │                  │
       ┌──────▼──────┐    ┌──────▼──────┐    ┌──────▼──────┐
       │ NEBENKASSE 1│    │ NEBENKASSE 2│    │ NEBENKASSE 3│
       │   AuraPOS   │    │   AuraPOS   │    │   AuraPOS   │
       │ 192.168.1.11│    │ 192.168.1.12│    │ 192.168.1.13│
       └─────────────┘    └─────────────┘    └─────────────┘

⚠️ Alle Kassen müssen sich im selben lokalen Netzwerk (LAN) befinden. AuraPOS unterstützt keinen Mehrkassenbetrieb über das Internet (verwenden Sie ggf. ein VPN).

1. Die Hauptkasse installieren

Auf der Kasse, die zur Hauptkasse wird:

1. Starten Sie das AuraPOS-Installationsprogramm
2. Kreuzen Sie die Option "PostgreSQL Server lokal installieren" an
3. Kreuzen Sie die Option "AuraPOS in der Windows-Firewall zulassen" an
4. Schließen Sie die Installation ab

Der Installer installiert PostgreSQL 18 und erstellt automatisch:

• Einen Benutzer aurapos mit Passwort 7312
• Eine Datenbank aurapos
• Eine Firewallregel auf Port 5432 (TCP)

Beim ersten Start von AuraPOS wählen Sie im Wizard Mehrkasse — Hauptkasse in Schritt 3.

2. Der Hauptkasse eine feste IP geben

Das ist entscheidend: Wenn sich die IP der Hauptkasse ändert, können sich die Nebenkassen nicht mehr verbinden. Zwei Optionen:

• DHCP mit Reservierung (empfohlen): Reservieren Sie die IP-Adresse am Router, indem Sie sie der MAC des PCs zuordnen. Der DHCP-Server vergibt immer die gleiche IP.
• Statische IP: Manuell in Windows konfiguriert (Einstellungen > Netzwerk > Eigenschaften > IPv4).

Prüfen Sie die IP der Hauptkasse mit ipconfig in cmd. Suchen Sie die Zeile IPv4-Adresse Ihres Adapters (z. B. 192.168.1.10).

3. Eine Nebenkasse installieren

Auf jeder Nebenkasse:

1. Starten Sie das AuraPOS-Installationsprogramm
2. KREUZEN SIE NICHT "PostgreSQL installieren" an (die Nebenkasse hat keine lokale DB)
3. Schließen Sie die Installation ab

Beim ersten Start wählen Sie im Wizard Mehrkasse — Nebenkasse in Schritt 3, geben Sie dann ein:

• IP der Hauptkasse: z. B. 192.168.1.10
• Datenbankname: aurapos (Standard belassen)

AuraPOS testet die Verbindung. Wenn sie gelingt, lädt die Nebenkasse automatisch die Konfiguration der Hauptkasse herunter (Zahlungsmittel, Sprachen usw.) und startet.

4. Synchronisation überprüfen

Erstellen Sie auf der Hauptkasse ein Testprodukt "TEST_SYNC". Öffnen Sie auf der Nebenkasse die Produktliste → "TEST_SYNC" sollte innerhalb einer Sekunde erscheinen. Ebenso für Verkäufe: Ein Verkauf auf einer Nebenkasse ist sofort im Verlauf der Hauptkasse sichtbar.

Fehlerbehebung

"Verbindung verweigert" auf der Nebenkasse

Mögliche Ursachen:

1. Firewall der Hauptkasse blockiert: Prüfen Sie, dass die Regel korrekt erstellt wurde. Auf der Hauptkasse, in cmd als Admin:

   netsh advfirewall firewall show rule name="PostgreSQL AuraPOS"
   

2. PostgreSQL nicht gestartet: services.msc → prüfen, dass postgresql-x64-18 läuft.
3. IP der Hauptkasse geändert: ipconfig erneut ausführen und mit dem vergleichen, was die Nebenkasse konfiguriert hat.
4. Anderes Netzwerk: Hauptkasse und Nebenkasse in unterschiedlichen Subnetzen (z. B. 192.168.1.x vs. 192.168.0.x). Verbinden Sie sie mit demselben Switch / SSID.

"Zu viele Verbindungen"

PostgreSQL ist standardmäßig für 100 gleichzeitige Verbindungen konfiguriert. Wenn Sie mehr als 50 Kassen haben (selten!), erhöhen Sie max_connections in der postgresql.conf der Hauptkasse.

Langsame Synchronisation

Prüfen Sie die WLAN-Qualität zwischen den Kassen. Bei einem Geschäft mit > 5 Kassen ist Ethernet-Verkabelung dringend empfohlen.

Aktuelle Einschränkungen

• Kein Offline-Modus: Wenn die Nebenkasse die Verbindung zur Hauptkasse verliert, kann sie nicht mehr abrechnen. Offline-Resilienz ist für die stabile Version geplant.
• Keine TLS-Verschlüsselung: Die PostgreSQL-Verbindung erfolgt im Klartext über LAN. Akzeptabel in einem sicheren privaten Netzwerk, in öffentlichem WLAN zu vermeiden.
• Sicherungen nur auf der Hauptkasse: Nur die Hauptkasse führt automatische Sicherungen durch (Nebenkassen haben keine lokale .db).

Tipps

• Verbindung testen, ohne eine Nebenkasse zu installieren: Von einer beliebigen Maschine im Netzwerk in cmd starten: psql -h 192.168.1.10 -p 5432 -U aurapos -d aurapos (Passwort 7312). Wenn ein aurapos=>-Prompt erscheint, sind Ihr Netzwerk und Ihre Hauptkasse OK.
• Migration Einzelkasse → Mehrkasse: Wenn Sie im Einzelkassenbetrieb starten und später auf Mehrkassen wechseln möchten, werden Ihre SQLite-Daten beim Modus-Wechsel in Einstellungen > Speicherung automatisch nach PostgreSQL migriert.