От идеи до своего приложения.
Настройте модели, сгенерируйте Headless CMS и управляйте своим кодом.
Первый проект →Начать
Создайте первый проект, соберите базу знаний и научитесь работать с записями готового приложения.
Концепции
Как устроены модель данных, связи, API и доступ; где проходит граница между кодом генератора и вашими расширениями.
- Модель приложения: что хранится в манифесте
- Поля: типы, ввод и поведение списков
- Связи между сущностями
- Виртуальные сущности: выборка и вложенные коллекции
- Изображения: загрузка, размеры и выдача через API
- Вход и доступ к данным
- API приложения: записи, связи и изображения
- Какие файлы можно менять вручную
- Собственная логика и интерфейс в custom-зонах
- Словарь терминов Admingen
UI интерфейс
Пошаговые инструкции по экранам генератора: от настройки проекта и полей до доступа, генерации и истории.
- Generator UI: где найти нужную настройку
- Dashboard: обзор проекта
- Deployment: профили запуска и выпуска
- Project settings: настройки проекта
- Content: модули, сущности и поля
- Content / Сущности: создание и настройки
- Content / Поля: типы, формы и поведение списков
- Content / Access: кто и какие записи может читать
- Content / Связи: настройка и редактирование
- Content / Виртуальные сущности: составной ответ API
- Content / Изображения: загрузка и готовые размеры
- Generate: проверить и применить изменения
- History: посмотреть выполненные генерации
- Связи на примере статей, разделов и тегов
CLI интерфейс
Команды для настройки модели и генерации, с параметрами и примерами. Отдельно — команды созданного приложения и deploy/control.
- CLI: как читать команды и результаты
- CLI: создать проект и открыть редактор
- CLI: модули и сущности
- CLI: поля, ограничения и отображение
- CLI: ссылки и коллекции
- CLI: виртуальные сущности и выбранные поля
- CLI: доступ к операциям и правила чтения
- CLI: проверить модель и сгенерировать файлы
- CLI: переименовать или удалить поле и сущность
- CLI: создать собственную SQL-миграцию
- Команды созданного приложения
- deploy/control: справочник команд
Эксплуатация
От первого запуска до обновления на сервере: окружения, релизы, CI/CD, перенос БД и изображений, резервные копии и устранение ошибок. Пошаговые инструкции с командами и объяснением результата.
- Окружения: настройки в интерфейсе и custom-файлы
- Dev-local: локальная разработка
- Prod-local: запуск приложения в Docker
- Подготовить VPS и домены
- Подготовка профиля и SSH перед выпуском
- Как разместить приложение на сервере
- Развернуть из исходников на одном VPS
- Развернуть архив Docker-образов с Mac
- Развернуть Docker-образы из registry
- Docker-образы: backend, admin, ops и PostgreSQL
- Свободное место: образы, кэш сборки и архивы
- Скорость API: соединения и публичный кэш
- CI/CD: сборка и выпуск через GitLab или GitHub
- GitLab CI/CD: настройка и выпуск
- GitHub Actions: настройка и выпуск
- Обновление приложения
- Какие файлы лежат в deploy
- Управление приложением после запуска
- Перенос локальной БД и изображений на VPS
- Перенос dev-данных в prod-local и на другой компьютер
- Хранение изображений: папка на диске или S3
- Резервные копии и восстановление данных
- Миграции: изменение схемы и данных БД
- Смена секретов и обновление сертификатов
- Восстановление после прерванного развёртывания
- Ошибки запуска: как найти причину
- Настройки запуска и первый суперадминистратор
- Generate: применение изменений и возврат модели
- Переименование поля без потери данных
О проекте
Устройство генератора и приложения, локальный API редактора и пример подключения сайта к системе администрирования.