PARTE 1 - DOCUMENTACION MAESTRA DE INVESTIGACION Y OPERACION

Ballbox

Documentación Maestra De Investigación Y Operación

Máquinas Expendedoras TCN / OurVend

Versión 1.0 (Bitácora completa)

Propósito Del Documento

Este documento existe para evitar perder conocimiento.

La idea NO es generar un resumen ejecutivo.

La idea es que cualquier integrante de BallBox pueda tomar este documento dentro de seis meses o dos años y continuar exactamente desde el punto donde quedó la investigación.

Por ese motivo se documentan:

Hallazgos confirmados.

Errores encontrados.

Pruebas realizadas.

Hipótesis.

Configuraciones.

Procedimientos.

Dudas pendientes.

Decisiones tomadas.

Incluso si una hipótesis resulta incorrecta, se documenta porque evita repetir experimentos.

Estado Del Proyecto Al Momento De Escribir Este Documento

La investigación comenzó sobre máquinas expendedoras TCN provenientes de China.

Objetivos iniciales:

Comprender funcionamiento interno.

Comprender configuración de software.

Conectar internet.

Configurar productos.

Configurar imágenes.

Configurar publicidad.

Configurar idiomas.

Integrar medios de pago.

Evaluar independencia futura respecto de OurVend.

Al comenzar la investigación prácticamente no existía conocimiento operativo sobre la plataforma.

Actualmente:

Confirmado:

Conexión WiFi.

Acceso Android.

Acceso backstage.

Configuración de slots.

Prueba de motores.

Prueba de expulsión.

Conexión OurVend.

Modificación remota de stock.

Modificación remota de precios.

Importación USB.

Publicidad por imágenes.

Publicidad por video.

Exportación de configuración.

Exportación de logs.

Exportación de base SQLite.

Integración EasyCoin.

Integración BillWallet.

Cobro real con liberación de producto.

Pendiente:

Traducción completa.

Comprensión completa de ImageGoods.

Comprensión completa de Text.

Comprensión completa de v3Skins.

Publicidad remota online.

Comprensión protocolo TCP.

Posible backend propio.

Identificación De La Máquina

Modelo observado:

Tcn-Csc-8C(V49)

Machine ID observado:

2601070188

Resolución:

1920x1080

Orientación:

Vertical

Main Board:

Tcn-Standjs

Puerto serie principal:

/dev/ttyS2

Baud rate:

9600

Servidor configurado:

qrc.ourvend.com

Puerto configurado:

4150

Aplicación Android observada:

Tcn-Sd-05-V1.0.0.13-20251210.01

Android:

Rockchip K518 Android 7.1.2

Memoria observada:

1.95 Gb Ram

Almacenamiento:

7.28 Gb

Arquitectura General Detectada

Luego de múltiples pruebas se concluye que la arquitectura parece dividirse en tres componentes:

OurVend

Responsable de:

nube

stock

precios

sincronización

monitoreo

Android

Responsable de:

interfaz gráfica

publicidad

multimedia

idioma

sincronización con servidor

Main Board

Responsable de:

motores

sensores

bandejas

dispensado

Esquema simplificado:

OurVend Cloud

↓

Android TCN

↓

Main Board

↓

Motores

↓

Producto

Investigación De Red

Primer problema encontrado

La máquina no detectaba:

WiFi local

hotspot

Inicialmente se creyó que:

la antena estaba fallando

era obligatorio usar SIM

Descubrimiento

Se activó:

Maximizar compatibilidad

en iPhone.

Inmediatamente apareció el hotspot.

Conclusión:

La máquina posee restricciones de compatibilidad WiFi.

Hipótesis

Posiblemente:

sólo 2.4GHz

problemas con algunos canales automáticos

problemas con configuraciones modernas

Recomendación BallBox

Si una máquina no detecta red:

probar hotspot

activar maximizar compatibilidad

usar WPA2

usar canal 1

usar canal 6

antes de asumir fallas.

Investigación De Antenas

La máquina posee antena.

EasyCoin posee antena independiente.

Ambos dispositivos se encuentran dentro de estructura metálica.

Hipótesis:

La estructura puede degradar señal.

Posible solución:

sacar antenas al exterior.

Debe probarse en instalaciones reales.

Agregar al checklist:

□ evaluar señal

□ evaluar antena externa

Investigación De Slots

Primer hallazgo importante:

Slot Management funciona correctamente.

Se pudieron:

probar motores

probar canales

expulsar productos

Regla BallBox

Nunca asumir que todos los canales funcionan.

Cada canal debe probarse.

Checklist:

□ Canal 1

□ Canal 2

□ Canal 3

...

hasta validar todos.

Carga De Productos

Tubos de pelotas

Problema encontrado:

si quedan libres en el centro pueden:

girar

rotar

bloquear siguiente tubo

Configuración recomendada

Canal doble.

Apoyados contra pared lateral.

Resultado:

Menor probabilidad de atasco.

Productos textiles

Ejemplos:

medias

grips

bandas

Problema:

pueden deslizarse debajo del espiral.

Si ocurre:

el espiral gira

pero el producto no cae.

Configuración recomendada

Doblar y acomodar.

Verificar físicamente.

Probar múltiples veces.

Nunca asumir.

Qr Legal

Existe QR provisto por despachante.

Debe pegarse:

detrás de la heladera.

Agregar al checklist obligatorio.

No entregar máquina sin QR colocado.

Ourvend

URLs observadas:

Pc:

https://os.ourvend.com/Account/Login

H5:

https://oshw.ourvend.com/Account/HLogin

Funciones Confirmadas En Ourvend

Se confirmó:

modificación remota de stock

modificación remota de precio

sincronización con máquina

Productos

Proceso observado:

crear proveedor

crear categoría

crear producto

Problema encontrado:

la plataforma informa aprobación manual.

Tiempo indicado:

1-2 días hábiles.

Hipótesis:

las imágenes locales de la máquina podrían no depender completamente de esa aprobación.

Pendiente investigar.

Fin Parte 1