Для локальной разработки Go backend и React-интерфейс запускаются на вашей машине, PostgreSQL — в Docker. Модель вы меняете в Generator UI, а записи — в сгенерированной системе администрирования.
Рабочий цикл в интерфейсе
- Откройте Content и измените сущность, поле или связь.
- Сохраните форму через Finish и перейдите в Generate.
- Нажмите Preview changes, изучите изменения и выполните Generate.
- После перезапуска приложения откройте систему администрирования по адресу из терминала и проверьте изменённую форму на записи.
Generator UI не запускает Go/React и не управляет Docker. Поэтому сначала подготовьте окружение командами ниже, а затем возвращайтесь к настройке модели в браузере.
Запуск и обслуживание среды в терминале
Откройте терминал в корне сгенерированного проекта и выполните:
make dev
Перед запуском установите Go, Node/npm и Make, запустите Docker. Команда подготовит локальное окружение, поднимет PostgreSQL и применит миграции. Если администратора ещё нет, она предложит создать аккаунт с ролью superadmin. Ввод пароля скрыт; пароля по умолчанию нет. Затем запустятся API и система администрирования, их логи останутся в этом терминале. Адреса появятся в выводе. По умолчанию API — http://127.0.0.1:8081, интерфейс — http://127.0.0.1:5173.
Если в проекте есть сгенерированные файлы развёртывания, можно запускать ту же среду через общий контроллер. Сначала создайте конфигурацию dev-окружения и проверьте её:
mkdir -p deploy/environments
jq --arg root "$(pwd -P)/deploy/.state/dev" \
'.root=$root | .backup.root=($root+"/backups")' \
deploy/generated/examples/dev-local.json > deploy/environments/dev.json
bash ./deploy/control check --env dev
bash ./deploy/control up --env dev
Для этого режима up запускает make dev. Следующие команды выполняйте в другом терминале: первая показывает журнал PostgreSQL, вторая останавливает окружение.
bash ./deploy/control logs --env dev --service postgres
bash ./deploy/control down --env dev
Логи Go и React остаются в терминале, из которого вы запустили приложение. В режиме dev-local нельзя использовать --json и параметры подтверждения серверных операций. JSON-файл окружения также не заменяет .env и параметры Make. Остановка сохраняет данные PostgreSQL.
После изменения модели
Чтобы применить изменения модели, остановите процессы приложения, выполните Generate и снова запустите make dev. Не удаляйте том БД ради применения миграций. Если вы уже меняли настройки окружения, проверьте их перед запуском: существующая конфигурация не должна незаметно заменяться при подготовке.
Связанные разделы
Продолжить работу с моделью поможет UI интерфейс. Параметры запуска редактора собраны в CLI: подготовка проекта. Когда понадобится другое размещение приложения, откройте выбор окружения.