Requisitos del sistema

Antes de instalar HandyCafe en su cibercafé, 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 estación de gestión. Este es el PC donde ejecuta HandyCafe Server para monitorear y controlar todo el café.

Componente	Mínimo	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 núcleo 2.0 GHz	Cuatro núcleos 2.5 GHz+
RAM	4 GB	8 GB+
Espacio en disco	500 MB (aplicación)	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 grabación de sesión, asigne espacio en disco adicional para grabaciones MP4 (aproximadamente 50-200 MB por hora de grabación dependiendo de la calidad).

Nota sobre Linux: HandyCafe está construido con Tauri v2 que usa WebKit2GTK en Linux. Debe instalar el paquete de ejecución libwebkit2gtk-4.1 antes de ejecutar la aplicación. Las distribuciones soportadas incluyen Ubuntu 22.04+, Fedora 38+ y otras distribuciones que incluyan una versión equivalente de WebKit2GTK.

Requisitos del PC cliente

Cada PC de uso público ejecuta HandyCafe Client, que se conecta al servidor a través de la red local.

Componente	Mínimo	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 núcleo 1.5 GHz	Cuatro núcleos 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 necesitarán 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	Dirección	Propósito
5001	TCP	Servidor: entrante, Cliente: saliente	Comunicación de comandos y respuestas
5002	TCP	Bidireccional	Transferencia de archivos
5003	TCP	Servidor: entrante, Cliente: saliente	Canal de control de gestión remota
5004	UDP	Bidireccional	Transmisión de pantalla (escritorio remoto)

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

Configuración de firewall

Firewall de Windows: HandyCafe intenta agregar reglas de firewall automáticamente durante la instalación. Si la configuración automática 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 configuración especial para operación solo en LAN. Si tiene VLANs, asegúrese de que el servidor y todos los clientes estén en la misma VLAN o que el enrutamiento permita los puertos requeridos.

Detección de clientes

HandyCafe usa mDNS (DNS multicast) para la detección automática de clientes en la red local. Esto requiere:

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

Consideraciones de ancho de banda

Función	Ancho de banda aproximado
Operación normal (por cliente)	< 1 Kbps
Transmisión de escritorio remoto	350 - 25,000 Kbps (configurable)
Transferencia de sincronización de archivos	Limitado por la velocidad de red
Captura de pantalla	~100 KB por captura

Para un café típico con 20-50 PCs, una LAN estándar de 100 Mbps es suficiente. Se recomienda Gigabit Ethernet si usa frecuentemente el escritorio remoto para múltiples PCs simultáneamente.

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 dirección MAC y se registra manualmente en Configuración de consolas.