В сгенерированной системе администрирования вы работаете с данными: создаёте статьи, обновляете товары и загружаете изображения. Сохранение формы записывает данные в PostgreSQL. Структура проекта при этом не меняется — за неё отвечает Generator UI.
Вход и навигация
Для входа нужна учётная запись: первую создаёт оператор по инструкции первоначальное создание аккаунта. После входа откройте нужный модуль и сущность в меню. Скрытый пункт меню сам по себе не защищает данные: доступ дополнительно проверяет сервер при каждом запросе.
У сущностей с хранением могут быть List, Details, Create, Edit и Delete — в зависимости от сгенерированных возможностей и ваших прав. У проекций доступно только чтение. Модуль помогает организовать меню, но не выдаёт права на все сущности внутри него.
Список записей
В списке видны записи текущей страницы, общее количество и переходы между страницами. Данные занимают основную часть таблицы, действия находятся справа. Related records открывает связанные записи; Delete удаляет запись после подтверждения. Наведите курсор на ячейку, чтобы понять, можно ли открыть её содержимое.
Ищите, фильтруйте и сортируйте записи через доступные элементы списка. Эти возможности включаются у полей в Generator UI, в List behavior. Поиск по string/text, фильтры по типу поля и сортировка работают на сервере до разделения результата на страницы. У virtual настройки независимы от исходной сущности, а коллекции в карточке имеют собственные элементы управления. Если нужной возможности нет, проверьте поле в генераторе и обновите приложение после Generate.
Создание и изменение
Заполните форму и нажмите сохранение. Если значение не прошло проверку, исправьте его и повторите попытку. При сетевой ошибке не считайте запись сохранённой. Если ответ неоднозначен, сначала перечитайте запись: возможно, сервер уже успел принять изменение.
Поведение Hidden/Readonly, обязательных полей и форматов описано в правилах полей. Если разрабатываете собственный редактор, учитывайте: FormData сохраняет полный актуальный объект, а не выполняет произвольное PATCH-слияние. Сохраняйте и поля, которые редактор пока не показывает. Иначе после добавления поля в manifest старый клиент может потерять его значение.
Записи на нескольких языках
Если у сущности настроены переводы, над формой находятся языковые вкладки. Основной язык показан первым. При переключении меняются только переводимые значения; общие поля и выбранный порядок полей сохраняются. Подпись name-ru означает русский перевод name, а не новое поле модели. Заполните нужные языки и нажмите Save.
В списке Content language выбирает язык отображения, поиска, фильтров и сортировки, в том числе у virtual. Отсутствующее значение показывается пустым либо заменяется основным языком — в зависимости от настройки Missing translation у исходной сущности. Сам интерфейс остаётся английским. Как включить языки и обязательность заполнения — Languages.
Отношения и изображения
Начните вводить название в поле связанной записи: варианты загружаются асинхронно, число результатов ограничено. Через Related records открываются доступные обратные коллекции. Состав many-to-many меняют у владельца связи при необходимых правах; обратное представление позволяет только смотреть этот состав.
В Image/Gallery сначала дождитесь окончания загрузки файлов, затем сохраняйте саму запись. Неуспешные элементы исправьте или удалите перед сохранением. Загрузка изображения и сохранение формы — два отдельных действия; подробнее в статье изображения.
Настройка под свою задачу
Чтобы получить визуальный редактор статьи с режимом исходного текста, выберите Presentation → Markdown в Generator UI. Для Multiline, JSON, даты, перечисления и медиа тоже есть встроенные элементы ввода. Особое поведение можно реализовать в custom UI с соблюдением правил формы. Можно заменить и всю страницу, но тогда её обновление полностью лежит на разработчике. Подробнее — расширения.
Дополнительно: CLI
CLI генератора редактирует модель приложения; для повседневного изменения записей используйте систему администрирования. Запуск, миграции и обслуживание описаны в операторских командах.
Не путайте два интерфейса
Менять поля и доступ нужно в отдельном Generator UI, после чего выполнять Generate. Изменения самих записей вступают в силу после сохранения формы и новой генерации не требуют.
Демо, документы и разделы формы
В Demo обычный Admin может изучать записи и печатать в контролах, но сохранение изменений блокируется серверными правилами. Карточка с разрешённым Get остаётся доступной для просмотра; Save/Create/Delete зависят от разрешённых операций. Superadmin сохраняет обслуживание.
File/Files работают с документами отдельно от изображений. Заголовки и divider из Generator UI делят длинную форму на блоки без новых API/DB-полей. Языковые вкладки меняют только переведённые поля, сохраняя порядок формы; язык самого интерфейса остаётся английским.