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, активно используется