Documentos

Descripciones técnicas, especificaciones y notas para desarrolladores y administradores de sistemas.

Para usuarios

Guía del usuario — instalación de la aplicación, carga del programa en el controlador, emparejamiento, llaves de invitado, automatización y seguridad.
Configurador de controladores — elección de cómo se comunican el teléfono y el controlador.
- Controlador BLE — recibe órdenes por Bluetooth sin internet, funciona con pilas y solo se dispara cuando el teléfono está cerca (ESP32 / S3 / C3 / C6).
- Controlador por internet — siempre en línea, abre el objeto desde cualquier lugar (ESP32 / ESP8266: Shelly Plus 1, NodeMCU, Wemos D1; Raspberry Pi Zero W / 3 / 4 / 5, Python y GPIO).
Integraciones sin cambiar el programa — Tasmota, ESPHome, Home Assistant y Shelly se conectan mediante un webhook de Entrixy.

Arquitectura v2 — el esquema general cliente-servidor-controlador, los flujos de datos y los formatos de mensaje.
Arquitectura E2EE — cifrado de extremo a extremo: qué se cifra y dónde (AES-256-GCM en el dispositivo).
BLE — modelo de amenazas — qué puede y qué no puede hacer un atacante que escucha la radio (ECDH X25519 con HMAC-SHA256).
BLE — sincronización de la hora — cómo averigua el controlador la hora actual para comprobar la ventana de validez de las llaves de invitado.

/esp32-example/ — el programa BLE (NimBLE, sueño profundo). La plantilla para el configurador /esp/ble/.
/esp32-ws-example/ — el programa Wi-Fi para el ESP32 (cliente WSS y relé). La plantilla para el configurador /esp/socket/ en modo ESP32.
/integrations/esp8266/ — el programa Wi-Fi para el ESP8266. La plantilla para el configurador /esp/socket/ en modo ESP8266.
/integrations/raspberry-pi/ — el script Wi-Fi en Python para la Raspberry Pi. La plantilla para el configurador /esp/socket/ en modo Pi.
/integrations/nodejs/ — un cliente Wi-Fi en Node.js para servidores sin monitor y routers OpenWRT. El configurador todavía no lo compila, pero el protocolo es compatible.

Capacidad — una estimación de carga hasta 100 mil usuarios y los cuellos de botella.
Plan de escalado a 100k — fases A/B/C/D: qué hacer y en qué orden.
Carga del servidor: de dónde sale — en qué gasta recursos el servidor y qué hacer al respecto.
Panel de carga del servidor — gráficas de conexiones WebSocket, CPU y memoria durante 24 horas.

Plan de pruebas — 191 escenarios, 37 de ellos críticos para el servidor de producción. Cubre el emparejamiento BLE, la presencia por WebSocket, las llaves de invitado, las condiciones geo/Wi-Fi/horario, los webhooks (teléfono y servidor), la recuperación tras un reinicio y la localización.