Описание и детали проекта

Задача

Seo Sites Generator решает прикладную задачу: Монорепозиторий для генерации и кастомизации SEO-сайтов: фронтенд, бэкенд, AI-сервис, SEO-движок, шаблоны и деплой. Автоматизация и повторяемые контент-пайплайны.

Проект относится к коммерческий разработке и в активной разработке. Связан с услугами: SEO, AEO и GEO: подготовка сайтов к AI-поиску, Инженерия роста и контент-платформы.

Кейс показывает подход к задачам в области «SEO, AEO и GEO: подготовка сайтов к AI-поиску»: от постановки до сдачи с понятной структурой модулей.

Перед стартом зафиксировали критерии готовности: понятный первый экран, предсказуемые ошибки форм, возможность доработки без переписывания половины кодовой базы.

Решение

Сделана учебная, но полноценная реализация с акцентом на читаемость кода и воспроизводимую сборку.

Сценарии спроектированы так, чтобы основные действия укладывались в один–два экрана: меньше переключений, меньше ошибок при вводе. Навигация и подписи полей согласованы с привычными паттернами — пользователю не нужно «учить интерфейс».

Отдельное внимание — состояния загрузки и пустые списки: skeleton/spinner там, где данные приходят асинхронно, и понятные empty-state тексты вместо пустой таблицы.

Архитектура и стек

UI и клиент: React.

Сервер и данные: Node.js.

Инфраструктура и утилиты: TypeScript, Monorepo, AI, SEO.

Распределение языков в репозитории: TypeScript (92.2%), HTML (2.3%), Shell (2.1%), JavaScript (1.7%), CSS (1.5%), MDX (0.1%), Dockerfile (0%), Makefile (0%).

Слои разделены так, чтобы UI не знал деталей транспорта: адаптеры API/хранилища, доменные типы, компоненты представления. Это упрощает замену бэкенда и точечные UX-правки.

Ключевые функции

• TypeScript — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• Node.js — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• React — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• Monorepo — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• AI — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• SEO — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.

Дополнительно:

• Интеграция и использование TypeScript в продуктовой логике и интерфейсе.
• Интеграция и использование Node.js в продуктовой логике и интерфейсе.
• Интеграция и использование React в продуктовой логике и интерфейсе.

Результат

MVP уже покрывает ключевой сценарий; дальше — расширение отчётности, тестов и мониторинга.

Исходный код открыт: https://github.com/astropsy999/seo-sites-generator — можно оценить структуру модулей и стиль коммитов.

Что бы улучшил

Следующий шаг — observability (логи/метрики), автотесты на регресс и документация API для интеграторов. Для high-load сценариев — профилирование узких мест и кеширование справочников.