Concepts de base de StillDeep
Le vocabulaire de StillDeep : serveur du commerce, postes, quarts, paniers, ventes, file d'envoi, numéros imprimés, proxy et modules.
Serveur du commerce
Un serveur par commerce, sur son réseau local. Il porte la base PostgreSQL (seule source de vérité), la passerelle gRPC des postes (Server.Service) et les applications web Admin et Rapports. Chaque commerce possède son serveur et ses données.
Poste
Un point de vente : une caisse tactile, une borne, une tablette ou une boutique web. Un poste a sa propre identité, ses propres permissions et sa propre copie SQLite des données de référence (catalogue, taxes, membres). Il ne se connecte jamais à la base : chaque opération passe par le proxy du serveur du commerce.
Écran
Ce que voient le caissier ou le client. L'écran est un client du moteur du poste, en gRPC ou en direct pour .NET. Il ne porte aucune règle d'affaires : il affiche ce que le moteur rend.
Quart
La période de travail d'un employé sur les postes : ouvert par badge ou mot de passe, mis en pause et repris, déplacé au besoin vers un autre poste, puis fermé avec un comptage de caisse. Chaque paiement compte au quart qui l'a encaissé.
Panier et vente
Un panier réunit articles, client, rabais, frais et paiements. Le moteur de vente applique les mêmes règles sur tous les postes. Quand le panier est finalisé, la vente est écrite localement puis envoyée au serveur, qui revérifie prix, taxes et totaux.
File d'envoi
La table locale des ventes et opérations pas encore envoyées au serveur. Un travailleur en arrière-plan la vide, et un poste la vide toujours en premier au démarrage, avant toute mise à jour, pour qu'une mise à jour n'efface jamais des ventes non envoyées.
Mode hors ligne
Quand le serveur est injoignable, le poste vend depuis sa copie locale. Les paiements par carte fonctionnent si le terminal joint son processeur. Le stock et les places limitées ne sont garantis qu'en ligne ; une vente rejouée depuis la file d'envoi n'est jamais refusée.
Numéros imprimés
Les reçus, billets, réservations et quarts portent un numéro court et lisible : deux lettres, le poste, puis une séquence (par exemple RE5000123). Deux postes n'impriment jamais le même numéro, même hors ligne.
Modules et extensions
Les modules d'affaires (billetterie, détail, location, services, réservations, cartes) sont compilés dans le moteur et activés pour le commerce. Les extensions sont des paquets .NET distincts qui ajoutent des règles, des sections de l'Admin et des pages ; elles s'installent depuis l'Admin et le serveur du commerce les distribue aux postes.
Argent et quantités
Les montants sont en cents entiers, les pourcentages en points de base, les quantités fractionnaires en décimales. StillDeep n'utilise jamais de nombres à virgule flottante pour l'argent, les taxes ou les quantités.