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

## FAQ

### Jak przetestować moduł przed wysłaniem?

Skopiujcie folder do `narzedzia/` na instancji, do której macie dostęp serwerowy, i włączcie go w Modułach. Jeśli nie macie takiej instancji, poproście nas o instancję testową.

### Potrzebuję haka, którego nie ma. Co robić?

Napiszcie do nas, czego potrzebujecie. Hak dopisujemy w portalu dla wszystkich modułów, a nie jako wyjątek pod jeden moduł. Nie obchodźcie tego zmianą plików portalu.

### Czy mogę użyć pakietu z composera albo npm?

Pakietów composera nie doinstalujecie na instancji. Macie wszystko, co ma portal (Laravel, klient `Http`, kolejki, mail, Alpine.js). Małą bibliotekę PHP bez zależności możecie włożyć do folderu i załadować `require_once` ze swojej klasy, jeśli licencja na to pozwala. Gotowy JS i CSS kładziecie w `zasoby/` jako zbudowane pliki, bez `node_modules`.

### Gdzie moduł trzyma pliki użytkowników?

W `storage/app/<klucz>/` albo w bazie. Nie w folderze modułu: przy aktualizacji jest podmieniany w całości.

### Co się dzieje z danymi po wyłączeniu modułu?

Nic. Tabele, ustawienia i pliki zostają, po ponownym włączeniu moduł widzi je z powrotem. Skille czatu z modułu znikają z czatów na czas wyłączenia.

### Moja wersja została odrzucona. Czy mogę wysłać ją jeszcze raz pod tym samym numerem?

Nie. Poprawcie kod, podnieście numer (np. z 1.2.0 na 1.2.1) i dopiszcie zmianę w `zmiany`.

### Czy mogę cofnąć instancję do starszej wersji modułu?

Instancja sama wraca do poprzedniej wersji, gdy aktualizacja się nie uda. Świadomy powrót robimy przez wycofanie wydania albo wysłanie poprawki z wyższym numerem. Napiszcie do nas, jeśli potrzebujecie cofnąć wersję na konkretnej instancji.

### Klucz, który chcę, jest zajęty.

Klucz należy do autora, który pierwszy go wysłał. Wybierzcie inny, najlepiej z przedrostkiem Waszej firmy.

### Czy moduł może zmienić menu albo wygląd całego portalu?

Nie. Moduł pokazuje się na liście narzędzi i w menu po przypięciu, może przypinać swoje rekordy (`rekordyWMenu`) i dokładać ekrany pod swoim prefiksem. Wygląd portalu zostaje wspólny.

### Czy czat AI może napisać moduł za mnie?

Tak. Dajcie czatowi ten plik: https://redai.pl/dev/moduly.md. Są tu wszystkie reguły, wzory i lista kontrolna. Przed wysyłką i tak przejdźcie listę kontrolną sami.

### Z kim rozmawiać?

Konto, zaufanie, pilne aktualizacje, brakujące haki: napiszcie na m@redai.pl.