Panel Administratora

Każda opublikowana aplikacja Proyecta zawiera panel administratora — prywatne zaplecze chronione logowaniem, w którym zarządzasz treścią i zgłoszeniami z formularzy bez dotykania kodu.

Publiczna twarz Twojej aplikacji jest unikatowa i zgodna z marką. Za nią każda aplikacja potrzebuje tego samego nudnego, ale niezbędnego zaplecza: miejsca do edycji treści, przeglądania leadów i codziennej obsługi. Proyecta buduje to dla Ciebie ze schematycznych komponentów będących częścią szablonu, dzięki czemu jest spójne i poprawne w każdej aplikacji — i nigdy nie musisz czekać, aż AI ręcznie skleci ekran CRUD.

Czym możesz zarządzać

Sekcja	Co robi	Status
Treść	Tworzenie, edycja, publikowanie i archiwizowanie wpisów w każdej z Twoich kolekcji	Dostępne
Zgłoszenia z formularzy	Przeglądanie, oznaczanie jako przeczytane i archiwizowanie zgłoszeń z Twoich formularzy	Dostępne
Zamówienia (Commerce)	Przeglądanie i realizacja zamówień ze sklepu	Dostępne
Członkowie / użytkownicy	Zarządzanie osobami, które zalogowały się do Twojej aplikacji, oraz ich rolami	Dostępne

To, które sekcje widzisz, zależy od tego, co robi Twoja aplikacja — panel odczytuje jej aktualny kształt i renderuje tylko to, co ma zastosowanie. Aplikacja bez sklepu nie ma sekcji Zamówienia.

Kto ma dostęp

Panel administratora jest chroniony przez RBAC. Odwiedzający musi być zalogowany na konto z rolą admin, żeby go zobaczyć — każda akcja administratorska jest egzekwowana po stronie serwera, a nie tylko ukryta w interfejsie.

Rola administratora jest przyznawana adresowi e-mail wskazanemu podczas tworzenia aplikacji, dopasowanemu do adresu zweryfikowanego przez dostawcę tożsamości. Nie otrzymuje jej osoba, która zaloguje się jako pierwsza — w normalnej aplikacji wszyscy pozostali logują się jako zwykli użytkownicy, łącznie z pierwszym odwiedzającym. Sprawdź Użytkownicy i Auth, aby dowiedzieć się, jak działa logowanie i jak przypisywane są role.

Elementy składowe

Panel jest zbudowany z komponentów będących częścią szablonu. Nie piszesz ich samodzielnie — są częścią każdej aplikacji — ale warto poznać te najważniejsze:

Komponent	Co daje
CollectionManager	Pełny ekran administratora dla jednej kolekcji: lista z wyszukiwaniem i sortowaniem oraz automatycznie wygenerowany formularz tworzenia/edycji. Jeden na kolekcję.
SubmissionsInbox	Skrzynka odbiorcza formularzy: zakładki Nowe / Przeczytane / Zarchiwizowane, odznaka nieprzeczytanych i widok szczegółów każdego zgłoszenia.
AdminShell	Oprawa całości — zwijany sidebar i górny pasek łączący wszystkie sekcje razem.

CollectionManager: automatyczny CRUD ze schematu

CollectionManager odczytuje schemat kolekcji i buduje całe środowisko edycji przy minimalnej ilości ręcznie pisanego kodu:

• Wyświetla wpisy w tabeli z oznaczeniem statusu, wyszukiwarką i przyciskiem New.
• Automatycznie generuje formularz na podstawie typu każdego pola — pola tekstowe stają się inputami, długi tekst staje się textarea, liczby stają się polami liczbowymi, wartości tak/nie stają się przełącznikami, pola wyboru stają się listami rozwijanymi, daty stają się selektorami dat, referencje stają się selektorem powiązanej kolekcji, a pola obrazków otrzymują przycisk uploadu (z selektorem biblioteki mediów i możliwością wklejenia URL).
• Najpierw zapisuje jako szkic — publikowanie to osobna, wyraźna akcja, więc nic nie trafia na żywo przez przypadek. Możesz też cofnąć publikację lub zarchiwizować wpis (archiwizacja to miękkie usunięcie — wpis znika z aplikacji i panelu, ale nie jest trwale usuwany).
• Obsługuje też jednorazową treść: kolekcje singleton (takie jak informacje o firmie) renderują formularz bezpośrednio, bez listy.

Edycja jest naprawdę bez kodu: Ty (lub każda osoba, której nadasz rolę admina) zmieniasz teksty, ceny, zdjęcia i godziny z poziomu panelu, klikasz publish, a aplikacja na żywo się aktualizuje.

Uwaga: Produkty Commerce są zarządzane narzędziami commerce, a nie w CollectionManager — mimo że katalog jest treścią. Zobacz Commerce.

Jak budowany jest panel administratora

Nie musisz o niego prosić, a AI nie składa go ręcznie. Panel to samokonfigurujący się „stały panel administratora“: stały /admin wbudowany w szablon każdej aplikacji, który odczytuje aktualny schemat treści i konfigurację możliwości Twojej aplikacji, a następnie renderuje się sam — bez żadnego wiring’u przez AI. Dodaj nową kolekcję później, a pojawi się automatycznie, bez potrzeby przebudowania.

Poza treścią i zgłoszeniami z formularzy pojawiają się sekcje odpowiadające temu, co Twoja aplikacja faktycznie robi — zamówienia i zwroty, rezerwacje i harmonogramy, członkowie i role, biblioteka mediów, e-mail i powiadomienia push. Dostajesz te, które dotyczą Twojej aplikacji, i żadnej z tych, które jej nie dotyczą.

Ponieważ panel należy do szablonu, pozostaje spójny i poprawny w każdej aplikacji i nie może się rozjechać ani zepsuć, gdy AI edytuje Twoje publiczne strony. Jeśli później zechcesz zmienić samą konsolę — poproś o to; to jawna edycja, a nie coś, co pierwsza budowa improwizuje.

Typowe polecenia

Nigdy nie musisz prosić o sam panel administratora — każda aplikacja go zawiera, a nowe kolekcje pojawiają się w nim same. O co warto poprosić AI:

• "Add a 'featured' toggle to my services so I can choose what shows on the homepage." — nowe pola pojawiają się w panelu automatycznie.
• "Make the headline and hours on my homepage editable from the admin." — przenosi zakodowane na sztywno teksty do treści.
• "Build me a back-office page showing this week's bookings at a glance." — dedykowana strona złożona z tych samych elementów składowych.

Powiązane

• Zarządzanie treścią — kolekcje i wpisy, które panel administratora edytuje.
• Formularze — źródło skrzynki odbiorczej zgłoszeń.
• Użytkownicy i Auth — jak działa logowanie i jak przyznawana jest rola admina.
• Commerce — zarządzanie katalogiem i zamówieniami.