Installer et exploiter un serveur StillDeep
Ce qui tourne sur le serveur du commerce et sur chaque poste, comment StillDeep se configure, où vivent les secrets et comment la santé se vérifie.
Sur le serveur du commerce
| Composant | Rôle | Portée |
|---|---|---|
| PostgreSQL 19 | Base de données, seule source de vérité | Serveur seulement |
| Server.Service | Passerelle gRPC des postes, proxy, hub | Réseau local |
| Admin | Application web de configuration | Réseau local |
| Rapports | Application web des rapports | Réseau local, Internet au choix |
| Service IA (optionnel) | StillDeep AI, modèles locaux | Serveur ou machine avec carte graphique |
PostgreSQL 19 est la version minimale. Les services se connectent avec des utilisateurs dédiés de la base, jamais le superutilisateur, et les postes ne se connectent jamais à la base.
Sur chaque poste
Un conteneur ou un programme natif avec l'écran, le moteur du poste et la copie SQLite locale. Les postes qui pilotent du matériel Windows (imprimantes thermiques, tiroirs-caisses) peuvent tourner en natif et lier les bibliothèques en direct.
Configuration
StillDeep suit les règles des douze facteurs :
- Configuration par variables d'environnement, jamais de chaîne de connexion dans les fichiers de configuration. Les secrets sont gardés chiffrés et injectés au démarrage ; sans eux, l'Admin ouvre sa page de mise en route.
- Journaux sur la sortie standard, avec OpenTelemetry pour les métriques et les traces.
- Une vérification de santé
/healthzsur chaque service. - Arrêt propre sur SIGTERM ou Ctrl+C.
Systèmes d'exploitation
Chaque service tourne sous Windows, Linux et macOS. L'emballage Docker et les mises à jour automatiques sont prévus ; d'ici là, les services tournent en natif.
Mises à jour et postes hors ligne
Un poste vide toujours sa file d'envoi avant une mise à jour : aucune vente n'est perdue. Les postes continuent de vendre pendant la mise à jour du serveur et rattrapent à son retour.
Sauvegardes
Le serveur du commerce détient toutes les données : sauvegardez sa base PostgreSQL avec les outils habituels. Les postes ne détiennent qu'une copie et leur file d'envoi.