В интерфейсе и командах используются одни и те же названия. Здесь можно быстро проверить, что они означают и чем отличаются похожие операции.
| Термин | Значение |
|---|---|
| Manifest — манифест | Описание вашего приложения в project.yaml: сущности, поля, связи и настройки. |
| Нормализованная модель | Модель после проверки и добавления допустимых значений по умолчанию. |
| Plan — план | Какие операции генератор собирается выполнить. |
| Diff — различия | Что изменится в содержимом текущих файлов. |
| Generate — генерация | Создание и применение исходников по модели. Само по себе не применяет SQL к БД. |
| Generated | Файлы, которые обновляет генератор. |
| Custom | Ваш код, который сохраняется при следующей генерации и работает вместе со стандартной частью. |
| Lock | Служебный файл с контрактом и хешами выпущенных файлов. |
| Сохранённая модель | Точные байты модели последней успешной генерации. |
| Модуль | Группа сущностей для структуры проекта и навигации. Это не роль доступа. |
| Persistent entity | Сущность с собственным хранением данных. |
| Projection — проекция | Виртуальная сущность для чтения выбранных данных без новой таблицы. |
| FK — внешний ключ | Поле, которое ссылается на ключ другой таблицы. |
| Владелец отношения | Сторона, на которой определены физическая связь и изменение состава коллекции. |
| Inverse | Обратное представление уже существующей связи. |
| Ledger | Журнал применённых миграций и ожидаемых хешей файлов. |
| Preset | Готовый вариант размещения компонентов окружения. |
| Release — релиз | Проверенный набор неизменяемых образов и метаданных выпуска. |
| Digest | Идентификатор содержимого образа. В отличие от тега, указывает на конкретное содержимое. |
| Recovery point | Согласованная резервная копия БД и медиа для восстановления. |
| Rollback | Возврат к записанным образам предыдущего релиза. SQL-изменения автоматически не отменяет. |
| Restore | Восстановление данных из полной точки восстановления. |
| DTO | Объект запроса или ответа API с явно определёнными полями для потребителя. |
Например, вы добавили поле и выполнили Generate: код обновлён, но миграцию БД ещё нужно применить. А изменение текста статьи в системе администрирования меняет данные и вообще не требует Generate. Различайте модель, исходники и записи БД — тогда результаты операций будет проще читать.