ТЗ: Evrone Headless Media — издание на Contentful

Демонстрационная версия документа · категория «Контент и видео» · №18

Это демонстрационное техническое задание: оно показывает структуру и глубину документа, который передаётся вместе с прототипом. Боевое ТЗ по этому солюшену готовится и заменит этот файл.

1. Суть решения

Contentful-ядро, Next.js-фронтенд, превью черновиков, миграция архива.

Медиа на headless CMS: Contentful как контент-ядро, Next.js-фронтенд, модели контента под издание, превью черновиков, вебхуки на пересборку, миграция архива со старой CMS (опыт переноса 130К+ статей VentureBeat). Миграция — отдельная продаваемая услуга-компаньон.

2. Технологический стек

3. Роли

• Редактор
• Разработчик фронтенда
• Контент-менеджер миграции

4. Модель данных

4.1. ContentModel

name: string
fields: jsonb # описание модели в Contentful
localized: boolean

4.2. Entry

content_type: string
fields: jsonb
state: enum # черновик, опубликовано
revision: integer

4.3. MigrationBatch

source: string
records_total: integer
records_done: integer
errors: jsonb

5. Ключевые сценарии

1. Редактор работает в Contentful, превью черновика открывается на фронтенде
2. Публикация вызывает вебхук и пересборку затронутых страниц
3. Архив старой CMS переносится пакетами с проверкой целостности
4. Битые ссылки и медиа фиксируются в отчёте миграции

6. Интеграции

• Contentful
• Next.js-фронтенд
• Пайплайн миграции
• CDN

7. Нефункциональные требования

• Серверный рендеринг, работоспособность ключевых страниц без JavaScript
• Мобильная адаптивность обязательна
• Роли и права проверяются на уровне сервера, а не интерфейса
• Логирование действий пользователей по значимым операциям
• Покрытие тестами моделей и ключевых сценариев
• Развёртывание одной командой, окружения production и staging

8. Состав MVP

Модели контента + фронтенд + миграционный пайплайн.

9. Критерии приёмки

1. Все сценарии из раздела 5 проходят end-to-end на тестовом стенде
2. Роли из раздела 3 видят только то, что им положено
3. Интеграции из раздела 6 работают через слой адаптеров и переключаются конфигурацией
4. Прототип разворачивается из репозитория одной командой
5. Документация по запуску и переменным окружения лежит в README