Requisitos técnicos
Este documento describe los requisitos de hardware, red y dispositivos para operar el sistema.
Servidor
| Componente | Mínimo recomendado |
|---|
| CPU | 2 vCPU |
| Memoria | 2 GB RAM |
| Disco | 20 GB SSD (sistema + base de datos) |
| SO | Ubuntu 22.04 o superior (64 bits) |
| Runtime | Node.js 20+ |
| Base de datos | PostgreSQL 16+ |
| Proceso | PM2 (application manager) + Nginx con TLS 1.3 |
- El servidor debe tener dominio propio con certificado HTTPS (el sistema requiere navegación segura).
- La base de datos vive en el mismo servidor o en uno interno; la conexión nunca es pública sin cifrado.
Red
- Acceso a internet del dominio: salidas de datos desde el VPS y puertos/seguridad del entorno del proveedor.
- Latencia aceptable para uso móvil (países con 3G/4G).
- El sistema funciona en línea; los vendedores necesitan internet para registrar y consultar tickets.
Dispositivos de los vendedores
- Cualquier celular o computadora con navegador moderno (Chrome, Edge, Firefox o Safari actualizados).
- Se recomienda un celular por vendedor para ventas en calle.
- No se requiere instalar ninguna aplicación; el acceso es por el navegador.
- El dispositivo debe estar conectado al internet (móvil o Wi-Fi).
Impresora térmica
| Especificación | Valor |
|---|
| Tipo | Impresora térmica de tickets (recibo) |
| Ancho soportado | 58 mm (34 columnas) o 80 mm (50 columnas) |
| Conexión | USB, Bluetooth o de red (según el modelo) |
| Configuración | En el sistema: Conf. Impresión (ancho y prueba) |
⚠️ La impresora se instala en el dispositivo desde el que imprime el administrador o supervisor (no en los celulares de los vendedores).
Navegadores compatibles
| Navegador | Versión |
|---|
| Google Chrome | 100+ |
| Mozilla Firefox | 100+ |
| Microsoft Edge | 100+ |
| Safari (iOS/macOS) | 15+ |
Recurso humanos sugeridos
| Perfil | Cantidad recomendada |
|---|
| Administrador | 1–2 |
| Supervisor | 1 por grupo de vendedores |
| Vendedores | Los que acuerde el negocio |
Ejemplo de entorno de producción
- Dominio:
https://loto.<cliente>.com
- Servidor: VPS con Docker/Dockploy (deploy automático desde el repositorio en la rama
Master-Plus)
- Base de datos: PostgreSQL en el mismo servidor.
- Copia de seguridad: copia diaria automática (ver 06-backup-restauracion.md).