.

2025-11-29 21:48:10 +05:00
parent 82415ad5ff
commit cd233bf4c0
24 changed files with 1747 additions and 16 deletions
@@ -16,6 +16,7 @@ API для генерации маркетингового анализа и с
 - ✅ Пользователи могут видеть только свои анализы и стратегии
 - ✅ Добавлена детальная история статусов для каждого анализа и стратегии
 - ✅ Новые эндпоинты для получения списка всех анализов/стратегий пользователя
+- ✅ **НОВОЕ**: Добавлена поддержка типов анализов (РЫНОК, КОНКУРЕНТЫ, ЦА, КАНАЛЫ, SWOT)

 ---

@@ -77,6 +78,7 @@ Authorization: Bearer <your_jwt_token>
 | `location`       | string | ✅           | Географическая локация работы  | "Алматы, Казахстан"              |
 | `client`         | string | ✅           | Тип целевой аудитории          | "B2B клиенты"                    |
 | `differentiator` | string | ✅           | Уникальные особенности бизнеса | "Быстрая разработка за 2 недели" |
+| `analysisType`   | string | ✅           | Тип анализа для генерации      | "РЫНОК"                          |

 #### Валидация полей

@@ -104,6 +106,15 @@ Authorization: Bearer <your_jwt_token>
 - Минимальная длина: 10 символов
 - Максимальная длина: 500 символов

+**`analysisType`** (string, обязательное)
+
+- Допустимые значения (регистр не важен, но рекомендуется использовать заглавные буквы):
+  - `"РЫНОК"` - Анализ рынка (размер рынка, динамика роста, сегменты, тренды)
+  - `"КОНКУРЕНТЫ"` - Анализ конкурентов (основные конкуренты, их сильные/слабые стороны, позиционирование)
+  - `"ЦА"` - Анализ целевой аудитории (демография, психография, потребности, поведение)
+  - `"КАНАЛЫ"` - Анализ маркетинговых каналов (эффективность каналов, рекомендации по выбору)
+  - `"SWOT"` - SWOT-анализ (сильные стороны, слабые стороны, возможности, угрозы)
+
 #### Пример запроса

 ```javascript
@@ -120,6 +131,7 @@ const response = await fetch(
      location: 'Нур-Султан, Казахстан',
      client: 'B2B клиенты',
      differentiator: 'Специализируемся на быстрой разработке MVP за 4 недели',
+      analysisType: 'РЫНОК',
    }),
  }
 );
@@ -976,6 +988,122 @@ async function getMyStrategies(jwtToken) {

 ---

+## Изменения: Поддержка типов анализов
+
+### Обзор изменений
+
+В API добавлена поддержка различных типов маркетинговых анализов. Теперь при создании анализа можно указать тип анализа, который определяет фокус и содержание генерируемого отчета.
+
+### Новое поле в запросе
+
+**Поле**: `analysisType` (обязательное)
+
+**Тип**: `string`
+
+**Допустимые значения**:
+
+- `"РЫНОК"` - Анализ рынка
+- `"КОНКУРЕНТЫ"` - Анализ конкурентов
+- `"ЦА"` - Анализ целевой аудитории
+- `"КАНАЛЫ"` - Анализ маркетинговых каналов
+- `"SWOT"` - SWOT-анализ
+
+### Описание типов анализов
+
+#### 1. РЫНОК
+
+Генерирует анализ рынка, включающий:
+
+- Размер рынка
+- Динамику роста
+- Основные сегменты
+- Тренды и перспективы развития
+
+#### 2. КОНКУРЕНТЫ
+
+Генерирует анализ конкурентов, включающий:
+
+- Основных конкурентов
+- Их сильные и слабые стороны
+- Позиционирование
+- Ценовую политику
+- Маркетинговые стратегии
+
+#### 3. ЦА (Целевая аудитория)
+
+Генерирует анализ целевой аудитории, включающий:
+
+- Демографические характеристики
+- Психографический профиль
+- Потребности и боли
+- Поведенческие паттерны
+- Предпочтения
+
+#### 4. КАНАЛЫ
+
+Генерирует анализ маркетинговых каналов, включающий:
+
+- Оценку эффективности различных каналов коммуникации
+- Рекомендации по выбору каналов
+- Особенности использования каждого канала
+- Бюджетные рекомендации
+
+#### 5. SWOT
+
+Генерирует SWOT-анализ, включающий:
+
+- Сильные стороны (Strengths)
+- Слабые стороны (Weaknesses)
+- Возможности (Opportunities)
+- Угрозы (Threats)
+
+### Изменения в ответе
+
+В ответе анализа теперь присутствует поле `analysisType` в объекте `reportData`, которое содержит название типа анализа.
+
+### Пример использования
+
+```javascript
+// Запрос на создание SWOT-анализа
+const response = await fetch(
+  'https://api.konturai.kz/api/marketing/analysis/start',
+  {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${jwtToken}`,
+    },
+    body: JSON.stringify({
+      product: 'Разработка мобильных приложений',
+      location: 'Нур-Султан, Казахстан',
+      client: 'B2B клиенты',
+      differentiator: 'Специализируемся на быстрой разработке MVP за 4 недели',
+      analysisType: 'SWOT', // Указываем тип анализа
+    }),
+  }
+);
+```
+
+### Рекомендации для фронтенда
+
+1. **UI для выбора типа анализа**: Добавьте выпадающий список или радиокнопки для выбора типа анализа перед отправкой запроса.
+
+2. **Валидация на фронтенде**: Убедитесь, что отправляется только один из допустимых значений.
+
+3. **Отображение типа анализа**: При показе результатов анализа отображайте тип анализа для контекста.
+
+4. **Обратная совместимость**: Если поле `analysisType` не указано, API вернет ошибку валидации. Это обязательное поле.
+
+### Миграция существующих интеграций
+
+Если у вас есть существующие интеграции, которые не используют поле `analysisType`, необходимо:
+
+1. Добавить поле `analysisType` в запрос
+2. Выбрать подходящий тип анализа по умолчанию или позволить пользователю выбрать
+3. Обновить UI для отображения выбора типа анализа
+
+---
+
 ## Поддержка

 При возникновении проблем с API обращайтесь в техническую поддержку с указанием: