Requisitos do Sistema

Antes de instalar o HandyCafe na sua lan house, centro de jogos ou arena de esports, verifique se seu hardware e rede atendem aos requisitos a seguir.

Requisitos do PC Servidor

O servidor é sua estação de gestão. Este é o PC onde você executa o HandyCafe Server para monitorar e controlar toda a lan house.

Componente	Mínimo	Recomendado
Sistema Operacional	Windows 10+ (64 bits), macOS 12 Monterey+ ou Linux (64 bits)	Windows 10/11 (64 bits), macOS 12+ ou Linux (64 bits)
Processador	Dual-core 2,0 GHz	Quad-core 2,5 GHz+
RAM	4 GB	8 GB+
Espaço em Disco	500 MB (aplicativo)	2 GB+ (com gravações e capturas de tela)
Tela	1280 x 720	1920 x 1080+
Rede	Ethernet 100 Mbps	Ethernet Gigabit

Nota: Se você utiliza a área de trabalho remota com gravação de sessão, reserve espaço adicional em disco para gravações MP4 (aproximadamente 50-200 MB por hora de gravação dependendo da qualidade).

Nota sobre Linux: O HandyCafe é construído com Tauri v2, que utiliza WebKit2GTK no Linux. Você deve instalar o pacote libwebkit2gtk-4.1 antes de executar o aplicativo. As distribuições suportadas incluem Ubuntu 22.04+, Fedora 38+ e outras distribuições que fornecem uma versão equivalente do WebKit2GTK.

Requisitos do PC Cliente

Cada PC destinado aos clientes executa o HandyCafe Client, que se conecta ao servidor pela rede local.

Componente	Mínimo	Recomendado
Sistema Operacional	Windows 10+ (64 bits), macOS 12 Monterey+ ou Linux (64 bits)	Windows 10/11 (64 bits), macOS 12+ ou Linux (64 bits)
Processador	Dual-core 1,5 GHz	Quad-core 2,0 GHz+
RAM	2 GB	4 GB+
Espaço em Disco	200 MB	500 MB+
Rede	Ethernet 100 Mbps	Ethernet Gigabit

Nota: Estes são os requisitos apenas para o software HandyCafe Client. Seus PCs precisarão de recursos adicionais para os jogos e aplicativos que seus clientes utilizam.

Requisitos de Rede

Todos os PCs (servidor e clientes) devem estar na mesma rede local (LAN).

Portas Necessárias

Porta	Protocolo	Direção	Finalidade
5001	TCP	Servidor: entrada, Cliente: saída	Comunicação de comandos e respostas
5002	TCP	Bidirecional	Transferência de arquivos
5003	TCP	Servidor: entrada, Cliente: saída	Canal de controle de gerenciamento remoto
5004	UDP	Bidirecional	Streaming de tela (área de trabalho remota)

Importante: Estas são as portas padrão. Você pode alterá-las em Configurações de Rede. Se alterar as portas no servidor, atualize a configuração do cliente para corresponder.

Configuração de Firewall

Firewall do Windows: O HandyCafe tenta adicionar regras de firewall automaticamente durante a instalação. Se a configuração automática falhar, adicione manualmente regras de entrada para as portas listadas acima.
Firewall do macOS: Abra Ajustes do Sistema > Rede > Firewall e permita conexões de entrada para o HandyCafe. Como alternativa, adicione as portas listadas acima à sua lista de permissões do firewall.
Linux (iptables / ufw): Se usar ufw, execute sudo ufw allow 5001:5004/tcp e sudo ufw allow 5004/udp. Para iptables, adicione regras INPUT ACCEPT equivalentes para as portas TCP 5001-5003 e UDP 5004.
Firewalls de terceiros: Adicione exceções para o binário do servidor HandyCafe no PC servidor e para o binário do cliente HandyCafe nos PCs clientes.
Roteador/Switch: Nenhuma configuração especial é necessária para operação somente em LAN. Se você utiliza VLANs, garanta que o servidor e todos os clientes estejam na mesma VLAN ou que o roteamento permita as portas necessárias.

Descoberta de Clientes

O HandyCafe utiliza mDNS (DNS multicast) para descoberta automática de clientes na rede local. Isso requer:

Todos os PCs na mesma sub-rede
Tráfego multicast não bloqueado por switches ou roteadores
Se o mDNS não funcionar (por exemplo, entre sub-redes), os clientes podem se conectar inserindo o endereço IP do servidor manualmente

Considerações de Largura de Banda

Recurso	Largura de Banda Aproximada
Operação normal (por cliente)	< 1 Kbps
Streaming de área de trabalho remota	350 - 25.000 Kbps (configurável)
Transferência de sincronização de arquivos	Limitada pela velocidade da rede
Captura de tela	~100 KB por captura

Para uma lan house típica com 20-50 PCs, uma LAN padrão de 100 Mbps é suficiente. Ethernet Gigabit é recomendada se você utiliza área de trabalho remota para múltiplos PCs simultaneamente.

Requisitos de Consoles

Se você gerencia consoles de jogos (PlayStation, Xbox, etc.), os consoles devem estar na mesma rede que o servidor. Cada console é identificado pelo endereço MAC e registrado manualmente em Configurações de Consoles.