Документы

Технические описания, спецификации, заметки для разработчиков и сисадминов.

Для пользователей

• Руководство пользователя — установка приложения, прошивка контроллера, привязка, гостевые ключи, автоматизация, безопасность.
• Конфигуратор прошивки контроллера — лендинг с выбором варианта связи между телефоном и контроллером.
  • ↳ BLE-контроллер — для ESP32 / S3 / C3 / C6. Телефон управляет напрямую без интернета, питание от батареек, срабатывает только когда телефон рядом.
  • ↳ WebSocket-устройство — для ESP32 / ESP8266 (Sonoff Mini, Shelly Plus 1, NodeMCU, Wemos D1) и Raspberry Pi (Zero W / 3 / 4 / 5, Python + GPIO). Постоянный онлайн, открытие с любой точки мира.
• Интеграции без перепрошивки — Tasmota, ESPHome, Home Assistant, Sonoff, Shelly Cloud через веб-хук Entrixy.

Архитектура и протоколы

• Архитектура v2 — общая схема клиента-сервера-контроллера, потоки данных, форматы сообщений.
• E2EE архитектура — сквозное шифрование, что и где зашифровано (AES-256-GCM на устройстве).
• BLE — модель угроз — что атакующий может и не может сделать с эфиром (ECDH X25519 + HMAC-SHA256).
• BLE — синхронизация времени — как контроллер узнаёт текущее время (для проверки окна действия гостевых ключей).

Исходники прошивок и скриптов

• /esp32-example/ — BLE-прошивка (NimBLE, deep-sleep). Шаблон для конфигуратора /esp/ble/.
• /esp32-ws-example/ — WebSocket-прошивка для ESP32 (WSS-клиент, реле). Шаблон для конфигуратора /esp/socket/ в режиме ESP32.
• /integrations/esp8266/ — WebSocket-прошивка для ESP8266. Шаблон для конфигуратора /esp/socket/ в режиме ESP8266.
• /integrations/raspberry-pi/ — WebSocket-скрипт на Python для Raspberry Pi. Шаблон для конфигуратора /esp/socket/ в режиме Pi.
• /integrations/nodejs/ — WebSocket-клиент на Node.js для headless-серверов и OpenWRT-роутеров (конфигуратор пока не подключён, но протокол совместим).

Дизайн и интерфейс

• Гайдлайны дизайна — палитра, типографика, компоненты приложения.

Эксплуатация сервера

• Пропускная способность — оценка нагрузки до 100k пользователей, бутылочные горла.
• План масштабирования 100k — фазы A/B/C/D, что и в каком порядке делать.
• Серверная нагрузка — анализ источников — где сервер жжёт ресурсы и как лечить.
• Дашборд серверной нагрузки — графики WS-коннектов, CPU, памяти за 24 часа.

Тестирование

• Тест-план — 191 сценарий, 37 прод-критичных. Покрывает BLE-pair, WS-online, гостевые ключи, гео/Wi-Fi/время, webhooks (phone + server), restart-recovery, локализацию.

Прочее

• Обзор проекта — общая постановка задачи (markdown).
• TODO — список открытых задач (markdown).