Headless CMS отделяет содержимое от интерфейса, но не снимает ответственность за то, как изменения попадут на сайт. У проекта появляются схема базы, права редакторов, опубликованные версии и кеш. Ниже - разбор этих связей на архитектуре Next.js и Payload, без предположения, что любая CMS автоматически решает SEO или безопасность.
Контенту нужна понятная модель
В Webappmaster страницы, статьи, проекты, отзывы и вопросы - отдельные коллекции. Общие настройки и навигация - globals. Страница собрана из блоков: редактор меняет содержание, а компонент отвечает за отображение. Такая модель помогает не копировать контакты вручную в десятки документов.
Перед добавлением поля задайте три вопроса: кто его редактирует, где оно отображается и какие страницы от него зависят. Например, смена изображения статьи затрагивает сам материал, его карточки и превью в социальных сетях. Проверка только URL статьи пропустит остальные места.
Миграция меняет схему
Добавление поля в конфиг недостаточно для production PostgreSQL. Нужна миграция, зарегистрированная в последовательности проекта. Сначала проверьте её на чистой тестовой базе и на базе с предыдущей схемой. Удаление поля лучше планировать поэтапно: новый код перестаёт его использовать до удаления данных.
- Зафиксировать новую схему и сгенерированные типы.
- Проверить порядок миграций и совместимость с существующими записями.
- Отдельно проверить права: анонимное чтение опубликованного и запрет записи.
- Сохранить резервную копию перед обновлением production.
- Проверить старт приложения и публичные страницы после миграции.
Seed меняет документы
Seed полезен для пустого стенда и контролируемого импорта. Он опасен, если при каждом старте обновляет существующие документы по slug: редакторские правки исчезнут. Для разового изменения нужна версия контента. Записывайте маркер завершения после всей операции, чтобы сбой не выглядел успешным импортом.
Маркер сам по себе не делает процесс транзакционным. Если часть документов уже обновилась, повтор должен быть идемпотентным. Если возможны параллельные импорты, нужны дополнительные правила координации. Протестируйте сбой посередине, повтор, сохранение сторонней страницы и следующий обычный рестарт.
Кеш следует за зависимостями
В этом проекте данные читаются через общий слой с unstable_cache и тегами; hooks коллекций инвалидируют связанные теги. Это API установленного Next.js 15. Когда материал публикуется, должны обновиться его страница, списки, sitemap и связанные блоки. Когда меняется отзыв, обновляются страницы, которые действительно его показывают.
- Изменить документ через CMS на изолированном стенде.
- Открыть опубликованную страницу и связанные списки.
- Проверить метаданные, sitemap и структурированные данные.
- Повторить публикацию, снятие с публикации и удаление.
- Убедиться, что технический endpoint ревалидации не доступен анонимной записи.
Админка не заменяет контроль доступа
Скрытая кнопка в интерфейсе не запрещает REST-запрос. Права определяются в конфиге коллекций и проверяются на сервере. Пользователь с доступом к одной операции не должен автоматически получать доступ к globals, загрузкам или изменению роли. Проверки Local API нужно выполнять с явно выбранным режимом access, иначе тест администратора не показывает реальное ограничение.
Для выбора архитектуры целиком прочитайте WordPress или Next.js. Публичную часть после изменения данных полезно проверить по протоколу переноса.
Первоисточники
Миграции Payload, контроль доступа Payload и кеширование Next.js 15. Точные настройки зависят от версии и способа размещения.