Развитие модели и собственная разработка идут параллельно. Не нужно закончить генерацию навсегда, чтобы начать писать бизнес-логику: следующий Generate обновляет свои файлы и сохраняет ваши custom-зоны.
Пример: модель и собственное правило
В Content откройте сущность ENTITY_NAME и настройте её поля, связи и доступ. Поле FIELD_NAME — обозначение поля вашей модели. Если его значение нужно вычислять по правилам компании, реализацию добавьте в backend/internal/custom/ENTITY_NAME/; особый интерфейс — в admin/src/features/ENTITY_NAME/custom/. Имена директорий и Go/React-экспортов возьмите из сгенерированного проекта.
- Откройте текущий проект в Generator UI. Настройте модель и сохраните её.
- Параллельно измените свой Go/React-код в custom-файлах. В UI генератора произвольный исходный код не редактируется.
- В Generate → Preview changes просмотрите будущие изменения. Убедитесь, что стандартные файлы обновляются, а существующие custom-файлы сохраняются.
- Выполните Generate. Если менялась схема, просмотрите новые SQL-миграции и примените их локально через
make migrate. - Соберите затронутую часть приложения и проверьте свой пользовательский сценарий. Затем закоммитьте модель, generated-файлы, custom-код и зарегистрированные миграции вместе.
- Выпустите релиз по инструкции обновления. Данные сервера не заменяются локальными записями при обычном 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.