ElVendedorDocs

Requisitos de implementación

Hardware, sistema operativo, red y servicios que necesita cada pieza de ElVendedor antes de instalar en un cliente real.

Para implementadores4 min de lecturaActualizado el 16 de noviembre de 2026

Antes de ir a un cliente necesitas saber qué equipo aguanta cada pieza de ElVendedor y qué debe existir en su red. Esta página reúne los requisitos que sí están documentados en los repos y marca lo que todavía no se puede afirmar. Al terminar tendrás la lista de comprobación para la visita de instalación.

Resumen por pieza

Pieza Dónde vive Lo imprescindible
App móvil Teléfono o tablet Android APK de la versión vigente, cámara para escanear
App de escritorio PC con Windows o Linux Instalador propio (.exe, .deb, .rpm o ZIP)
Backend Servidor con PHP y base de datos PHP 8.2 o superior, HTTPS, cron
Red Local del cliente Internet para sincronizar; WiFi local para restaurante

App móvil

El cliente es Ionic/Angular con Capacitor 6; el flavor staging usa el sufijo .staging y convive con producción en el mismo teléfono.

Requisito Dato confirmado Nota
Sistema operativo minSdkVersion sale de rootProject.ext Ver cautela
RAM / almacenamiento No documentado en los repos Ver cautela
Cámara Permiso android.permission.CAMERA Escaneo de códigos y QR
Bluetooth BLUETOOTH_CONNECT (+ BLUETOOTH hasta Android 11) Impresora térmica y lectora
Archivos READ_MEDIA_IMAGES, READ/WRITE_EXTERNAL_STORAGE Importar y exportar Excel
Notificaciones POST_NOTIFICATIONS Avisos de licencia y descargas
APK universal splits.abi.universalApk true Un solo archivo sirve para todas las arquitecturas

Pendiente de validación

android/app/build.gradle toma minSdkVersion y targetSdkVersion de rootProject.ext, pero el variables.gradle que define esos valores no está en el repositorio. Tampoco hay una fuente que fije RAM y almacenamiento mínimos. Confirma el Android mínimo soportado y las cifras de memoria con el Lead de producto antes de prometerlas a un cliente.

App de escritorio

El escritorio es Electron 42 con Electron Forge. Se distribuye por plataforma:

Plataforma Artefacto Cuándo usarlo
Windows 10/11 el-vendedor-desktop-<version> Setup.exe (Squirrel) Instalación normal con accesos directos
Windows 10/11 ZIP win32-x64 Equipo sin permisos de administrador
Linux .deb (Debian/Ubuntu/Mint) y .rpm (Fedora/RHEL) Instalación por gestor de paquetes
Linux ZIP linux-x64 Cualquier distribución

Para construir esos paquetes el host necesita Node.js 22 o superior y npm ci. Según el sistema:

# Linux (Debian/Ubuntu): .deb y .rpm
sudo apt-get update && sudo apt-get install -y dpkg-dev fakeroot rpm
  • dpkg-deb y fakeroot son obligatorios para el .deb; rpmbuild (paquete rpm) solo para el .rpm.
  • El instalador Squirrel de Windows exige Windows o Linux con wine + mono; en Linux solo sale el ZIP portable.
  • La versión actual del escritorio es la 2.1.6 (package.json).

Pendiente de validación

No hay en los repos una cifra oficial de RAM, CPU o disco para el equipo del cliente. Los paquetes declaran solo las dependencias de Electron (GTK, NSS y similares en Linux). Valida el equipo mínimo con el Lead antes de fijarlo en un contrato.

Backend

El backend es Laravel 12 con Inertia, Fortify, Sanctum y PhpSpreadsheet (composer.json exige php: ^8.2).

Requisito Dato confirmado
PHP ^8.2 (el entorno de referencia declara 8.4.5)
Base de datos SQLite por defecto (DB_CONNECTION=sqlite); MySQL soportado
Extensiones pdo_mysql se consulta en config/database.php para MySQL
Frontend del backoffice Vite 7 + Vue 3: requiere npm run build
Colas QUEUE_CONNECTION=database
Tareas programadas routes/console.php declara tres comandos
Almacenamiento FILESYSTEM_DISK=local
HTTPS Obligatorio: los clientes hablan por https://

Las tareas que declara el repositorio son sync:prune-events --days=180 (semanal, domingo 03:00), inventory:expire-reservations (cada cinco minutos) y licensing:expire (diaria).

Red

  • Internet: no hace falta para vender, pero sí para licencias, sincronización y marketplace. Los clientes apuntan a una URL fija que se incrusta al empaquetar; para producción por defecto es el backend alojado y para staging el suyo.
  • LAN del restaurante: el escritorio es el hub local y escucha en el puerto 3897 (HTTP y WebSocket: /api/restaurant/* y /ws/restaurant). Todos los dispositivos deben estar en la misma WiFi y el firewall del PC debe permitir ese puerto.

Licencias

Cada negocio necesita una licencia vigente emitida desde el backend (/implementador/licencias/). El límite por defecto es de 3 activaciones (LICENSING_DEFAULT_ACTIVATIONS_LIMIT=3) y la gracia sin red es de 7 días (LICENSING_OFFLINE_GRACE_DAYS=7). Los equipos se registran por device_id, de modo que reinstalar no consume una ranura nueva.

Qué llevar a la visita de instalación

Elemento Detalle
APK vigente Misma versión que vas a registrar en el acta
Instalador de escritorio .exe/.deb/.rpm/ZIP con su SHA256SUMS.txt
URL del backend acordada La que quedará incrustada en el paquete
Acceso al backoffice Usuario administrador para confirmar licencia y pagos
Claves de licencia Pendientes de activación del cliente
Plantilla de inventario plantilla_importacion_inventario.xlsx del repo móvil
Impresora térmica 58 mm Si hay tickets; prueba de Bluetooth en el sitio
Red documentada Nombre de la WiFi, IP del escritorio y puerto 3897 libre
Respaldo y acta Respaldo inicial y registro de versiones instaladas

Siguiente paso

↑↓ para navegar · Enter para abrir · Esc para cerrar