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 e sua estacao de gestao. Este e o PC onde voce executa o HandyCafe Server para monitorar e controlar toda a lan house.

Componente	Minimo	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+
Espaco em Disco	500 MB (aplicativo)	2 GB+ (com gravacoes e capturas de tela)
Tela	1280 x 720	1920 x 1080+
Rede	Ethernet 100 Mbps	Ethernet Gigabit

Nota: Se voce utiliza a area de trabalho remota com gravacao de sessao, reserve espaco adicional em disco para gravacoes MP4 (aproximadamente 50-200 MB por hora de gravacao dependendo da qualidade).

Nota sobre Linux: O HandyCafe e construido com Tauri v2, que utiliza WebKit2GTK no Linux. Voce deve instalar o pacote libwebkit2gtk-4.1 antes de executar o aplicativo. As distribuicoes suportadas incluem Ubuntu 22.04+, Fedora 38+ e outras distribuicoes que fornecem uma versao 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	Minimo	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+
Espaco em Disco	200 MB	500 MB+
Rede	Ethernet 100 Mbps	Ethernet Gigabit

Nota: Estes sao os requisitos apenas para o software HandyCafe Client. Seus PCs precisarao 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 Necessarias

Porta	Protocolo	Direcao	Finalidade
5001	TCP	Servidor: entrada, Cliente: saida	Comunicacao de comandos e respostas
5002	TCP	Bidirecional	Transferencia de arquivos
5003	TCP	Servidor: entrada, Cliente: saida	Canal de controle de gerenciamento remoto
5004	UDP	Bidirecional	Streaming de tela (area de trabalho remota)

Importante: Estas sao as portas padrao. Voce pode altera-las em Configuracoes de Rede. Se alterar as portas no servidor, atualize a configuracao do cliente para corresponder.

Configuracao de Firewall

Firewall do Windows: O HandyCafe tenta adicionar regras de firewall automaticamente durante a instalacao. Se a configuracao automatica falhar, adicione manualmente regras de entrada para as portas listadas acima.
Firewall do macOS: Abra Ajustes do Sistema > Rede > Firewall e permita conexoes de entrada para o HandyCafe. Como alternativa, adicione as portas listadas acima a sua lista de permissoes 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 excecoes para o binario do servidor HandyCafe no PC servidor e para o binario do cliente HandyCafe nos PCs clientes.
Roteador/Switch: Nenhuma configuracao especial e necessaria para operacao somente em LAN. Se voce utiliza VLANs, garanta que o servidor e todos os clientes estejam na mesma VLAN ou que o roteamento permita as portas necessarias.

Descoberta de Clientes

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

Todos os PCs na mesma sub-rede
Trafego multicast nao bloqueado por switches ou roteadores
Se o mDNS nao funcionar (por exemplo, entre sub-redes), os clientes podem se conectar inserindo o endereco IP do servidor manualmente

Consideracoes de Largura de Banda

Recurso	Largura de Banda Aproximada
Operacao normal (por cliente)	< 1 Kbps
Streaming de area de trabalho remota	350 - 25.000 Kbps (configuravel)
Transferencia de sincronizacao de arquivos	Limitada pela velocidade da rede
Captura de tela	~100 KB por captura

Para uma lan house tipica com 20-50 PCs, uma LAN padrao de 100 Mbps e suficiente. Ethernet Gigabit e recomendada se voce utiliza area de trabalho remota para multiplos PCs simultaneamente.

Requisitos de Consoles

Se voce gerencia consoles de jogos (PlayStation, Xbox, etc.), os consoles devem estar na mesma rede que o servidor. Cada console e identificado pelo endereco MAC e registrado manualmente em Configuracoes de Consoles.