Documents

Descriptions techniques, spécifications et notes pour les développeurs et les administrateurs système.

Pour les utilisateurs

Guide de l'utilisateur — installation de l'application, chargement du programme dans le contrôleur, appairage, clés d'invité, automatisation et sécurité.
Configurateur de contrôleur — le choix de la façon dont le téléphone et le contrôleur dialoguent.
- Contrôleur BLE — reçoit les commandes par Bluetooth sans internet, fonctionne sur piles et ne se déclenche que si le téléphone est à proximité (ESP32 / S3 / C3 / C6).
- Contrôleur Internet — toujours en ligne, ouvre l'objet depuis n'importe où (ESP32 / ESP8266 — Shelly Plus 1, NodeMCU, Wemos D1 ; Raspberry Pi Zero W / 3 / 4 / 5, Python et GPIO).
Intégrations sans remplacer le programme — Tasmota, ESPHome, Home Assistant et Shelly se raccordent via un webhook Entrixy.

Architecture v2 — le schéma d'ensemble client-serveur-contrôleur, les flux de données et les formats de message.
Architecture E2EE — chiffrement de bout en bout : ce qui est chiffré et où (AES-256-GCM sur l'appareil).
BLE — modèle de menaces — ce qu'un attaquant à l'écoute des ondes peut et ne peut pas faire (ECDH X25519 avec HMAC-SHA256).
BLE — synchronisation de l'heure — comment le contrôleur apprend l'heure courante afin de vérifier la fenêtre de validité des clés d'invité.

/esp32-example/ — le programme BLE (NimBLE, sommeil profond). Le gabarit pour le configurateur /esp/ble/.
/esp32-ws-example/ — le programme Wi-Fi pour l'ESP32 (client WSS et relais). Le gabarit pour le configurateur /esp/socket/ en mode ESP32.
/integrations/esp8266/ — le programme Wi-Fi pour l'ESP8266. Le gabarit pour le configurateur /esp/socket/ en mode ESP8266.
/integrations/raspberry-pi/ — le script Wi-Fi en Python pour le Raspberry Pi. Le gabarit pour le configurateur /esp/socket/ en mode Pi.
/integrations/nodejs/ — un client Wi-Fi en Node.js pour serveurs sans écran et routeurs OpenWRT. Le configurateur ne le compile pas encore, mais le protocole est compatible.

Charte de design — la palette, la typographie et les composants de l'application.

Capacité — une estimation de charge jusqu'à 100 000 utilisateurs, et les goulets d'étranglement.
Plan de montée en charge à 100k — phases A/B/C/D : que faire et dans quel ordre.
Charge du serveur — d'où elle vient — à quoi le serveur dépense ses ressources et que faire pour y remédier.
Tableau de bord de la charge serveur — graphiques des connexions WebSocket, du processeur et de la mémoire sur 24 heures.

Plan de tests — 191 scénarios, dont 37 critiques pour le serveur de production. Il couvre l'appairage BLE, la présence WebSocket, les clés d'invité, les conditions géo/Wi-Fi/horaire, les webhooks (téléphone et serveur), la reprise après redémarrage et la localisation.