Een multi-kassa configureren

In multi-kassamodus delen meerdere kassa's binnen dezelfde winkel in real time de database: producten, klanten, verkopen, gebruikers, voorraad. Eenvoudige architectuur: één kassa host de PostgreSQL-server (de hoofdkassa), de andere maken er verbinding mee (de onderkassa's).

Architectuur

                      ┌─────────────────────┐
                      │   HOOFDKASSA        │
                      │   - AuraPOS         │
                      │   - PostgreSQL 18   │
                      │   192.168.1.10      │
                      └──────────┬──────────┘
                                 │ poort 5432
              ┌──────────────────┼──────────────────┐
              │                  │                  │
       ┌──────▼──────┐    ┌──────▼──────┐    ┌──────▼──────┐
       │ ONDERKASSA1 │    │ ONDERKASSA2 │    │ ONDERKASSA3 │
       │   AuraPOS   │    │   AuraPOS   │    │   AuraPOS   │
       │ 192.168.1.11│    │ 192.168.1.12│    │ 192.168.1.13│
       └─────────────┘    └─────────────┘    └─────────────┘

⚠️ Alle kassa's moeten op hetzelfde lokale netwerk (LAN) staan. AuraPOS ondersteunt geen multi-kassa via internet (gebruik een VPN indien nodig).

1. De hoofdkassa installeren

Op de kassa die hoofdkassa wordt:

1. Start de AuraPOS-installer
2. Vink de optie "PostgreSQL Server lokaal installeren" aan
3. Vink de optie "AuraPOS toestaan in Windows Firewall" aan
4. Voltooi de installatie

De installer installeert PostgreSQL 18 en maakt automatisch:

• Een gebruiker aurapos met wachtwoord 7312
• Een database aurapos
• Een firewallregel op poort 5432 (TCP)

Bij de eerste opstart van AuraPOS, kies Multi-kassa — Hoofdkassa in stap 3 van de wizard.

2. Een vast IP geven aan de hoofdkassa

Dit is cruciaal: als het IP van de hoofdkassa verandert, kunnen de onderkassa's niet meer verbinden. Twee opties:

• DHCP met reservering (aanbevolen): op de router, reserveer het IP-adres door het te koppelen aan het MAC-adres van de pc. De DHCP-server zal altijd hetzelfde IP toewijzen.
• Statisch vast IP: handmatig geconfigureerd in Windows (Instellingen > Netwerk > Eigenschappen > IPv4).

Controleer het IP van de hoofdkassa met ipconfig in cmd. Zoek de regel IPv4-adres van uw adapter (bv. 192.168.1.10).

3. Een onderkassa installeren

Op elke onderkassa:

1. Start de AuraPOS-installer
2. VINK NIET "PostgreSQL installeren" aan (onderkassa heeft geen lokale DB)
3. Voltooi de installatie

Bij de eerste opstart, kies Multi-kassa — Onderkassa in stap 3 van de wizard, vul vervolgens in:

• IP van de hoofdkassa: bv. 192.168.1.10
• Naam van de database: aurapos (standaard laten)

AuraPOS test de verbinding. Als die slaagt, downloadt de onderkassa automatisch de configuratie van de hoofdkassa (betaalmiddelen, talen, enz.) en start.

4. Synchronisatie verifiëren

Op de hoofdkassa, maak een testproduct "TEST_SYNC" aan. Op de onderkassa, open de productlijst → "TEST_SYNC" moet binnen de seconde verschijnen. Idem voor verkopen: een verkoop op een onderkassa is direct zichtbaar in de geschiedenis van de hoofdkassa.

Probleemoplossing

"Verbinding geweigerd" op de onderkassa

Mogelijke oorzaken:

1. Firewall hoofdkassa blokkeert: controleer dat de regel goed is aangemaakt. Op de hoofdkassa, in cmd als admin:

   netsh advfirewall firewall show rule name="PostgreSQL AuraPOS"
   

2. PostgreSQL niet gestart: services.msc → controleer dat postgresql-x64-18 actief is.
3. IP van de hoofdkassa gewijzigd: doe opnieuw ipconfig en vergelijk met wat de onderkassa heeft geconfigureerd.
4. Verschillend netwerk: hoofdkassa en onderkassa op verschillende subnetten (bv. 192.168.1.x vs 192.168.0.x). Verbind ze met dezelfde switch / SSID.

"Te veel verbindingen"

PostgreSQL is standaard geconfigureerd voor 100 gelijktijdige verbindingen. Als u meer dan 50 kassa's heeft (zeldzaam!), verhoog max_connections in postgresql.conf van de hoofdkassa.

Trage synchronisatie

Controleer de Wi-Fi-kwaliteit tussen de kassa's. Voor een winkel met >5 kassa's is Ethernet-bekabeling sterk aanbevolen.

Huidige beperkingen

• Geen offline-modus: als de onderkassa de verbinding met de hoofdkassa verliest, kan ze niet meer afrekenen. Offline-veerkracht is voorzien voor de stabiele versie.
• Geen TLS-encryptie: de PostgreSQL-verbinding is in clear over LAN. Aanvaardbaar in beveiligd privénetwerk, te vermijden op publieke Wi-Fi.
• Back-ups alleen op de hoofdkassa: alleen de hoofdkassa voert auto-back-ups uit (onderkassa's hebben geen lokale .db).

Tips

• Verbinding testen zonder een onderkassa te installeren: vanaf een willekeurige machine van het netwerk, start in cmd: psql -h 192.168.1.10 -p 5432 -U aurapos -d aurapos (wachtwoord 7312). Als het een prompt aurapos=> opent, is uw netwerk en hoofdkassa OK.
• Migratie mono → multi: als u start in mono-kassa en later wilt overstappen naar multi, worden uw SQLite-gegevens automatisch gemigreerd naar PostgreSQL bij het wijzigen van de modus in Instellingen > Opslag.