# AI Site Generator — Полная документация

## Обзор

AI Site Generator (https://iigenerator.site) — ИИ-платформа для генерации профессиональных лендингов. Пользователь описывает желаемый сайт на естественном языке, а пайплайн специализированных ИИ-агентов создаёт готовую HTML-страницу с современным CSS-оформлением.

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

### Пайплайн ИИ-агентов

Система использует многоагентный пайплайн, выполняемый последовательно:

1. **Извлекатель данных** — Извлекает структурированные данные (название компании, услуги, контакты) из описания пользователя
2. **Планировщик сайта** — Планирует структуру страницы, выбирает подходящие блок-шаблоны
3. **Стилизатор блоков** — Применяет единый стиль к отдельным блокам
4. **Редактор блоков** — Дорабатывает содержание и расположение каждого блока
5. **Унификатор дизайна** — Обеспечивает визуальную согласованность всех блоков
6. **Редактор** — Финальная проверка и оптимизация контента
7. **Агент контроля качества** — Проверка качества сгенерированного HTML

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

- **Бэкенд**: Python, FastAPI, LangChain, OpenRouter API
- **Фронтенд**: Next.js (статический экспорт), TypeScript, Tailwind CSS
- **База данных**: PostgreSQL с миграциями Alembic
- **ИИ-модели**: OpenRouter API (настраиваемые модели)

### Блок-шаблоны

Система включает 60+ готовых HTML блок-шаблонов по категориям:

- **Hero** — gradient_center, image_left, split_right
- **Услуги** — cards_grid, alternating_rows, icon_list
- **Отзывы** — cards_grid, quotes_list
- **Цены** — карточки тарифов
- **Функции** — сетки возможностей
- **Контакт** — формы с информацией, простые формы
- **CTA** — баннер, встроенный блок
- **Портфолио** — сетка проектов, о себе
- **Панель управления** — статистика, таблица, сайдбар, верхняя панель, активность
- **Образование** — курсы, преподаватели
- **Ресторан** — меню, атмосфера
- **Агентство** — процесс, команда
- **Интернет-магазин** — сетка товаров, категории, избранное
- **Недвижимость** — сетка объектов
- **Мероприятия** — обратный отсчёт, спикеры

## Страницы создания сайтов (/create/*)

Специализированные SEO-страницы, каждая из которых описывает процесс создания конкретного типа сайта с помощью ИИ:

- [/create/landing/](/create/landing/) — Создание продающего лендинга с помощью ИИ. Hero-секция, преимущества, отзывы, FAQ и CTA-блок. 60+ блоков, визуальный редактор, скачивание ZIP.
- [/create/portfolio/](/create/portfolio/) — Создание сайта-портфолио с ИИ. Галерея работ, раздел «обо мне», примеры проектов и контактная форма. Для фотографов, дизайнеров, фрилансеров.
- [/create/ecommerce/](/create/ecommerce/) — Создание интернет-магазина с ИИ. Каталог товаров с карточками, описаниями, ценами и фильтрацией. Быстрый старт без программиста.
- [/create/restaurant/](/create/restaurant/) — Создание сайта ресторана, кафе или бара с ИИ. Меню, атмосферная галерея, форма бронирования столиков, карта проезда.
- [/create/corporate/](/create/corporate/) — Создание корпоративного сайта с ИИ. Презентация компании, команда, услуги, кейсы и контакты. Профессиональный дизайн без веб-студии.
- [/create/blog/](/create/blog/) — Создание блога с помощью ИИ. Структура статей, категории, архивы, поиск. Адаптивный дизайн для публикации контента.

## Блог (/blog)

Экспертные статьи об ИИ-генерации сайтов, сравнения сервисов и практические руководства:

- [/blog/kak-sozdat-sait-s-ii/](/blog/kak-sozdat-sait-s-ii/) — Как создать сайт с помощью ИИ: пошаговая инструкция на 2026 год. Полный гайд от определения типа сайта до скачивания результата. 7 ИИ-агентов, 60+ блоков, визуальный редактор.
- [/blog/luchshie-ii-dlya-sozdaniya-saitov/](/blog/luchshie-ii-dlya-sozdaniya-saitov/) — Лучшие ИИ для создания сайтов в 2026 году. Полное сравнение 6 сервисов: AI Site Generator, Framer AI, Hostinger AI, Wix AI, Durable, 10Web. Таблицы, критерии, рекомендации.
- [/blog/ii-vs-konstruktor-saitov/](/blog/ii-vs-konstruktor-saitov/) — ИИ или конструктор сайтов: что лучше в 2026 году. Сравнение ИИ-генераторов и конструкторов (Tilda, Wix, WordPress) по 10 параметрам. Реальные кейсы перехода.
- [/blog/skolko-stoit-sait-cherez-ii/](/blog/skolko-stoit-sait-cherez-ii/) — Сколько стоит создание сайта через ИИ. Сравнение цен: веб-студия, конструктор, ИИ-генератор. Скрытые расходы, ROI и расчёт окупаемости.
- [/blog/ii-dlya-dizaina-saita/](/blog/ii-dlya-dizaina-saita/) — ИИ для дизайна сайта. Как ИИ создаёт профессиональный дизайн: 60+ блоков, подбор цветов и шрифтов, живой редактор. Примеры дизайнов.
- [/blog/kak-sozdat-landing-besplatno/](/blog/kak-sozdat-landing-besplatno/) — Как создать лендинг бесплатно с помощью ИИ. 10 элементов успешного лендинга, A/B тестирование, привлечение трафика.

## API-эндпоинты

Все API-эндпоинты имеют префикс `/api/`:

- `POST /api/generate` — Запуск пайплайна генерации
- `GET /api/projects` — Список проектов пользователя
- `GET /api/projects/{id}/status` — Статус пайплайна
- `POST /api/projects/{id}/edit` — Редактирование проекта с помощью ИИ
- `POST /api/projects/{id}/edit-block` — Редактирование конкретного блока
- `GET /api/preview/{name}/html` — Получение сгенерированного HTML
- `GET /api/health` — Проверка состояния сервиса

## Рабочий процесс пользователя

1. Пользователь заходит на https://iigenerator.site
2. Авторизуется через OAuth (Google, GitHub и др.)
3. Описывает желаемый сайт в чате
4. ИИ-пайплайн генерирует страницу (2-5 минут)
5. Пользователь просматривает результат в iframe
6. Можно редактировать блоки, менять порядок секций, применять стили
7. Скачивает финальный сайт в формате ZIP

## Тарифы

Бесплатный тариф с ограниченным числом генераций. Премиум-планы предлагают больше генераций, приоритетную обработку и дополнительные возможности.

## Контакты

- Сайт: https://iigenerator.site
- Поддержка: через сайт