Documentation
IntroductionThe 5-Step WorkflowThe Raw HTML StrategyJSON Drop-in SystemDynamic SitemapWhy Cryptomus?Anti-Spam LogicCommon Errors

Руководство pSEO Wizard 🧙‍♂️

Добро пожаловать в полное техническое руководство по pSEO Wizard. Эта документация сжимает недели архитектурных решений в единый рабочий процесс, чтобы помочь вам безопасно запустить более 1000 страниц.

💡 Quick Tip: Используйте боковую навигацию для перехода между разделами или прокрутите полное руководство.

🚀 Часть 1: Основной Рабочий Процесс

Прежде чем погружаться в код, поймите, как работает "Фабрика":

1. Настройка Проекта

Тщательно выберите Целевой Язык. Это устанавливает флаг locale в JSON-выводе.

2. Логика Шаблонов

Используйте переменные как {City} или {Service}. Держите шаблоны короткими для лучшего SEO.

3. Генерация Данных

Мы используем логику Декартова произведения. 10 Услуг × 10 Городов = 100 Страниц.

🛡️ 4. Предупреждение "Безопасности"

На Шаге 4 мы предупреждаем публиковать под /blog. Публикация программного контента на корневом домене - быстрый способ быть деиндексированным Google.

👨‍💻 Часть 2: Интеграция Разработчиков

Золотой Стандарт

📘 Note: Следующее руководство рекомендует лучшую архитектуру для вашего приложения Next.js для обработки наших экспортированных файлов.

Стратегия "Raw HTML"

Поскольку pSEO Wizard генерирует полные, стилизованные HTML-страницы, обёртывание их в стандартный React Layout вызывает конфликты стилей.

✅ Решение: Мы используем Route Handler Next.js для подачи сырого HTML.

// src/app/[locale]/blog/[slug]/route.ts
export async function GET(request, { params }) {
  const post = getPostBySlug(params.slug);
  if (post.locale !== params.locale) return 404;
  
  const finalHtml = `<head><script src="https://cdn.tailwindcss.com"></script></head>
    <body>${post.body_html}</body>`;

  return new Response(finalHtml, { headers: { 'Content-Type': 'text/html' } });
}

Система JSON Drop-in

Забудьте о миграциях баз данных. Мы построили систему на основе Агрегации Файловой Системы.

  • 📁
    Каталог: src/app/data/posts-json/
  • 🔄
    Рабочий процесс: Просто "Перетащите" ваши экспортированные JSON-файлы сюда.
  • ✨
    Магия: Агрегатор blog-posts.ts автоматически читает все файлы и мгновенно публикует их.

Динамическая "Умная" Sitemap

Ваш sitemap.ts учитывает локаль. Он сканирует JSON-файлы и генерирует URL-адреса для конкретных локалей.

Это предотвращает штрафы за "Дублированный Контент" от Google.

🏛️ Часть 3: Техническая Архитектура

Почему Cryptomus?

Мы выбрали Cryptomus вместо Stripe по конкретным стратегическим причинам:

🌍 Глобальный Охват

Принимает криптоплатежи отовсюду (решая региональные банковские ограничения и обеспечивая глобальный доступ).

⚡ Мгновенная Разблокировка

Система Webhook мгновенно разблокирует кнопку "Экспорт" при подтверждении транзакции.

Анти-Спам Архитектура

Наша система разработана для защиты авторитета вашего домена:

  • Весь программный контент живёт под подкаталогом /blog
  • Каждая страница имеет уникальный контент, сгенерированный ИИ
  • Внутренние ссылки следуют лучшим практикам SEO
  • Правильные атрибуты lang и dir для многоязычного контента

🚑 Часть 4: Устранение Неполадок

Распространённые проблемы и их решения:

❌ Белый Экран / Нестилизованный Текст

Причина: Tailwind CDN заблокирован.

Решение: Проверьте CSP-заголовки в next.config.js.

⚠️ Сломанные Внутренние Ссылки

Причина: Артефакты генерации ИИ.

Решение: Убедитесь, что ваш route.ts имеет "Smart Regex" очиститель.

🔍 404 на Сгенерированных Постах

Причина: Несоответствие Slug.

Решение: Используйте decodeURIComponent(slug).

✅ CTA Кнопки Идут на /blog

Причина: Regex заменяет все ссылки.

Решение: Используйте отдельные паттерны для ссылок главной vs блога.

Сделано с ❤️ командой pSEO Wizard

Последнее обновление: Декабрь 2024

Documentation | pSEO Wizard