Задача

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 сценаріїв — профілювання вузьких місць та кешування довідників.