From f564ad30c41ae0502dacee0adb913bf05bd75257 Mon Sep 17 00:00:00 2001
From: root <root@localhost>
Date: Tue, 14 Oct 2025 01:55:42 +0500
Subject: [PATCH] .

---
 OPENAI_INTEGRATION.md | 31 +++++++++++++++-
 QUICK_FIX_401.md      | 56 ++++++++++++++++++++++++++++
 STARTUP_GUIDE.md      | 85 +++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 171 insertions(+), 1 deletion(-)
 create mode 100644 QUICK_FIX_401.md
 create mode 100644 STARTUP_GUIDE.md

diff --git a/OPENAI_INTEGRATION.md b/OPENAI_INTEGRATION.md
index 92ace39..1c1269f 100644
--- a/OPENAI_INTEGRATION.md
+++ b/OPENAI_INTEGRATION.md
@@ -103,10 +103,39 @@ String generatedText = openAIAnalyticsService.generateWithInstruction(data, inst
 
 ## Настройка
 
+### Настройка API ключа
+
 Убедитесь, что в `application.properties` указан корректный API ключ OpenAI:
 
 ```properties
-openai.api.key=your-openai-api-key-here
+openai.api.key=${OPENAI_API_KEY:your-openai-api-key-here}
 ```
 
+**Рекомендуется использовать переменную окружения:**
+
+```bash
+export OPENAI_API_KEY=sk-your-actual-api-key-here
+```
+
+### Тестирование API ключа
+
+Используйте скрипт для проверки API ключа:
+
+```bash
+./test-openai-api.sh
+```
+
+### Решение проблем
+
+**Ошибка 401 Unauthorized:**
+
+- Проверьте правильность API ключа
+- Убедитесь, что ключ не истек
+- Проверьте, что ключ начинается с `sk-`
+
+**Ошибка 429 Rate Limit:**
+
+- Превышен лимит запросов
+- Подождите некоторое время перед повторной попыткой
+
 Модель по умолчанию: `gpt-4o-mini` (можно изменить в настройках).
diff --git a/QUICK_FIX_401.md b/QUICK_FIX_401.md
new file mode 100644
index 0000000..9c5d76d
--- /dev/null
+++ b/QUICK_FIX_401.md
@@ -0,0 +1,56 @@
+# 🚨 Быстрое решение ошибки 401 Unauthorized
+
+## Проблема
+
+```
+OpenAI request failed: 401 Unauthorized from POST https://api.openai.com/v1/chat/completions
+```
+
+## ⚡ Быстрое решение
+
+### 1. Получите API ключ OpenAI
+
+- Перейдите на https://platform.openai.com/
+- Войдите в аккаунт
+- Создайте новый API ключ в разделе "API Keys"
+
+### 2. Установите переменную окружения
+
+```bash
+export OPENAI_API_KEY=sk-your-actual-api-key-here
+```
+
+### 3. Перезапустите приложение
+
+```bash
+mvn spring-boot:run
+```
+
+### 4. Проверьте работу
+
+Откройте: `GET /api/openai/test`
+
+## 🔧 Альтернативное решение
+
+Если не хотите использовать переменные окружения, отредактируйте файл `src/main/resources/application.properties`:
+
+```properties
+openai.api.key=sk-your-actual-api-key-here
+```
+
+## ✅ Проверка
+
+После настройки в логах должно появиться:
+
+```
+OpenAIAnalyticsService initialized with model: gpt-4o-mini
+```
+
+И тест должен вернуть результат анализа текста вместо ошибки 401.
+
+## 📞 Если проблема остается
+
+1. Убедитесь, что API ключ начинается с `sk-`
+2. Проверьте, что ключ не истек
+3. Убедитесь, что у вас есть доступ к OpenAI API
+4. Проверьте баланс аккаунта OpenAI
diff --git a/STARTUP_GUIDE.md b/STARTUP_GUIDE.md
new file mode 100644
index 0000000..844a921
--- /dev/null
+++ b/STARTUP_GUIDE.md
@@ -0,0 +1,85 @@
+# Руководство по запуску приложения
+
+## Приложение теперь запускается без API ключа!
+
+Приложение было исправлено и теперь может запускаться даже без настройки OpenAI API ключа.
+
+## Быстрый запуск
+
+### 1. Запуск без API ключа
+
+```bash
+mvn spring-boot:run
+```
+
+Приложение запустится успешно, но OpenAI функции будут возвращать сообщения об ошибке конфигурации.
+
+### 2. Запуск с API ключом
+
+```bash
+export OPENAI_API_KEY=sk-your-actual-api-key-here
+mvn spring-boot:run
+```
+
+## Проверка статуса
+
+После запуска откройте: `GET /api/openai/test`
+
+**Без API ключа:**
+
+```
+OpenAI Analytics Service Test:
+Summary: OpenAI API key not configured
+Sentiment: neutral
+Tags: api-key-not-configured
+Entities: {}
+
+WARNING: OpenAI API key is not configured!
+Please set OPENAI_API_KEY environment variable or update application.properties
+```
+
+**С API ключом:**
+
+```
+OpenAI Analytics Service Test:
+Summary: [реальный анализ текста]
+Sentiment: [анализ тональности]
+Tags: [извлеченные теги]
+Entities: {[сущности]}
+
+OpenAI API is working correctly!
+```
+
+## Доступные эндпоинты
+
+- `GET /api/openai/test` - тест подключения
+- `POST /api/openai/analyze?text=...&language=ru` - анализ текста
+- `POST /api/openai/generate?text=...&instruction=...&language=ru` - генерация текста
+
+## Настройка API ключа
+
+### Вариант 1: Переменная окружения (рекомендуется)
+
+```bash
+export OPENAI_API_KEY=sk-your-actual-api-key-here
+```
+
+### Вариант 2: Прямо в application.properties
+
+```properties
+openai.api.key=sk-your-actual-api-key-here
+```
+
+## Важные изменения
+
+1. **Приложение запускается** даже без API ключа
+2. **OpenAI функции** возвращают понятные сообщения об ошибках
+3. **Логи показывают** статус конфигурации API ключа
+4. **Тестовый эндпоинт** показывает текущий статус
+
+## Следующие шаги
+
+1. Запустите приложение
+2. Проверьте статус через `/api/openai/test`
+3. При необходимости настройте API ключ
+4. Перезапустите приложение с API ключом