Ochrona plików OM#

Pliki wygenerowane przez Grenton Object Manager (OM) są chronione przed zmianami. Ani agent AI, ani edytor webowy nie mogą ich modyfikować. Dzięki temu konfiguracja z Object Managera jest zawsze nienaruszona.

Które pliki są chronione?#

Plik	Co zawiera
`om.lua`	Definicje modułów i obiektów I/O z Object Managera
`user.lua`	Logika użytkownika, sceny i ekspozycja urządzeń
`config.txt`	Konfiguracja modułów TFBus
`CONFIG.JSON`	Mapowanie modułów z typami sprzętowymi

Te pliki tworzy i aktualizuje wyłącznie Grenton Object Manager. Są one podstawą konfiguracji Twojego systemu.

Gdzie pisze się własny kod?#

Twój kod trafia do katalogu modules/. Tylko tam możesz tworzyć i edytować pliki - zarówno w edytorze webowym, jak i przez agenta AI.

modules/init.lua             ✓  możesz edytować
modules/scenes/movie.lua     ✓  możesz edytować
modules/helpers/utils.lua    ✓  możesz edytować

om.lua                       ✗  chroniony
user.lua                     ✗  chroniony
config.txt                   ✗  chroniony
CONFIG.JSON                  ✗  chroniony

Dlaczego to rozdzielenie?#

Object Manager jest głównym narzędziem do konfiguracji systemu Grenton. Jeśli pliki OM mogłyby być zmieniane z poziomu vCLU, mogłoby dojść do:

Konfliktów - następna synchronizacja z OM nadpisałaby Twoje zmiany
Niespójności - obiekty w systemie nie zgadzałyby się z konfiguracjami w OM
Utraty danych - zmiany dokonane poza OM nie byłyby widoczne w aplikacji Grenton

Dlatego pliki OM są tylko do odczytu, a Twoje rozszerzenia (automatyzacje, integracje, dodatkowa logika) trafiają do modules/.

Agent AI a pliki chronione#

Agent AI może czytać pliki OM - dzięki temu rozumie strukturę Twojego systemu (jakie moduły masz, jakie obiekty są dostępne).

Nie może jednak ich modyfikować. Nawet bot z pełnym dostępem nie zapisze do om.lua ani user.lua.

Agent AI respektuje tę ochronę automatycznie. Kiedy piszesz z nim automatyzacje, sam umieści kod w katalogu modules/.

Jak zmienić pliki OM?#

Jeśli musisz zmienić konfigurację modułów lub obiektów:

Otwórz Grenton Object Manager
Wprowadź zmiany w projekcie
Zsynchronizuj projekt z urządzeniem CLU

Po synchronizacji vCLU automatycznie załaduje zaktualizowane pliki.

Co może agent AI i edytor webowy?#

Operacja	`modules/*.lua`	Pliki OM
Odczyt	tak	tak
Tworzenie	tak	nie
Edycja	tak	nie
Usuwanie	tak	nie
Test w sandboxie	tak	nie
Wgranie do produkcji	tak	nie

Backup przy wgrywaniu kodu#

Gdy nowy kod z modules/ jest wgrywany do produkcji, system automatycznie tworzy kopię zapasową poprzedniej wersji. Pliki OM nie potrzebują tego mechanizmu, bo nigdy nie są nadpisywane.