🎮
GestiónArena — Guía de Instalación
Cómo montar el sistema en un ciber desde cero, paso a paso.
Sistema de gestión de cibercafés · Caja + PCs + Nube
☁️
NUBE
(opcional) administrás
desde afuera
🖥️
CAJA (Servidor)
la compu madre
siempre prendida
💻
PCs Cliente
cada máquina
con el Agente
Todas las PCs y la caja van conectadas a la misma red (WiFi/cable del local).
0 Qué necesitás antes de empezar
- La caja (una PC que quede siempre prendida) y las PCs de los clientes, todas en la misma red (mismo WiFi o cableadas al mismo router).
- Los dos instaladores: CiberAgent-Servidor-Setup.exe y CiberAgent-Agente-Setup.exe.
- Saber la IP de la caja en la red (te enseño a sacarla en el paso 1).
- Poder entrar como administrador a cada PC (los instaladores lo piden).
⚠️ Importante sobre el antivirus y Windows
Como todavía no firmamos digitalmente el programa, van a pasar dos cosas normales:
- Windows va a avisar “Windows protegió tu PC”. Tocás “Más información” → “Ejecutar de todas formas”.
- Avast (u otro antivirus) puede marcar el agente. Hay que agregarle una excepción (te digo dónde en cada paso).
1 Instalar la CAJA (el servidor)
Esto se hace una sola vez, en la compu que va a ser la caja.
- Anotá la IP de la caja. Abrí el menú Inicio, escribí
cmd, y en la ventana negra escribí ipconfig y Enter. Buscá “Dirección IPv4” — es algo como 192.168.1.10. Anotala, la vas a usar en cada PC.
- Ejecutá CiberAgent-Servidor-Setup.exe. Si aparece el aviso azul de Windows → “Más información” → “Ejecutar de todas formas”. Aceptá el cartel de permisos (UAC).
- Seguí el asistente (Siguiente → Instalar). El instalador solo: instala el programa, abre el puerto en el firewall y deja el servidor arrancando automáticamente cada vez que prendas la caja.
- Antivirus: si tenés Avast, agregá una excepción para la carpeta C:\GestionArena (Avast → Menú → Configuración → Excepciones → Agregar).
- Abrí el panel de caja: en el navegador entrá a http://localhost:5005 y entrá con usuario dueno / clave 1234.
✅ Listo
El servidor ya queda funcionando y arranca solo al prender la caja. No hay que abrir nada a mano nunca más.
2 Instalar el AGENTE en cada PC cliente
Esto se repite en cada máquina de los clientes (PC-01, PC-02, …).
- Ejecutá CiberAgent-Agente-Setup.exe en la PC. (“Más información → Ejecutar de todas formas” + aceptar permisos.)
- En la pantalla de configuración completás 3 datos:
| Campo | Qué poner |
|---|
| Nombre de esta PC | PC-01 (en la siguiente PC: PC-02, y así) |
| Dirección de la caja | http://192.168.1.10:5005 ← la IP que anotaste en el paso 1 |
| Número de sucursal | 1 (si tenés varios locales, cada uno su número) |
- Antivirus: agregá la excepción para C:\GestionArena (igual que en la caja).
- Terminá la instalación. El agente queda configurado para arrancar solo cuando se inicie sesión en Windows: la PC se bloquea sola y se conecta a la caja.
- Repetí en cada PC cambiando solo el nombre (PC-02, PC-03…). La IP de la caja y la sucursal son iguales para todas.
💡 Para probar sin bloquearte
Durante una sesión, la salida de emergencia es
Ctrl +
Alt +
Shift +
Q.
✅ Verificá
Volvé al panel de la caja. La PC nueva tiene que
aparecer en el Tablero. Tocala →
Cobrar y habilitar → se desbloquea. ¡Funciona!
3 Primera configuración
Todo esto se hace desde el panel (http://localhost:5005), entrando como dueno. Andá a la pestaña Ajustes y a las demás.
- Cambiá las claves de fábrica (dueno y caja) por unas tuyas.
- Creá los empleados (Ajustes → Empleados) con su rol: Cajero (cobra pero no ve caja general ni ajustes), Encargado o Dueño.
- Cargá la tienda (pestaña Tienda): productos por rubro (Bebidas, Snacks…), precios y stock.
- Configurá los precios de los packs de tiempo (15 min, 1 h, 8 h…) en Tienda y Precios.
- Poné la imagen de la pantalla de bloqueo (Ajustes → Pantalla de bloqueo) — podés subir tu logo/publicidad.
- Elegí qué secciones se ven (Ajustes → Secciones habilitadas), por ejemplo ocultar “Vendedores” si no querés.
4 Conectar tu local a la nube
La nube te deja ver todos tus locales juntos desde tu casa o el celular, y es lo que hace funcionar la app de tus clientes. No hay que instalar ningún servidor: ya está andando en app.gestionarena.com.
- Entrá a app.gestionarena.com/registro.html y creá tu cuenta (nombre del ciber, mail, usuario y contraseña). Esto se hace una sola vez, no una por local.
- Al terminar vas a ver tu clave de conexión (empieza con ck-). Copiala.
- Cuando instalás la caja, el instalador te la pide: pegá esa clave y ponele un nombre a este local (ej: Centro). El instalador configura todo solo.
- ¿Tenés más de un local? Repetí la instalación en el otro con la misma clave y otro nombre (ej: Norte). Eso es lo único que los diferencia.
- Listo. La caja sincroniza sola cada 10 segundos y en tu panel vas a ver el local conectado. No hace falta avisar nada: el asistente de puesta en marcha se marca solo.
💡 Cada local es independiente
Aunque compartan la cuenta, cada local tiene
sus propias tarifas, sus empleados, su stock, sus cumpleaños y su caja. Lo único que se comparte es el panel donde los ves a los dos juntos.
✅ El local funciona igual sin internet
Si se corta internet, el ciber sigue operando normal. Cuando vuelve, sincroniza lo pendiente.
5 Actualizaciones (se hacen solas)
Cuando saquemos una versión nueva del sistema, no hay que ir a ningún local. Todo se actualiza solo al reiniciarse:
| Qué se actualiza | De dónde baja |
|---|
| El Agente (PCs cliente) | De su propia caja, al reiniciar la PC |
| El Servidor (la caja) | De la nube, al reiniciar la caja |
💡 Para el que administra (vos/nosotros)
Publicar una versión nueva es
un solo comando (
publicar-actualizacion.ps1 para el agente,
publicar-servidor.ps1 para la caja). Se propaga a todos los locales solo.
6 Problemas comunes
| Síntoma | Solución |
|---|
| Una PC no aparece en el panel | 1) ¿Está en la misma red que la caja? 2) ¿La IP de la caja en su config es correcta? 3) Firewall de la caja: que el instalador del servidor haya abierto el puerto 5005. |
| El panel no abre desde otra PC | Usá http://IP-de-la-caja:5005 (con http:// adelante). Probá ping IP-de-la-caja desde la otra PC; si no responde, están en redes distintas. |
| El antivirus borró el programa | Agregá la excepción (C:\GestionArena o C:\GestionArena) y reinstalá. Se soluciona del todo cuando firmemos el programa. |
| Quedé trabado en la pantalla de bloqueo | Ctrl+Alt+Shift+Q. O Ctrl+Alt+Del → Cerrar sesión. |
| Se deshabilitó el Administrador de tareas | En PowerShell: reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Policies\System" /v DisableTaskMgr /t REG_DWORD /d 0 /f |
7 Datos útiles
Claves de fábrica (cambialas después)
| Dónde | Usuario | Clave |
|---|
| Panel de caja / Nube | dueno | 1234 |
| Panel (cajero de prueba) | caja | 1234 |
| Cliente frecuente de ejemplo | martin | 1234 |
Direcciones y puertos
| Panel de caja | http://localhost:5005 (o http://IP-caja:5005 desde otra PC) |
| Panel de la nube | http://IP-o-dominio:6006 |
Atajos
| Salir del agente (emergencia) | Ctrl+Alt+Shift+Q |
| Carpetas de instalación | Caja: C:\GestionArena · Agente: C:\GestionArena |