> Index de la documentation : https://stilldeeppos.com/fr/llms.txt

# 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.

Source: https://stilldeeppos.com/fr/docs/hebergement

## 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é `/healthz` sur 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.