Архитектура · 0.8.1

Как устроен Admingen

Разберись, как модель превращается в Go API и React admin, где подключать свою логику и что меняется при повторной генерации.

Модель приложения.admingen/project.yaml

Нормализация · План · Шаблоны · Diff

Go backend

Сервисы · HTTP · PostgreSQL

React admin

Списки · Формы · Custom UI

OpenAPI и миграции

Контракт API · История схемы

manifest → spec → plan → generate → diff → apply

Сохранение модели, Generate и применение миграций — отдельные действия.

Admingen — Headless CMS генератор. Ты описываешь сущности, поля, связи и доступ в одной модели. Генератор создаёт backend, API-контракт, систему администрирования и миграции. Готовое приложение работает самостоятельно: генератор не участвует в обработке его запросов.

От модели к приложению

.admingen/project.yaml
         ↓
manifest → spec → plan → generate → diff → apply
         ↓
Go backend · React admin · OpenAPI · SQL migrations

Сохранение модели меняет manifest. Generate записывает файлы проекта. Применение миграций отдельно изменяет PostgreSQL. Публичный сайт — отдельный клиент API.

Что находится в этом разделе

  1. Структура проекта — Модель, backend, admin и API-контракт.
  2. Go backend: слои и путь запроса — Пакеты, интерфейсы и путь Create-запроса.
  3. React admin: структура и расширения — Features, страницы и контракты custom-компонентов.
  4. Собственный код и точки расширения — Hooks, зависимости, маршруты и свои компоненты.
  5. Генерация и владение файлами — Правила обновления, конфликты и история SQL.
  6. Архитектурные решения — Польза и ограничения семи решений.
  7. Как устроен генератор — Manifest, нормализация, план, шаблоны и UI.

Начни со структуры проекта или перейди к первому проекту.