Добавлен локальный веб-интерфейс и распиновка в README

Плата поднимает страницу + JSON API (/api/state, /api/command) на порту 80
для наблюдения и управления актуаторами независимо от MQTT/Laravel.
Команда с веб-UI публикует тот же ack в devices/{id}/ack, что и MQTT-команда,
поэтому device shadow платформы не расходится с реальным состоянием.
Включается/выключается флагом ENABLE_WEB_UI в config.h.

В README добавлены ASCII-схема подключения DHT22/реле и раздел про сборку
через arduino-cli (включая обходной путь для проблемы с правами на
~/Documents/Arduino на macOS).

growbox/README.md

@@ -40,13 +40,68 @@ Laravel (`DemoGrowboxSeeder` использует `sensor-1`/`fan-1`), а `zone_
 DHT22 требует подтягивающий резистор ~10кОм между data и VCC, если он не
 встроен в конкретный модуль.
 
-## Библиотеки (Arduino Library Manager)
+### Схема подключения
+
+```
+                           ESP32 DevKitC
+                     ┌───────────────────────┐
+   DHT22 DATA ───────┤ GPIO4                 │
+   (+10к подтяжка    │                       │
+    DATA -> 3V3)     │                       │
+                      │                       │
+   Реле LIGHT  IN ────┤ GPIO16                │
+   Реле PUMP   IN ────┤ GPIO17                │
+   Реле FAN    IN ────┤ GPIO18                │
+                      │                       │
+              3V3 ────┤ 3V3                   │
+              GND ────┤ GND                   │
+              USB/5V ─┤ VIN                   │
+                      └───────────────────────┘
+
+DHT22:        VCC -> 3V3   GND -> GND   DATA -> GPIO4
+Реле-модуль:   VCC -> 5V (VIN) или 3V3 (смотри маркировку модуля)
+               GND -> GND (общий с ESP32)
+               IN  -> GPIO16 / GPIO17 / GPIO18
+
+⚠️  Реле коммутируют цепь самой нагрузки (свет/насос/вентилятор, обычно
+    12V/220V) через контакты COM/NO/NC — это ОТДЕЛЬНАЯ силовая цепь со своим
+    источником питания, к GPIO ESP32 она не подключается. К плате идёт
+    только сигнальный IN каждого реле-модуля.
+```
+
+## Библиотеки
+
+Через Arduino Library Manager (Sketch → Include Library → Manage Libraries):
 
 - `PubSubClient` (Nick O'Leary) — MQTT-клиент
 - `ArduinoJson` (Benoit Blanchon, v7) — сериализация/парсинг JSON
 - `DHT sensor library` (Adafruit) + зависимость `Adafruit Unified Sensor`
 - Board support: `esp32` (Espressif Systems) через Boards Manager
 
+`WebServer` (веб-интерфейс) и `WiFi` идут в комплекте с board support
+`esp32` — отдельно ставить не нужно.
+
+## Веб-интерфейс
+
+Каждая плата поднимает у себя простую страницу и JSON API на порту 80 —
+удобно наблюдать/управлять локально, не дожидаясь Laravel/MQTT:
+
+- `GET /` — HTML-страница: показания DHT22 + кнопки Вкл/Выкл для
+  light-1/pump-1/fan-1.
+- `GET /api/state` — JSON `{"sensor":{"has_reading","temperature","humidity"},"devices":{"light-1":{"power"},...}}`.
+- `POST /api/command` — JSON-тело `{"device_id","action","level"?}`, тот же
+  формат, что и в MQTT-команде.
+
+Команда с веб-UI применяется через тот же код и публикует тот же ack в
+`devices/{id}/ack`, что и команда из device-control-service — device shadow
+платформы (Redis) не расходится с реальным состоянием железа независимо от
+того, кто его переключил.
+
+Включается/выключается флагом `ENABLE_WEB_UI` в `config.h` (`1`/`0`) — при
+`0` HTTP-сервер не поднимается вообще, порт 80 не слушается. У сервера нет
+авторизации — только для локальной сети, как и mosquitto платформы; для
+выхода за пределы LAN сначала нужно добавить хотя бы Basic Auth.
+
 ## Настройка и прошивка
 
 1. `cp config.h.example config.h`, заполнить Wi-Fi SSID/пароль, IP хоста, на
@@ -55,7 +110,25 @@ DHT22 требует подтягивающий резистор ~10кОм ме
 2. Открыть `growbox.ino` в Arduino IDE, выбрать плату (ESP32 Dev Module или
    конкретную модель), порт.
 3. Прошить. Открыть Serial Monitor на 115200 бод — там лог подключения к
-   Wi-Fi/NTP/MQTT и каждой публикации телеметрии/команды.
+   Wi-Fi/NTP/MQTT/веб-сервера и каждой публикации телеметрии/команды, а
+   также IP платы для похода в веб-интерфейс.
+
+### Сборка через `arduino-cli` (если не через IDE)
+
+```bash
+arduino-cli core install esp32:esp32
+arduino-cli lib install "PubSubClient" "ArduinoJson" "DHT sensor library"
+arduino-cli compile --fqbn esp32:esp32:esp32 growbox
+arduino-cli upload --fqbn esp32:esp32:esp32 -p /dev/cu.usbserial-XXXX growbox
+```
+
+На macOS `arduino-cli` по умолчанию ставит библиотеки в
+`~/Documents/Arduino/libraries` — если этот каталог защищён sandbox'ом
+(Operation not permitted при установке библиотек, встречалось в среде этого
+агента), перенаправьте sketchbook в доступное место:
+`arduino-cli config set directories.user ~/путь/без/ограничений`. Через саму
+Arduino IDE (GUI-приложение) это обычно не требуется — она сама запрашивает
+нужные разрешения у macOS.
 
 ## Проверка end-to-end