QAFlow-AI 🚀 | Intelligent QA Assistant

QAFlow-AI — это интеллектуальный инструмент автоматизации для QA-инженеров, который превращает скучную рутину в эффективный процесс. Бот анализирует документацию (User Stories), генерирует тест-кейсы с помощью AI, управляет процессом тестирования через Telegram и автоматически создает профессиональные баг-репорты.

---

⚡ Ключевые Возможности

🧠 1. AI-анализ требований

Загрузите файл с требованиями (.docx, .doc, .txt), и бот:

• Проанализирует бизнес-логику.
• Выделит модуль (например, "Auth & Security").
• Сгенерирует Checklist с позитивными и негативными сценариями на украинском языке.

📂 2. Модульная система

Все тест-кейсы группируются по модулям в единой Google Таблице.

• Вы можете загрузить несколько документов подряд.
• Бот предложит меню: начать новый модуль или продолжить тестирование незавершенных.
• Никакой потери контекста: состояние сохраняется в облаке.

🐞 3. Smart Bug Reporting

Если тест упал (Failed):

1. Бот спросит: "Что пошло не так?" (ваше краткое наблюдение).
2. AI сформирует профессиональный Bug Report на английском языке (Title, Description, Expected vs Actual Result).
3. Отчет автоматически запишется в Google Таблицу рядом с кейсом.

---

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

• Core: Python 3.11+
• Interface: aiogram 3.x (Asynchronous Telegram Bot Framework)
• AI Brain: Google Gemini 2.0 Flash (через google-genai SDK)
• Database: Google Sheets API (gspread)
• Parsing: python-docx, beautifulsoup4 (для HTML/Confluence доков), textract

---

🔄 Как это работает?

1. Start: Нажмите 🚀 Розпочати сесію тестування.
2. Upload: Отправьте файл с требованиями. Бот создаст новый модуль в таблице.
3. Select: Выберите модуль из списка активных задач.
4. Test: Бот присылает кейсы по одному.
   • Нажмите [✅ Pass] — ячейка в таблице станет зеленой.
   • Нажмите [❌ Failed] — бот запросит детали и запишет баг.
5. Result: Ваша Google Таблица наполняется результатами в реальном времени.

---

📦 Установка и запуск

1. Клонируйте репозиторий:

   git clone [https://github.com/your-username/QAFlow-AI.git](https://github.com/your-username/QAFlow-AI.git)
   cd QAFlow-AI

2. Создайте виртуальное окружение:

   python -m venv .venv
   # Windows:
   .venv\Scripts\activate
   # Mac/Linux:
   source .venv/bin/activate

3. Установите зависимости:

   pip install -r requirements.txt

4. Настройка:

   • Создайте файл .env и добавьте API ключи:

     BOT_TOKEN=ваш_телеграм_токен
     GEMINI_API_KEY=ваш_ключ_gemini
     SPREADSHEET_NAME=название_вашей_таблицы

   • Положите файл credentials.json (от Google Service Account) в корень проекта.
   • Не забудьте дать доступ сервисному аккаунту (email из json) к вашей Google Таблице.

5. Запуск:

   python bot.py

---

🚀 Планы (Roadmap)

• Интеграция Gemini 2.0 Flash
• Генерация Bug Reports на лету
• Поддержка .doc и Confluence-файлов
• Интеграция с Jira/Trello (авто-создание тикетов)
• Статистика тестирования (Dashboard)

---

Разработано с ❤️ и AI