Przegląd architektury#

vCLU to jeden program, który łączy w sobie kilka komponentów. Każdy z nich możesz włączyć lub wyłączyć w ustawieniach - używasz tylko tego, czego potrzebujesz.

Schemat ogólny#

graph LR
    subgraph Urządzenia
        cz[Czujniki]
        pr[Przełączniki]
        os[Oświetlenie]
        ro[Rolety]
        gp["GPIO (piny RPi)"]
    end

    subgraph vCLU
        broker[Broker MQTT]
        lua[Automatyzacje Lua]
        dash[Dashboard webowy]
        hk[HomeKit bridge]
        ha[Home Assistant]
        mcp[Serwer MCP]
        plug[Pluginy]
        gpio[GPIO]
    end

    subgraph Odbiorcy
        web["Dashboard (przeglądarka)"]
        apple["Apple Home (HomeKit)"]
        hass[Home Assistant]
        ai["Agent AI (Claude)"]
    end

    cz -->|MQTT| broker
    pr --> lua
    os --> lua
    ro --> lua
    gp --> gpio

    dash --> web
    hk --> apple
    ha --> hass
    mcp --> ai

Komponenty#

Broker MQTT#

Odbiera i wysyła wiadomości do urządzeń smart home (Zigbee2MQTT, Tasmota, Shelly, ESPHome). Wbudowany - nie musisz instalować osobnego brokera. Możesz też podłączyć się do zewnętrznego brokera.

Automatyzacje Lua#

Silnik automatyzacji. Tu działa Twój kod - reakcje na zdarzenia, timery, sceny, logika sterowania. Piszesz w prostym języku Lua, w katalogu modules/.

Dashboard webowy#

Panel w przeglądarce do monitorowania i sterowania urządzeniami. Wyświetla widgety, wykresy, statusy. Dostępny z każdego urządzenia w sieci lokalnej.

HomeKit bridge#

Mostek do Apple Home. Urządzenia zdefiniowane w vCLU pojawiają się w aplikacji Dom na iPhone i Macu. Parujesz jednorazowo kodem PIN.

Home Assistant#

Automatyczne wykrywanie urządzeń w Home Assistant przez MQTT Discovery. Urządzenia pojawiają się w HA bez ręcznej konfiguracji.

Serwer MCP#

Interfejs dla agenta AI (np. Claude). Agent może przez MCP sterować urządzeniami, czytać logi, pisać kod automatyzacji i diagnozować problemy.

System pluginów#

Rozszerzenia napisane w Lua. Pluginy dodają integracje z usługami - pogoda, powiadomienia Telegram, protokoły urządzeń. Instalujesz je przez panel webowy.

GPIO#

Bezpośrednia obsługa pinów Raspberry Pi. Pozwala podłączyć przekaźniki, przyciski, czujniki bez pośrednictwa MQTT. Na komputerze (nie RPi) działa w trybie symulacji.

Jeden proces#

Wszystkie komponenty działają w jednym procesie. Nie ma osobnych usług do uruchamiania, monitorowania czy aktualizowania. vCLU startuje automatycznie jako usługa systemowa na Raspberry Pi.

Włączanie i wyłączanie#

Każdy komponent jest opcjonalny. W ustawieniach panelu webowego możesz:

• Wyłączyć HomeKit jeśli nie używasz Apple Home
• Wyłączyć MCP jeśli nie potrzebujesz agenta AI
• Wyłączyć wbudowany broker jeśli używasz zewnętrznego (Mosquitto)

Wyłączony komponent nie zużywa zasobów.

Minimalna konfiguracja to sam silnik Lua z MQTT. Wszystko inne możesz dołączyć w dowolnym momencie.