AI Голосовий Помічник для Мобільного Оператора

## Про проект

Інтелектуальний голосовий і текстовий асистент для мобільного оператора Ucell (Узбекистан), здатний консультувати клієнтів з тарифів, відповідати на часті питання та надавати персоналізовані рекомендації на основі потреб користувача.

## Вирішувані завдання

- **Автоматизація консультацій**: Зниження навантаження на кол-центр за рахунок автоматичних відповідей на типові питання
- **Персоналізація**: Розумний підбір тарифів на основі аналізу потреб користувача (інтернет, дзвінки, SMS)
- **Мультимовність**: Повна підтримка російської та узбецької мов
- **24/7 доступність**: Цілодобова робота без вихідних

## Ключові можливості

**Голосовий і Текстовий Інтерфейс**
- Розпізнавання та синтез мови через Yandex SpeechKit з нативними голосами для RU/UZ
- Підтримка WebM, Opus, MP3 форматів
- Текстовий чат для письмового спілкування

**Інтелектуальна Система Рекомендацій**
- NLP аналіз вимог користувача
- Векторний пошук по базі з 50+ тарифних планів
- Персоналізовані рекомендації на основі потреб

**FAQ з Семантичним Пошуком**
- База знань: 29 питань-відповідей у 13 категоріях
- Векторний пошук з точністю 87-98%
- Автоматична векторизація нових FAQ
- Статистика переглядів для аналізу популярності

**Розширена Адмін-панель**
- Управління тарифами та FAQ через зручний інтерфейс
- Інлайн редагування, тестування схожості питань
- Детальні логи діалогів з часовими метриками
- Візуалізація статистики запитів

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

**Backend**: Django 5.2 (async), Django Ninja (REST API), PostgreSQL 16 + pgvector, Redis

**AI & ML**: OpenAI GPT-4, Yandex SpeechKit (STT/TTS), sentence-transformers (multilingual-e5-large), pgvector (векторний пошук)

**DevOps**: Docker & Docker Compose, Gunicorn + Uvicorn, Nginx, Systemd

**Додатково**: django-unfold, FFmpeg, cryptography, httpx

## Технічні особливості

**Асинхронна обробка**: Паралельна робота STT, векторного пошуку, AI генерації та TTS для мінімізації часу відповіді

**Векторний пошук**: Семантичне порівняння з threshold 0.7 для FAQ, кешування векторів для прискорення

**Контекстні діалоги**: Збереження історії останніх 10 повідомлень, безперервні діалоги з session_id, адаптивні промпти

**Аналітика**: Метрики часу для кожного етапу, підрахунок токенів, повне логування запитів

## Результати

- Обробка запитів: < 2 секунди на повний цикл (STT → AI → TTS)
- Точність FAQ: 87-98% релевантність семантичного пошуку
- Покриття: 29 FAQ у 13 категоріях, 50+ тарифних планів
- Безпека: API токени, шифрування даних (Fernet), CORS/CSRF захист, rate limiting
- Production-ready: Docker контейнери, автоматичні міграції, health checks, SSL/TLS

## Досягнення

Проект демонструє глибоке розуміння сучасних AI/ML технологій, досвід роботи з векторними базами даних, навички створення високонавантажених async систем та інтеграції складних зовнішніх API (Yandex, OpenAI), знання DevOps практик.

---

**Технології**: Python, Django 5.2, PostgreSQL, pgvector, Redis, Docker, OpenAI GPT-4, Yandex SpeechKit, NLP, Vector Search, REST API, Async/Await

**Термін розробки**: 3 тижні | **Статус**: Production-ready, активно використовується