Proyecto · En producción
Punto de venta de escritorio con cocina, inventario y producción
Gorditas Ranitas opera sus sucursales con un punto de venta de escritorio hecho en Electron: caja, pantalla de cocina, inventario, procesos de producción con rendimiento y estadísticas. Cada caja sigue vendiendo aunque se caiga el internet y se actualiza desde su propio canal de versiones.
Escríbenos por WhatsAppVer todos los proyectos01
Ficha del proyecto.
- Cliente
- Gorditas Ranitas
- Industria
- Restaurantes & Alimentos
- Inicio
- 2026
- Duración
- En operación
- Estado
- En producción
- Qué hicimos
- Producto · Escritorio · Backend · Sincronización · Despliegue
Tecnología
- TypeScript
- Node.js
- Express.js
- Electron
- SQLite
- Supabase
- PostgreSQL
- Socket.IO
- WebRTC
- electron-updater
- Apipos
02
El reto y la solución.
Lo que encontramos y lo que construimos.
El reto
En Gorditas Ranitas buena parte de lo que se vende se prepara en la sucursal: se fríe el pollo, la masa se vuelve gorditas y el guiso se rehidrata. El punto de venta tenía que cobrar y mandar las órdenes a cocina aunque fallara el internet, y además medir cuánto rinde lo que se produce y explicar en cada corte de inventario de dónde sale el faltante.
La solución
Construimos un punto de venta con Express.js empaquetado en Electron para Windows y macOS. En la sucursal, la caja principal trabaja sobre una base SQLite local y sincroniza con Supabase en segundo plano; las otras cajas, la pantalla de cocina y las tabletas se conectan a ella por la red local. El sistema cubre caja y cortes, comandas y flujos de preparación, inventario por ubicación, procesos de producción con rendimiento esperado por proveedor y estadísticas con metas semanales.
- Sin internet
- la caja vende contra su base local y sincroniza después
- 3 sucursales
- en la misma franquicia
- Por proveedor
- rendimiento esperado contra obtenido en cada corrida
- Windows y macOS
- instaladores con actualización automática
03
Retos puntuales que resolvimos.
Donde el problema era de verdad difícil.
- 01
Venta sin conexión con varias cajas
La caja principal de cada sucursal guarda órdenes, pagos y caja en SQLite y sube los cambios a Supabase cuando hay internet. Las cajas secundarias se vinculan a ella con un código y sincronizan por la red local, o trabajan como cliente simplificado que solo muestra la pantalla de la principal. Los eventos en vivo viajan por Socket.IO y WebRTC.
- Sin internet, la venta sigue
- 02
Pantalla de cocina y flujos de preparación
Cada producto puede recorrer una ruta de estaciones, por ejemplo freidora, empaque y pase. El ticket lleva un QR que se escanea en cada estación, y el sistema rechaza el escaneo si el ticket llega antes de tiempo. El diseño permite dar de alta un flujo nuevo sin programar: todos usan las mismas tablas, la misma API y la misma pantalla.
- QR por estación
- 03
Procesos de producción y rendimiento
Freír, hacer gorditas, hidratar, descongelar y congelar se capturan en la misma pantalla. Cada proceso se mide contra un insumo o contra todo lo que entra, como porcentaje o como piezas por kilo. El rendimiento esperado puede variar por proveedor, y el proveedor se toma del lote que se usó, no de lo que alguien declare.
- Rendimiento por corrida y por proveedor
- 04
Inventario, merma y corte
Inventario por ubicación dentro de la sucursal, transferencias, órdenes de compra y su recepción, conteos y merma con motivo. En el corte se cuenta el físico y el sistema compara contra lo que el consumo debió ser según lo vendido, separando el faltante que tiene explicación del que no la tiene.
- Faltante explicado en cada corte
- 05
Impresión desde cada caja
La impresión pasa por Apipos, un agente local que expone por HTTP las tiqueteras y etiqueteras de la máquina. La app limpia el texto de cada ticket y, si la impresora lo necesita, puede imprimir sin acentos ni eñes con un interruptor por dispositivo.
- Tiquetera y etiquetera por caja
- 06
Estadísticas y metas de la semana
La pantalla de inicio muestra el avance de la meta semanal de la etiqueta que defina la franquicia, como gorditas vendidas, con su desglose por día. Las estadísticas separan las ventas del consumo interno del personal para que la comida del equipo no infle las cifras.
- Ventas separadas del consumo interno
04
El caso completo.
El problema
Gorditas Ranitas prepara en cada sucursal casi todo lo que vende: fríe pollo, guisa, hace gorditas en el comal, rehidrata y congela. Eso convierte al punto de venta en algo más que una caja:
- La venta no se puede detener si se cae el internet de la sucursal.
- Las órdenes tienen que llegar a cocina y avanzar por varias estaciones.
- Lo que se produce rinde distinto según el proveedor del insumo.
- En el corte de inventario hay que explicar el faltante: cuánto fue merma registrada, cuánto fue porción y cuánto no tiene explicación.
- Con varias sucursales, cada una necesita sus cajas, sus ubicaciones y sus metas.
Lo que construimos
Un punto de venta de escritorio con un solo código para la nube y para la sucursal:
- En la nube, el backend Express.js trabaja directo contra Supabase y sirve la administración.
- En la sucursal, la misma app empaquetada en Electron opera sobre SQLite y sincroniza con un outbox y lecturas por deltas.
- Caja con aperturas, movimientos, cortes y ajustes, varios métodos de pago y promociones.
- Pantalla de cocina, flujos de preparación con QR y tiempos por etapa.
- Inventario por ubicación, compras, transferencias, conteos, merma y recetas.
- Procesos de producción con rendimiento esperado, tolerancias y atribución por proveedor, con un manual dentro del mismo sistema.
- Estadísticas, metas semanales y separación del consumo interno.
- Instaladores para Windows y macOS, este último firmado y notarizado.
Cómo trabajamos con Gorditas Ranitas
- Producto: los manuales de caja y de rendimiento están escritos en el orden en que pasan las cosas en la sucursal y se revisan contra el código.
- Backend: Node.js, Express.js y TypeScript en capas, con Supabase y PostgreSQL en la nube y SQLite en cada caja.
- Sincronización: caja principal y secundarias en cascada por la red local, descubrimiento con mDNS y eventos en vivo por Socket.IO y WebRTC.
- Despliegue: las versiones se publican en un repositorio de releases. Con la actualización automática encendida, la caja revisa al abrir y cada seis horas, pregunta antes de descargar y nunca reinicia sin confirmación.
El sistema está en producción en las sucursales de Gorditas Ranitas y recibe versiones nuevas por su canal de actualizaciones.