Moduły portalu redAi: dokumentacja dla programistów
Ten dokument opisuje, jak zbudować własny moduł portalu redAi, co moduł może, a czego nie wolno mu robić, jak go wysłać do katalogu redAi i jak trafia na instancje. Jest napisany dla ludzi i dla czatów AI: wklejcie ten adres do swojego asystenta kodowania, a dostanie komplet reguł w jednym pliku.
narzedzie.php
Jedyny obowiązkowy plik modułu. Co w nim wpisać i czego w nim nie wolno.
Haki klasy src/Narzedzie.php
Jak moduł wpina się w portal: menu, prompt czatu, adresy i harmonogram.
Paczka i wysyłka
Jak spakować moduł do tar.gz i wysłać nową wersję z konta albo przez API.
Trzy zgody: jak moduł trafia na cudzą instancję
Kiedy moduł staje na cudzej instancji: zgoda redAi, Wasza i administratora.
FAQ
Testy przed wysłaniem, pakiety z composera, dane po wyłączeniu i inne pytania.
Czym jest moduł#
Moduł to jeden folder narzedzia/<klucz>/ w portalu instancji. Portal wykrywa go sam: wystarczy, że folder leży w narzedzia/ i ma poprawny manifest narzedzie.php. Moduł pojawia się wtedy w Administracja › Moduły jako narzędzie do włączenia.
- Nie dopisujecie nic w
routes/,app/,config/,bootstrap/ani w innych plikach portalu. Moduł rozmawia z portalem tylko przez manifest, haki klasyNarzedziei wspólne elementy jądra opisane niżej. - Moduł może być samodzielnym narzędziem (własne ekrany, tabele, rekordy) albo tylko rozszerzać portal: dodawać skille czatu, tekst do promptu czatu, zadania cykliczne, krótkie adresy publiczne.
- Portal to aplikacja Laravel (PHP 8.3). Moduł pisze się jak kawałek aplikacji Laravela: kontrolery, widoki Blade, migracje, modele Eloquent.
- Wzorcowe moduły redAi, na których możecie się wzorować:
strony(rekordy, krótkie adresy, menu),formularze(publiczne wysyłki, mail, CSV),poczta(blok promptu czatu, komenda artisan),contract_generator(konfig, szablony w folderze).
Katalog modułów redAi to miejsce, do którego wysyłacie paczkę z modułem. Po naszym akcepcie moduł widzą instancje: wszystkie (moduł publiczny) albo tylko te, które wskażecie (moduł prywatny).
Ostatnia zmiana dokumentacji: 29.09.2026. Pytania: m@redai.pl.