В Generator UI вы описываете, каким будет приложение: создаёте сущности, добавляете поля, связываете записи и задаёте доступ. Здесь же можно посмотреть будущие изменения и выполнить Generate. Редактор сохраняет декларативную модель сам; для обычной работы открывать YAML не нужно.
Generator UI и сгенерированная система администрирования — разные приложения. В генераторе вы меняете структуру и выпускаете код. В системе администрирования работаете с данными — статьями, пользователями и изображениями. Чтобы изменить запись, Generate не требуется.
Экраны генератора
| Экран | Когда открыть | Подробная инструкция |
|---|---|---|
| Dashboard | Проверить проект и выбрать следующий шаг. | Dashboard |
| Project settings | Задать название и хранилище изображений. | Настройки проекта |
| Deployment | Выбрать Docker, CI, способ доставки и настроить окружения. | Deployment |
| Content | Создать модель: модули, сущности, поля и отношения. | Обзор Content |
| Generate | Посмотреть план и diff, разобраться с конфликтами и выпустить файлы. | Генерация |
| History | Найти результат предыдущего запуска. | История |
Content: выберите задачу
| Задача | Статья |
|---|---|
| Создать persistent-сущность, изменить её параметры. | Сущности |
| Добавить поле, выбрать тип, ограничения, отображение и List behavior. | Поля |
| Настроить CRUD, внешний доступ, обязательные условия и посмотреть маршруты. | Доступ сущности |
| Связать записи и настроить внешние ключи. | Связи |
| Собрать ответ из выбранных полей и связанных коллекций. | Виртуальные сущности |
| Настроить Image/Gallery и готовые размеры. | Изображения |
Для первого знакомства пройдите пример базы знаний: он ведёт от пустого проекта до работающей модели. Настройка Article → Section и тегов подробнее показана в практике отношений.
Как изменения становятся приложением
- Откройте нужную настройку и измените параметры.
- Нажмите Finish. Это сохраняет модель, но не меняет запущенное приложение и данные PostgreSQL.
- Перейдите в Generate → Preview changes. Просмотрите план и изменения файлов.
- Выполните Generate. Затем примените необходимые миграции и запустите обновлённое приложение по инструкции локальной разработки.
Сохранение, отмена и сообщения
Нажмите Finish, чтобы сохранить изменения и закрыть редактор. Cancel или закрытие формы позволяют отказаться от несохранённого черновика. Удаление выполняется отдельно: оно не сохраняет другие правки, внесённые в форму.
Если кто-то изменил модель параллельно, редактор не запишет поверх неё устаревшую версию. Нажмите Refresh, сравните новое состояние со своей правкой и повторите нужное изменение. Так же поступайте, если неясно, завершилась ли операция: сначала проверьте результат, чтобы повторный Create не создал лишний объект.
Модель, файлы приложения и данные БД обновляются разными действиями. Сохранение настройки ещё не меняет запущенное приложение. Разобраться в этих шагах помогут Generate и восстановление.
Дополнительно: CLI интерфейс
Используйте CLI, когда нужны скрипты или повторяемые операции над той же моделью. Для ежедневного редактирования достаточно UI. Запуск процессов и обслуживание приложения выполняются отдельно; такие задачи описаны в эксплуатационных статьях.