🎯 Playwright AI Auto-Debug Demo Project

Демонстрационный проект для показа возможностей playwright-ai-auto-debug с интеграцией Allure.

🚀 Быстрый старт

1. Установка зависимостей

cd DemoProject
npm install

2. Установка браузеров

npx playwright install

3. Настройка API ключа

# Скопируйте файл окружения
cp env.example .env

# Отредактируйте .env и установите свой API ключ
# API_KEY=your-mistral-api-key-here

4. Запуск полной демонстрации

npm run demo:full

Эта команда выполнит:

1. Запуск тестов (5 упадут, 1 пройдет)
2. AI анализ ошибок
3. Генерацию Allure отчета
4. Открытие отчета в браузере

📋 Доступные команды

Тестирование

• npm test - запуск всех тестов
• npm run test:headed - запуск с видимым браузером
• npm run test:debug - запуск в режиме отладки

AI анализ

• npm run ai:debug - запуск AI анализа ошибок

Allure отчеты

• npm run allure:generate - генерация отчета
• npm run allure:open - открытие отчета
• npm run allure:serve - запуск сервера с отчетом

Утилиты

• npm run clean - очистка всех результатов

🧪 Демонстрационные тесты

Проект содержит 6 тестов:

✅ Проходящий тест

• Successful navigation test - проверка основной навигации

❌ Падающие тесты (для демонстрации AI анализа)

• Login timeout simulation - таймаут при поиске элемента
• Wrong title assertion - неправильная проверка заголовка
• Missing checkout button - отсутствующий элемент
• API response timeout - таймаут сети
• Form validation error - ошибка валидации формы

🤖 AI интеграция

Что происходит автоматически:

1. Тесты падают и создают файлы ошибок (error-context.md)
2. AI анализирует каждую ошибку и предлагает решения
3. Allure интеграция прикрепляет AI анализ к упавшим тестам
4. Умное сопоставление находит наиболее подходящие тесты для каждой ошибки

В Allure отчете вы увидите:

• 🤖 AI Debug Analysis - вложения с решениями для каждого упавшего теста
• 🏷️ ai-analyzed: true - метка для фильтрации тестов с AI анализом
• 📋 Структурированный контент - детали ошибки и конкретные рекомендации

📊 Структура проекта

DemoProject/
├── package.json              # Зависимости и скрипты
├── playwright.config.js      # Конфигурация Playwright + Allure
├── ai.conf.js               # Конфигурация AI с включенной Allure интеграцией
├── env.example              # Пример файла окружения
├── tests/
│   └── demo.spec.js         # Демонстрационные тесты
├── allure-results/          # Результаты Allure (создается автоматически)
├── allure-report/           # HTML отчет Allure (создается автоматически)
├── test-results/            # Результаты Playwright (создается автоматически)
└── ai-responses/            # AI ответы (создается автоматически)

🔧 Настройки

AI конфигурация (ai.conf.js)

• ✅ Allure интеграция включена (allure_integration: true)
• 🎯 Умное сопоставление тестов и ошибок
• 📝 Сохранение AI ответов в отдельные файлы
• 🚫 Предотвращение дублирования attachment'ов

Playwright конфигурация

• 📊 Allure репортер настроен с детальной информацией
• 🎥 Скриншоты и видео при падении тестов
• 🔍 Трейсы для отладки
• 🌐 Мульти-браузерность (Chromium, Firefox, WebKit)

🎯 Ожидаемый результат

После запуска npm run demo:full:

1. 5 тестов упадут, 1 пройдет
2. AI проанализирует каждую ошибку
3. Allure отчет откроется в браузере
4. В отчете будут видны AI Debug Analysis вложения для каждого упавшего теста

🔍 Что проверить в Allure отчете

• [ ] Все упавшие тесты имеют вложение "🤖 AI Debug Analysis"
• [ ] AI анализ содержит конкретные решения и примеры кода
• [ ] Можно фильтровать тесты по метке ai-analyzed: true
• [ ] Проходящий тест НЕ имеет AI анализа
• [ ] Каждый AI анализ уникален и соответствует конкретной ошибке

🆘 Устранение неполадок

Ошибка API ключа

# Проверьте что API ключ установлен
echo $API_KEY
# или проверьте файл .env

Проблемы с Allure

# Переустановите Allure
npm install -g allure-commandline

Очистка результатов

npm run clean