Clients hérités

HandyCafe peut gérer des installations clientes V3 et V4 héritées aux côtés des clients modernes sur le même serveur. Les clients hérités apparaissent dans le panneau d'administration comme leur propre type de carte, avec un ensemble d'actions réduit qui correspond à ce que prend en charge le protocole d'origine.

Avant de voir les clients hérités dans le panneau d'administration, activez la prise en charge du runtime dans Paramètres > Clients hérités.

Comment les clients hérités apparaissent

Les clients hérités se connectent au serveur via le protocole multicast UDP d'origine. Ils n'utilisent pas mDNS comme les clients modernes. Le serveur les découvre donc de deux façons :

Chemin de découverte	Déclencheur
Connexion TCP	Le client envoie une LoginRequest sur le port de commande TCP. Le serveur enregistre le pair et émet un événement de connexion.
Ping UDP	Le client diffuse une trame Ping sur le groupe multicast. Le serveur la reçoit, met à jour l'enregistrement du pair et émet un événement en ligne.

L'état par MAC est conservé dans un stockage de clients hérités avec l'IP, le nom d'hôte, l'utilisateur connecté, la version du client, les minuteries de session et l'horodatage de dernière activité. Chaque trame entrante réinitialise le minuteur d'inactivité. Si le minuteur expire sans trafic (10 secondes par défaut), le client est marqué hors ligne. L'enregistrement reste dans la base de données afin de ne pas perdre l'historique.

Carte du client hérité

Chaque client hérité s'affiche sous forme de carte distincte des cartes de clients modernes. L'en-tête affiche le nom d'affichage (nom d'hôte lorsqu'il est disponible, MAC sinon), un badge en ligne ou hors ligne avec sa couleur, ainsi qu'un libellé d'état.

Couleurs et libellés de statut

Statut	Couleur	Signification
En ligne	Vert	Une session active est en cours.
Inactif	Cyan	Le client est connecté et en attente. Aucune session n'est active.
En pause	Ambre	La session est en pause. La facturation est interrompue.
Occupé	Violet	Le client traite une demande.
Paiement	Rose	Le client est dans un flux de paiement.
Admin	Indigo	Le client est en mode administration ou maintenance.
Hors ligne	Gris	Aucun trafic récent. Les actions sont désactivées jusqu'au retour du client en ligne.
Temporisé	Bleu ciel	Une session à durée limitée est en cours avec une échéance.

Horloge de session

Lorsqu'une session est active, la carte affiche un bloc d'horloge :

Heure de début.
Heure de fin (pour les sessions à durée limitée).
Minutes utilisées.
Minutes restantes avec compte à rebours en direct.
Coût cumulé.

Informations d'identité

La carte affiche toujours :

Adresse MAC.
Adresse IP.
Version du client (par exemple "3.4.01").
Utilisateur connecté s'il y en a un.

Barre d'actions

Lorsque le client est en ligne, une barre d'actions sous les informations d'identité propose les opérations disponibles.

Contrôle de session

Bouton	Visible lorsque	Comportement
Login	Le statut est inactif	Ouvre la boîte de dialogue Device Login. Sélectionnez les minutes et le mode de paiement. Le serveur envoie une commande Login avec les valeurs choisies. La session démarre sur le client.
Logout	Le statut est en ligne, temporisé, en pause, occupé ou paiement	Si la session est postpayée, une boîte de paiement collecte le montant et le mode. Une transaction est écrite dans le grand livre. Le serveur envoie une commande Logout. La session se termine sur le client.

Ajouter du temps

Ouvre un sélecteur de minutes. Accepte les valeurs positives (prolonger) ou négatives (déduire). La magnitude maximale est de 10 000 minutes dans chaque sens. Fonctionne pour les sessions prépayées comme postpayées.

Si vous avez configuré des valeurs de minutes prédéfinies dans vos paramètres de tarification, la carte affiche aussi une rangée de boutons prédéfinis. Touchez un preset pour appliquer la valeur sans ouvrir le sélecteur.

Capture d'écran

Demande une capture d'écran en direct au client hérité via le port de transfert de fichiers. Le flux est le suivant :

Le serveur envoie une commande de demande de capture d'écran.
Le client ouvre un écouteur TCP de courte durée sur un port éphémère.
Le serveur se connecte, envoie un en-tête de transfert de fichiers de 9 octets et attend.
Le client capture l'écran, l'encode en BMP compressé et le renvoie en flux.
Le serveur décompresse le BMP et l'enregistre dans le dossier legacy_screenshots sous votre répertoire de données HandyCafe.
La visionneuse de captures d'écran s'ouvre avec la nouvelle image.

Si le client ne répond pas dans le délai imparti (30 secondes par défaut pour la connexion, 20 secondes pour les données), la demande échoue et un message d'erreur apparaît. Vous pouvez réessayer immédiatement.

Actions d'alimentation

Action	Confirmation	Effet
Logoff	Aucune	Déconnecte l'utilisateur Windows sur la machine client. La session Windows se termine mais l'ordinateur reste allumé.
Reboot	Oui	Envoie une commande de redémarrage. La machine cliente redémarre.
Shutdown	Oui	Envoie une commande d'arrêt. La machine cliente s'éteint.

Reboot et Shutdown affichent une boîte de confirmation pour éviter des actions d'alimentation accidentelles.

Opérations non prises en charge

Les clients hérités ne prennent pas en charge toutes les fonctionnalités disponibles sur les clients HandyCafe modernes. Principales différences :

Pas d'ajustement de pause en cours de session. Les changements de temps envoyés pendant que la session est en pause sont mis en file d'attente, mais le client peut les ignorer. Reprenez d'abord la session, appliquez le changement, puis remettez-la en pause si besoin.
Pas de mode Admin via commande serveur. L'état admin interne du client ne peut pas être basculé depuis le serveur. Le mode Admin se contrôle uniquement sur la machine cliente elle-même.
Pas d'enregistrement de licence depuis le serveur. Le serveur reflète les octets de licence qu'il voit dans les trames client, mais ne peut pas pousser une nouvelle licence vers le client. Enregistrez le client localement.
Pas d'intégration du portefeuille membre pour les sessions lancées sur des clients hérités. Les paiements sont enregistrés comme de simples lignes transactions avec transaction_type=sessions et la MAC du client. Les flux de portefeuille modernes ne s'appliquent pas.
Pas de bureau à distance. La fonctionnalité de bureau à distance utilise un chemin de diffusion UDP absent des clients hérités.
Pas de poussée de synchronisation de fichiers. Sync Explorer pousse les fichiers uniquement via le protocole moderne.

Pour bénéficier de toutes les fonctionnalités, migrez vers les clients HandyCafe modernes lorsque c'est possible.

Comportement hors ligne

Lorsque le délai d'inactivité expire, la carte s'assombrit, le badge de statut devient gris et tous les boutons d'action sont désactivés. L'enregistrement du client reste dans le stockage afin de préserver l'historique, la MAC, le nom d'hôte et les dernières données vues. Lorsque le client revient en ligne (nouveau ping UDP ou connexion TCP), la carte reprend vie et les actions redeviennent disponibles.

L'enregistrement n'est pas supprimé automatiquement. Pour supprimer définitivement un ancien client, modifiez-le depuis la base d'administration ou supprimez-le via l'outil d'administration approprié.

Conseils

Conservez le délai d'inactivité à 10 secondes sauf si vous savez que vos clients hérités émettent leurs beacons plus lentement. Un délai trop court marque à tort des clients sains comme hors ligne lors de brèves coupures réseau.
Si un client hérité apparaît en ligne mais ne répond pas aux commandes, vérifiez la variante du protocole dans les paramètres. Une incompatibilité entre la variante serveur (STE contre Standard) et la build du client provoque des commandes silencieusement ignorées.
Les captures d'écran des clients hérités sont des BMP compressés, donc plus volumineux que les captures PNG modernes. Gardez le dossier legacy_screenshots sur un disque disposant d'assez d'espace libre si vous prenez beaucoup de captures.
Utilisez Ajouter du temps avec les boutons prédéfinis pendant les transitions de quart. Un seul toucher prolonge une session d'un incrément défini, ce qui est plus rapide que de saisir les minutes manuellement.
Retirez progressivement les clients hérités. Migrez un lot à la fois, vérifiez que les nouveaux clients se comportent exactement pareil dans le panneau d'administration, puis seulement ensuite retirez les anciens.