Панель администратора

Каждое опубликованное приложение Proyecta поставляется с панелью администратора — закрытым бэк-офисом с авторизацией, где ты управляешь контентом и заявками из форм, не трогая код.

Публичная часть приложения уникальна и отражает твой бренд. За ней каждому приложению нужен один и тот же скучный, но необходимый бэк-офис: место для редактирования контента, просмотра лидов и ежедневной работы. Proyecta строит его за тебя из компонентов, управляемых схемой и принадлежащих шаблону, поэтому он остаётся единообразным и корректным во всех приложениях — и тебе никогда не придётся ждать, пока ИИ вручную набросает CRUD-экран.

Чем можно управлять

Раздел	Что делает	Статус
Контент	Создание, редактирование, публикация и архивирование записей в каждой из твоих коллекций	Доступно
Заявки из форм	Просмотр, пометка как прочитанных и архивирование заявок из твоих форм	Доступно
Заказы Commerce	Просмотр и выполнение заказов из твоего магазина	Доступно
Участники / пользователи	Управление людьми, которые вошли в твоё приложение, и их ролями	Доступно

Какие разделы ты видишь, зависит от того, что делает твоё приложение — панель читает его живую структуру и отображает только то, что применимо. В приложении без магазина нет раздела «Заказы».

Кто имеет доступ

Панель администратора защищена RBAC. Посетитель должен войти с учётной записью admin, чтобы увидеть её — каждое административное действие проверяется на сервере, а не просто скрыто в интерфейсе.

Права администратора выдаются той почте, которую ты указываешь при создании приложения, — она сверяется с адресом, подтверждённым провайдером идентификации. Они не достаются тому, кто вошёл первым: в обычном приложении все остальные входят как рядовые пользователи, включая первого посетителя. См. Users & Auth — там описано, как работает вход и как назначаются роли.

Строительные блоки

Панель собирается из компонентов, принадлежащих шаблону. Ты не пишешь их сам — они входят в каждое приложение, — но полезно знать основные:

Компонент	Что даёт
CollectionManager	Полный экран администратора для одной коллекции: список с поиском и сортировкой плюс автоматически сгенерированная форма создания/редактирования. По одному на коллекцию.
SubmissionsInbox	Входящие форм: вкладки Новые / Прочитанные / Архив, счётчик непрочитанных и детальный просмотр каждой заявки.
AdminShell	Обёртка вокруг всего остального — сворачиваемая боковая панель и верхняя строка, объединяющие разделы воедино.

CollectionManager: автоматический CRUD из твоей схемы

CollectionManager читает схему коллекции и строит весь опыт редактирования с минимальным количеством написанного вручную кода:

• Выводит список записей в таблице со статусными метками, поиском и кнопкой New.
• Автоматически генерирует форму из типа каждого поля — текстовые поля становятся инпутами, длинный текст превращается в textarea, числа — в числовые поля, значения вкл/выкл — в переключатели, поля выбора — в выпадающие списки, даты — в датапикеры, ссылки на другие коллекции — в пикер по связанной коллекции, а поля изображений получают кнопку загрузки (с выбором из медиатеки и возможностью вставить URL).
• Сначала сохраняет как черновик — публикация является отдельным явным действием, поэтому ничто не выходит в эфир случайно. Запись можно также снять с публикации или архивировать (архивирование — мягкое удаление: запись исчезает из приложения и панели, но не уничтожается).
• Работает и с единичным контентом: коллекции-синглтоны (например, информация о бизнесе) отображают форму напрямую, без списка.

Редактирование — действительно без кода: ты (или любой назначенный тобой администратор) меняешь тексты, цены, фотографии и часы работы в панели, нажимаешь Publish — и живое приложение обновляется.

Примечание: Продукты Commerce управляются инструментами Commerce, а не через CollectionManager — даже несмотря на то что каталог является контентом. См. Commerce.

Как строится панель администратора

Просить её не нужно, и ИИ не собирает её вручную. Панель — это самонастраивающаяся «постоянная панель администратора»: фиксированный /admin, встроенный в шаблон каждого приложения, который читает живую схему контента и конфигурацию возможностей твоего приложения и отображает себя сам — без единого подключения через ИИ. Добавь новую коллекцию позже — и она появится автоматически, без пересборки.

Помимо контента и заявок из форм, разделы появляются под то, что твоё приложение действительно делает — заказы и возвраты, бронирования и расписание, участники и роли, медиатека, email и push. Ты получаешь те, что подходят твоему приложению, и ни одного из тех, что не нужны.

Поскольку панель принадлежит шаблону, она остаётся единообразной и корректной во всех приложениях и не может разъехаться или сломаться, когда ИИ редактирует твои публичные страницы. Если позже понадобится изменить саму консоль — попроси: это явная правка, а не то, что первая сборка придумывает сама.

Типичные запросы

Саму панель администратора просить не нужно — она есть в каждом приложении, а новые коллекции появляются в ней сами. Вот о чём стоит попросить ИИ:

• "Add a 'featured' toggle to my services so I can choose what shows on the homepage." — новые поля появляются в панели автоматически.
• "Make the headline and hours on my homepage editable from the admin." — переносит зашитый в код текст в контент.
• "Build me a back-office page showing this week's bookings at a glance." — отдельная страница, собранная из тех же строительных блоков.

Связанные материалы

• Управление контентом — коллекции и записи, которыми управляет панель.
• Формы — источник входящих заявок.
• Users & Auth — как работает вход и как назначается роль администратора.
• Commerce — управление каталогом и заказами.