Custom-зоны · 0.8.1

Модель и custom-код: общий рабочий цикл

Продолжайте генерацию параллельно с разработкой и проверяйте совместимость.

На этой странице

Развитие модели и собственная разработка идут параллельно. Не нужно закончить генерацию навсегда, чтобы начать писать бизнес-логику: следующий Generate обновляет свои файлы и сохраняет ваши custom-зоны.

Пример: модель и собственное правило

В Content откройте сущность ENTITY_NAME и настройте её поля, связи и доступ. Поле FIELD_NAME — обозначение поля вашей модели. Если его значение нужно вычислять по правилам компании, реализацию добавьте в backend/internal/custom/ENTITY_NAME/; особый интерфейс — в admin/src/features/ENTITY_NAME/custom/. Имена директорий и Go/React-экспортов возьмите из сгенерированного проекта.

  1. Откройте текущий проект в Generator UI. Настройте модель и сохраните её.
  2. Параллельно измените свой Go/React-код в custom-файлах. В UI генератора произвольный исходный код не редактируется.
  3. В Generate → Preview changes просмотрите будущие изменения. Убедитесь, что стандартные файлы обновляются, а существующие custom-файлы сохраняются.
  4. Выполните Generate. Если менялась схема, просмотрите новые SQL-миграции и примените их локально через make migrate.
  5. Соберите затронутую часть приложения и проверьте свой пользовательский сценарий. Затем закоммитьте модель, generated-файлы, custom-код и зарегистрированные миграции вместе.
  6. Выпустите релиз по инструкции обновления. Данные сервера не заменяются локальными записями при обычном deploy.

Что проверять после изменения модели

Изменение Что сделать в custom-коде
Новое поле Не потерять его при преобразовании полного объекта и сохранении
Localized или nullable Учесть *string/nil в Go и null в API
Переименование или удаление Обновить обращения к старым полям и контрактам
Права доступа Проверить собственные actions и серверные handlers
Новая версия генератора Сверить контракт hooks, customcontracts и frontend-расширений

Сохранение custom-файла не гарантирует совместимость его кода с новой моделью. Ошибка компиляции после изменения контракта решается адаптацией собственной реализации, а не правкой generated bootstrap.

Если возник конфликт

Сначала сохраните работу в Git и просмотрите diff. Если вручную изменён generator-owned файл, перенесите требуемую логику в подходящую точку расширения. Не используйте Force как способ скрыть неразобранный конфликт: сначала поймите, какой файл и почему изменится.

Если нужна точка расширения, которой ещё нет, опишите необходимый контракт отдельно. Наличие папки custom не превращает любую ручную правку в поддерживаемое расширение.

Начните с карты custom-зон, затем выберите backend, admin, SQL-миграции или deployment.