Files
marketing-parser/STARTUP_GUIDE.md
T
2025-10-14 01:55:42 +05:00

86 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Руководство по запуску приложения
## Приложение теперь запускается без 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 ключом