Requisitos del sistema

Antes de instalar HandyCafe en su cibercafe, centro de gaming o arena de esports, verifique que su hardware y red cumplan los siguientes requisitos.

Requisitos del PC servidor

El servidor es su estacion de gestion. Este es el PC donde ejecuta HandyCafe Server para monitorear y controlar todo el cafe.

Componente	Minimo	Recomendado
Sistema operativo	Windows 10+ (64 bits), macOS 12 Monterey+ o Linux (64 bits)	Windows 10/11 (64 bits), macOS 12+ o Linux (64 bits)
Procesador	Doble nucleo 2.0 GHz	Cuatro nucleos 2.5 GHz+
RAM	4 GB	8 GB+
Espacio en disco	500 MB (aplicacion)	2 GB+ (con grabaciones y capturas de pantalla)
Pantalla	1280 x 720	1920 x 1080+
Red	100 Mbps Ethernet	Gigabit Ethernet

Nota: Si usa escritorio remoto con grabacion de sesion, asigne espacio en disco adicional para grabaciones MP4 (aproximadamente 50-200 MB por hora de grabacion dependiendo de la calidad).

Nota sobre Linux: HandyCafe esta construido con Tauri v2 que usa WebKit2GTK en Linux. Debe instalar el paquete de ejecucion libwebkit2gtk-4.1 antes de ejecutar la aplicacion. Las distribuciones soportadas incluyen Ubuntu 22.04+, Fedora 38+ y otras distribuciones que incluyan una version equivalente de WebKit2GTK.

Requisitos del PC cliente

Cada PC de uso publico ejecuta HandyCafe Client, que se conecta al servidor a traves de la red local.

Componente	Minimo	Recomendado
Sistema operativo	Windows 10+ (64 bits), macOS 12 Monterey+ o Linux (64 bits)	Windows 10/11 (64 bits), macOS 12+ o Linux (64 bits)
Procesador	Doble nucleo 1.5 GHz	Cuatro nucleos 2.0 GHz+
RAM	2 GB	4 GB+
Espacio en disco	200 MB	500 MB+
Red	100 Mbps Ethernet	Gigabit Ethernet

Nota: Estos son los requisitos solo para el software HandyCafe Client. Sus PCs necesitaran recursos adicionales para los juegos y aplicaciones que usen sus clientes.

Requisitos de red

Todos los PCs (servidor y clientes) deben estar en la misma red local (LAN).

Puertos requeridos

Puerto	Protocolo	Direccion	Proposito
5001	TCP	Servidor: entrante, Cliente: saliente	Comunicacion de comandos y respuestas
5002	TCP	Bidireccional	Transferencia de archivos
5003	TCP	Servidor: entrante, Cliente: saliente	Canal de control de gestion remota
5004	UDP	Bidireccional	Transmision de pantalla (escritorio remoto)

Importante: Estos son los puertos predeterminados. Puede cambiarlos en Configuracion de red. Si cambia los puertos en el servidor, actualice la configuracion del cliente para que coincida.

Configuracion de firewall

Firewall de Windows: HandyCafe intenta agregar reglas de firewall automaticamente durante la instalacion. Si la configuracion automatica falla, agregue manualmente reglas de entrada para los puertos listados arriba.
Firewall de macOS: Abra Ajustes del sistema > Red > Firewall y permita conexiones entrantes para HandyCafe. Alternativamente, agregue los puertos listados arriba a su lista de permisos del firewall.
Linux (iptables / ufw): Si usa ufw, ejecute sudo ufw allow 5001:5004/tcp y sudo ufw allow 5004/udp. Para iptables directo, agregue reglas equivalentes INPUT ACCEPT para los puertos TCP 5001-5003 y el puerto UDP 5004.
Firewalls de terceros: Agregue excepciones para el binario del servidor HandyCafe en el PC servidor y el binario del cliente HandyCafe en los PCs cliente.
Router/Switch: No se necesita configuracion especial para operacion solo en LAN. Si tiene VLANs, asegurese de que el servidor y todos los clientes esten en la misma VLAN o que el enrutamiento permita los puertos requeridos.

Deteccion de clientes

HandyCafe usa mDNS (DNS multicast) para la deteccion automatica de clientes en la red local. Esto requiere:

Todos los PCs en la misma subred
El trafico multicast no bloqueado por switches o routers
Si mDNS no funciona (por ejemplo, entre subredes), los clientes pueden conectarse ingresando la direccion IP del servidor manualmente

Consideraciones de ancho de banda

Funcion	Ancho de banda aproximado
Operacion normal (por cliente)	< 1 Kbps
Transmision de escritorio remoto	350 - 25,000 Kbps (configurable)
Transferencia de sincronizacion de archivos	Limitado por la velocidad de red
Captura de pantalla	~100 KB por captura

Para un cafe tipico con 20-50 PCs, una LAN estandar de 100 Mbps es suficiente. Se recomienda Gigabit Ethernet si usa frecuentemente el escritorio remoto para multiples PCs simultaneamente.

Requisitos de consolas

Si gestiona consolas de juego (PlayStation, Xbox, etc.), las consolas deben estar en la misma red que el servidor. Cada consola se identifica por su direccion MAC y se registra manualmente en Configuracion de consolas.