Configuration système requise

Avant d'installer HandyCafe dans votre cybercafé, centre de jeux ou arène d'esports, vérifiez que votre matériel et votre réseau répondent aux exigences suivantes.

Configuration requise pour le PC serveur

Le serveur est votre station de gestion. Il s'agit du PC sur lequel vous exécutez HandyCafe Server pour surveiller et contrôler l'ensemble du café.

Composant	Minimum	Recommandé
Système d'exploitation	Windows 10+ (64 bits), macOS 12 Monterey+ ou Linux (64 bits)	Windows 10/11 (64 bits), macOS 12+ ou Linux (64 bits)
Processeur	Double cœur 2,0 GHz	Quadcœur 2,5 GHz+
RAM	4 Go	8 Go+
Espace disque	500 Mo (candidature)	2 Go+ (avec enregistrements et captures d'écran)
Affichage	1280 x 720	1920 x 1080+
Réseau	Ethernet 100 Mbit/s	Gigabit Ethernet

Remarque : Si vous utilisez un bureau à distance avec enregistrement de session, allouez de l'espace disque supplémentaire pour les enregistrements MP4 (environ 50 à 200 Mo par heure d'enregistrement en fonction de la qualité).

Remarque Linux : HandyCafe est construit avec Tauri v2 qui utilise WebKit2GTK sous Linux. Vous devez installer le package d'exécution libwebkit2gtk-4.1 avant d'exécuter l'application. Les distributions prises en charge incluent Ubuntu 22.04+, Fedora 38+ et d'autres distributions livrant une version équivalente de WebKit2GTK.

Configuration requise pour le PC client

Chaque PC orienté client exécute HandyCafe Client, qui se connecte au serveur via le réseau local.

Composant	Minimum	Recommandé
Système d'exploitation	Windows 10+ (64 bits), macOS 12 Monterey+ ou Linux (64 bits)	Windows 10/11 (64 bits), macOS 12+ ou Linux (64 bits)
Processeur	Double cœur 1,5 GHz	Quadcœur 2,0 GHz+
RAM	2 Go	4 Go+
Espace disque	200 Mo	500 Mo+
Réseau	Ethernet 100 Mbit/s	Gigabit Ethernet

Remarque : Il s'agit uniquement de la configuration requise pour le logiciel HandyCafe Client. Vos PC auront besoin de ressources supplémentaires pour les jeux et applications utilisés par vos clients.

Configuration réseau requise

Tous les PC (serveur et clients) doivent être sur le même réseau local (LAN).

Ports requis

Port	Protocole	Itinéraire	Objectif
5001	TCP	Serveur : entrant, Client : sortant	Communication de commandement et de réponse
5002	TCP	Bidirectionnel	Transferts de fichiers
5003	TCP	Serveur : entrant, Client : sortant	Canal de contrôle de gestion à distance
5004	UDP	Bidirectionnel	Streaming d'écran (bureau à distance)

Important : Ce sont les ports par défaut. Vous pouvez les modifier dans Paramètres réseau. Si vous modifiez les ports sur le serveur, mettez à jour la configuration client en conséquence.

Configuration du pare-feu

Pare-feu Windows : HandyCafe tente d'ajouter automatiquement des règles de pare-feu lors de l'installation. Si la configuration automatique échoue, ajoutez manuellement des règles entrantes pour les ports répertoriés ci-dessus.
Pare-feu macOS : Ouvrez Paramètres système > Réseau > Pare-feu et autorisez les connexions entrantes pour HandyCafe. Vous pouvez également ajouter les ports répertoriés ci-dessus à la liste autorisée de votre pare-feu.
Linux (iptables / ufw) : Si vous utilisez ufw, exécutez sudo ufw allow 5001:5004/tcp et sudo ufw allow 5004/udp. Pour le iptables brut, ajoutez des règles INPUT ACCEPT équivalentes pour les ports TCP 5001-5003 et le port UDP 5004.
Pare-feu tiers : Ajoutez des exceptions pour le binaire du serveur HandyCafe sur le PC serveur et le binaire client HandyCafe sur les PC clients.
Routeur/Switch : Aucune configuration spéciale n'est nécessaire pour un fonctionnement LAN uniquement. Si vous disposez de VLAN, assurez-vous que le serveur et tous les clients sont sur le même VLAN ou que le routage autorise les ports requis.

Découverte de clients

HandyCafe utilise mDNS (DNS multicast) pour la découverte automatique des clients sur le réseau local. Cela nécessite :

Tous les PC sur le même sous-réseau
Trafic multicast non bloqué par les commutateurs ou les routeurs
Si mDNS ne fonctionne pas (par exemple, sur les sous-réseaux), les clients peuvent se connecter en saisissant manuellement l'adresse IP du serveur.

Considérations relatives à la bande passante

Fonctionnalité	Bande passante approximative
Fonctionnement normal (par client)	< 1 Kbit/s
Streaming de bureau à distance	350 - 25 000 Kbit/s (configurable)
Transfert de synchronisation de fichiers	Limité par la vitesse du réseau
Capture d'écran	~100 Ko par capture d'écran

Pour un café typique avec 20 à 50 PC, un réseau local standard de 100 Mbps est suffisant. Gigabit Ethernet est recommandé si vous utilisez fréquemment un bureau à distance pour plusieurs PC simultanément.

Configuration requise pour la console

Si vous gérez des consoles de jeux (PlayStation, Xbox, etc.), les consoles doivent être sur le même réseau que le serveur. Chaque console est identifiée par son adresse MAC et enregistrée manuellement dans Paramètres de la console.