# MVP Spec 17 — Cross-Cutting: SEO & i18n ## Паспорт документа - Статус документа: working spec - Актуально на: 28 марта 2026 года - Владелец: backend/platform-команда - Пересмотр: перед реализацией, при изменении domain rules или при смене source-of-truth по контракту - Область применения: детальные feature-спеки для product backlog и реализации MVP/v1 направлений - Связанные документы: - [Product roadmap и delivery checklist](../product-roadmap.md) - [Roadmap](../../project/roadmap.md) - [Карта API-маршрутов](../../architecture/api-routes.md) > Version: MVP · Priority: P1 · Phase: A (Supply) > Status: Draft v1 --- ## 1. Контекст и цель SEO и интернационализация (i18n) — сквозные архитектурные решения, которые влияют на каждую публичную страницу платформы. Этот документ определяет требования, правила и реализационные паттерны, которым должен следовать каждый разработчик при добавлении новой страницы или нового переводимого контента. **SEO-цель:** Обеспечить индексацию всех публичных страниц платформы поисковиками (Google, Yandex, Bing). Каждая страница курса и профиля продавца должна получать органический трафик. **i18n-цель:** Поддержать 3 языка интерфейса — узбекский (uz, основной), русский (ru), английский (en) — с корректным отображением у пользователей любой локали. **Что входит в этот модуль:** - SEO-требования по каждому типу страниц - Правила генерации slug (транслитерация) - Генерация sitemap.xml - JSON-LD структурированные данные (Course, Organization) - Архитектура i18n (next-intl, ICU pluralization) - Соглашения по ключам переводов - Паттерны добавления нового переводимого контента **Что не входит:** - Сами переводы контента продавцов → хранится в языке продавца, не переводится - Дизайн страниц → отдельный дизайн-документ - SEO-анализ и A/B тесты → вне скоупа MVP --- ## 2. Роли пользователей Этот спек ориентирован на разработчиков платформы, а не на конечных пользователей. | Роль | Задача в этом контексте | |------|------------------------| | **Frontend-разработчик** | Добавляет новую страницу: обязан следовать чеклисту SEO и i18n | | **Backend-разработчик** | Генерирует slug при создании сущностей, инвалидирует sitemap | | **Content / Marketer** | Заполняет title/description для новых типов страниц | --- ## 3. Use Cases Use cases в этом спеке — это паттерны для разработчиков. --- ### UC-01: Разработчик добавляет новую публичную страницу (SEO checklist) **Актор:** Frontend-разработчик **Предусловие:** Создаётся новый Route в Next.js App Router (/app/[locale]/...) **Триггер:** Разработчик реализует новый тип публичной страницы **Полный поток:** ``` [Точка входа] → Разработчик создаёт файл /app/[locale]/example/[slug]/page.tsx ─────────────────────────────────────────────────────── ШАГ 1 — generateMetadata ─────────────────────────────────────────────────────── → Экспортировать async function generateMetadata({ params }) из page.tsx → Функция должна возвращать Metadata со следующими полями: title: string // Обязательно (формат: см. раздел 4.1) description: string // Обязательно, 120–160 символов openGraph: { title: string // = title description: string // = description url: string // canonical URL с локалью type: 'website' // или 'article' images: [{ url: string // абсолютный URL изображения width: number height: number alt: string }] siteName: 'Qadam' locale: string // 'uz', 'ru', 'en' } robots: { index: boolean // false для авторизованных зон follow: boolean } alternates: { canonical: string // абсолютный URL без locale (canonical) languages: { 'uz': '/uz/path', 'ru': '/ru/path', 'en': '/en/path', } } ─────────────────────────────────────────────────────── ШАГ 2 — JSON-LD (для страниц с structured data) ─────────────────────────────────────────────────────── → Добавить