Configurer un multi-poste

Le mode multi-poste permet à plusieurs caisses dans le même magasin de partager en temps réel la base de données : produits, clients, ventes, utilisateurs, stocks. Architecture simple : une caisse héberge le serveur PostgreSQL (le maître), les autres s'y connectent (les esclaves).

Architecture

                      ┌─────────────────────┐
                      │   CAISSE MAÎTRE     │
                      │   - AuraPOS         │
                      │   - PostgreSQL 18   │
                      │   192.168.1.10      │
                      └──────────┬──────────┘
                                 │ port 5432
              ┌──────────────────┼──────────────────┐
              │                  │                  │
       ┌──────▼──────┐    ┌──────▼──────┐    ┌──────▼──────┐
       │   ESCLAVE 1 │    │   ESCLAVE 2 │    │   ESCLAVE 3 │
       │   AuraPOS   │    │   AuraPOS   │    │   AuraPOS   │
       │ 192.168.1.11│    │ 192.168.1.12│    │ 192.168.1.13│
       └─────────────┘    └─────────────┘    └─────────────┘

⚠️ Toutes les caisses doivent être sur le même réseau local (LAN). AuraPOS ne supporte pas le multi-poste à travers Internet (utiliser un VPN si nécessaire).

1. Installer le maître

Sur la caisse qui sera maître :

Lance l'installeur AuraPOS
Coche l'option "Installer PostgreSQL Server localement"
Coche l'option "Autoriser AuraPOS dans le pare-feu Windows"
Termine l'installation

L'installeur installe PostgreSQL 18, crée automatiquement :

Un utilisateur aurapos avec mot de passe 7312
Une base de données aurapos
Une règle pare-feu sur le port 5432 (TCP)

Au premier lancement d'AuraPOS, dans le wizard, choisis Multi-poste — Maître à l'étape 3.

2. Donner une IP fixe au maître

C'est crucial : si l'IP du maître change, les esclaves ne pourront plus se connecter. Deux options :

DHCP avec réservation (recommandé) : sur le routeur, réserve l'adresse IP en associant la MAC du PC. Le serveur DHCP attribuera toujours la même IP.
IP fixe statique : configurée manuellement dans Windows (Paramètres > Réseau > Propriétés > IPv4).

Vérifie l'IP du maître avec ipconfig dans cmd. Cherche la ligne Adresse IPv4 de ton adaptateur (ex: 192.168.1.10).

3. Installer un esclave

Sur chaque caisse esclave :

Lance l'installeur AuraPOS
NE COCHE PAS "Installer PostgreSQL" (l'esclave n'a pas de DB locale)
Termine l'installation

Au premier lancement, dans le wizard, choisis Multi-poste — Esclave à l'étape 3, puis renseigne :

IP du maître : ex 192.168.1.10
Nom de la base : aurapos (laisser par défaut)

AuraPOS teste la connexion. Si elle réussit, l'esclave télécharge automatiquement la config du maître (modes de paiement, langues, etc.) et démarre.

4. Vérifier la synchronisation

Sur le maître, crée un produit test "TEST_SYNC". Sur l'esclave, ouvre la liste des produits → "TEST_SYNC" doit apparaître dans la seconde. Idem pour les ventes : une vente sur un esclave est visible immédiatement dans l'historique du maître.

Dépannage

"Connexion refusée" sur l'esclave

Causes possibles :

Pare-feu maître bloque : vérifie que la règle est bien créée. Sur le maître, en cmd admin :
```
netsh advfirewall firewall show rule name="PostgreSQL AuraPOS"
```
PostgreSQL pas démarré : services.msc → vérifier que postgresql-x64-18 est en cours d'exécution.
IP du maître changée : refais un ipconfig et compare avec ce que l'esclave a configuré.
Réseau différent : maître et esclave sur des sous-réseaux différents (ex: 192.168.1.x vs 192.168.0.x). Connecte-les au même switch / SSID.

Pas de mode hors-ligne : si l'esclave perd la connexion au maître, il ne peut plus encaisser. La résilience hors-ligne est prévue pour la version stable.
Pas de chiffrement TLS : la connexion PostgreSQL est en clair sur le LAN. Acceptable en réseau privé sécurisé, à éviter sur Wi-Fi public.
Sauvegardes uniquement sur le maître : seule la caisse maître exécute les sauvegardes auto (les esclaves n'ont pas de fichier .db local).

Astuces

Tester la connexion sans installer un esclave : depuis n'importe quelle machine du réseau, lance dans cmd : psql -h 192.168.1.10 -p 5432 -U aurapos -d aurapos (mot de passe 7312). Si ça ouvre un prompt aurapos=>, ton réseau et ton maître sont OK.
Migration mono → multi : si tu démarres en mono-poste et veux passer en multi plus tard, tes données SQLite sont automatiquement migrées vers PostgreSQL au moment du changement de mode dans Paramètres > Stockage.