Self Help Documentation
< All Topics
Print

4. GuideIt Kiosk: Arquitectura

Posted9 de October de 2025
Updated9 de October de 2025
Bymotiondisplays.com

4.1 Visión General

Guide It Kiosk se construye sobre una arquitectura cloud-first y serverless, pensada para ser escalable, segura y fácil de desplegar en múltiples tiendas.

  • Frontend: aplicación web responsive en React, compatible con pantallas táctiles, tablets, POS y navegadores móviles.
  • Backend: servicios en Node.js soportados por Firebase/Firestore/Cloud Functions, con lógica serverless y alta disponibilidad.
  • Integraciones: conectores API hacia ERP, POS, eCommerce y sistemas de fidelización del cliente.
  • Autenticación: manejo de identidades por Kiosk ID y, cuando aplica, Customer ID, con trazabilidad total de sesiones.
  • Analytics: registro de eventos en tiempo real y almacenamiento para reporting avanzado.

4.2 Infraestructura Cloud

  • Desplegado sobre Google Cloud Platform (GCP).
  • Comunicación segura: HTTPS (puerto 443) con TLS.
  • Escalabilidad automática gracias a la arquitectura serverless.
  • Monitoreo y alertas integrados para uptime y rendimiento.
  • Resiliencia ante microcortes: caché local, colas de eventos y reintentos automáticos.

4.3 Integraciones

La plataforma soporta integraciones modulares, activadas según el escenario del cliente:

  • Catálogo: categorías, productos, atributos, imágenes y variaciones.
  • Precios y promociones: consulta y validación en tiempo real por tienda o nivel central.
  • Stock: sincronización por tienda o inventario eCommerce, con validación justo-a-tiempo.
  • Clientes (opcional): creación y consulta de perfiles para programas de lealtad.
  • Órdenes/Pedidos (opcional): creación, actualización de estados y reconciliación con sistemas externos.
  • Documentos fiscales (opcional): boleta/factura generada vía API o impresora fiscal integrada.
  • 3D/AR (add-on): integración vía API de ViewIt3D para mostrar modelos GLB/USDZ.

   

4.4 Requerimientos de Datos

  • Campos mínimos de producto: SKU, nombre, descripción, precio, imágenes, ficha técnica, variaciones.
  • Fuentes de datos: API REST/GraphQL, archivos CSV/JSON/XML o feeds propietarios.
  • Sincronización: soporta pull programado con frecuencia configurable y webhooks en tiempo real.
  • Validación en tiempo real de precio y stock en el momento de la compra.

Logs y auditoría: todos los intercambios quedan registrados para control y conciliación.

Table of Contents