> Źródło: https://redai.pl/dev/ (dokumentacja modułów portalu redAi). Cała dokumentacja w jednym pliku: https://redai.pl/dev/moduly.md

# Moduły portalu redAi: dokumentacja dla programistów

Wersja dokumentu: 25.09.2026, portal od 1.3.20. Strona z nawigacją: https://redai.pl/dev/

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.

## 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 klasy `Narzedzie` i 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).