Requisitos de implementación
Hardware, sistema operativo, red y servicios que necesita cada pieza de ElVendedor antes de instalar en un cliente real.
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 rpmdpkg-debyfakerootson obligatorios para el.deb;rpmbuild(paqueterpm) 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
¿Falta algo o encontraste un error?
Ayúdanos a mejorar esta documentación con tu experiencia real.
Escribir a soporte