Что находится в Content
В Content вы строите модель приложения. Слева выберите модуль и сущность, справа появятся её поля и действия. Настройки открываются в правой панели. Записи будущего приложения здесь не создаются — для них предназначена сгенерированная система администрирования.
Навигация и поиск
Введите имя или подпись в Find module or entity, чтобы быстро найти объект модели. Этот поиск не обращается к записям приложения. Стрелка у модуля сворачивает список сущностей, нажатие на его название открывает настройки. Virtual-сущности выделены отдельным бейджем.
После выбора сущности откроется таблица Fields. Нажмите строку поля для настройки; значки удаления и раскрытия выполняют свои действия отдельно. Свойства можно увидеть сразу по бейджам: Required, Primary key, Searchable, Filterable и Sortable.
Модули
Сначала создайте модуль, затем добавляйте в него сущности. Модуль объединяет их в интерфейсе и входит в адреса API.
| Поле | Пример | Назначение |
|---|---|---|
| Module name | site-data |
Техническое имя: строчные буквы, цифры и дефисы, начало с буквы |
| Module title | Контент сайта |
Подпись в меню; пустое значение оставляет техническое имя |
Нажмите Create module для создания или Save module для сохранения правок. В настройках есть список сущностей с переходом к каждой из них. Move up / Move down меняют порядок модулей; перед этим сохраните или отмените черновик. Delete module доступна только для пустого модуля: сначала перенесите его сущности. Если меняете техническое Module name непустого модуля, подтвердите последствия. Обычное изменение подписи адреса API не меняет. Перенести сущность можно в настройках сущности; её API получит префикс нового модуля.
Как сохраняются изменения
- Откройте создание или настройку объекта.
- Заполните Basic settings и при необходимости Advanced settings / Access.
- Нажмите Finish; в редакторе выбранных полей проекции используется Save fields.
- Дождитесь подтверждения сохранения и обновления модели.
- Перейдите в Generate для применения изменений к файлам.
Можно переключаться между вкладками без потери введённых значений. Для сохранения нажмите Finish: Cancel и закрытие панели его не заменяют. Если остались несохранённые правки, редактор предложит разобраться с черновиком. При параллельном изменении модели обновите состояние и сравните версии — устаревшая форма не должна затереть чужую работу.
Если связь с генератором прервалась и результат записи неизвестен, нажмите предложенный Refresh. Сначала проверьте, что сохранилось, и только потом повторяйте действие — это поможет не создать дубликат.
Рекомендуемый порядок проектирования
Например, для каталога создайте модуль catalog, сущности Category и Product и их идентификаторы. Добавьте обычные поля, затем связь Product → Category. После этого задайте доступ. Если сайту нужен отдельный состав ответа, добавьте виртуальную сущность. Завершите настройку через Preview/Generate.
Подробности: сущности, поля, доступ, связи, виртуальные сущности.
При необходимости модель можно редактировать через CLI; команды находятся в отдельном разделе. Не меняйте структуру приложения вручную в generated-файлах — для этого используйте модель.