Telegram-бот для створення QR-кодів з детальною аналітикою

Огляд проекту
QRCraft Bot - це повнофункціональний бот для генерації стильних QR-кодів з інтегрованою системою аналітики та відстеження. Проект демонструює комплексну архітектуру з веб-сервером для tracking, геолокацією по IP, аналітикою пристроїв та автоматизованою системою очищення даних.

Ключові можливості
- Генерація стильних QR-кодів: Три стилі оформлення з підтримкою логотипів, кольорових схем та різних розмірів
- Система відстеження сканувань: Веб-ендпоінт для перехоплення сканів з редиректом на оригінальний URL
- Детальна аналітика: Геолокація по IP, аналіз пристроїв, браузерів, часових паттернів та статистика по країнах
- Візуалізація даних: Автоматична генерація графіків сканувань з використанням matplotlib
- Автоматизована система очищення: Фонові задачі для видалення застарілих QR-кодів та оптимізації бази даних

Технічний стек
Backend:
- Python - асинхронне програмування з async/await
- SQLAlchemy - асинхронний ORM для роботи з базою даних
- aiogram - сучасний фреймворк для Telegram Bot API
- aiohttp - асинхронний HTTP сервер для tracking ендпоінтів

API Інтеграції:
- Telegram Bot API - основний інтерфейс користувача
- ipapi.co - геолокація по IP адресамї

DevOps & Tools:
- aiosqlite - асинхронний драйвер для SQLite
- PIL/Pillow - обробка зображень та генерація QR-кодів
- matplotlib - створення графіків та візуалізація статистики
- user-agents - парсинг User-Agent заголовків

Система відстеження та аналітики
- Проміжні URL: Створення tracking посилань для перехоплення сканувань перед редиректом
- Геолокація в реальному часі: Визначення країни та міста користувача через IP API
- Аналіз пристроїв: Детальний парсинг User-Agent для визначення браузера, ОС та типу пристрою
- Часова аналітика: Збір статистики по годинах та дням для виявлення паттернів використання

Обробка зображень та персоналізація
- Завантаження логотипів: Підтримка PNG/JPG до 1MB з автоматичним стисненням
- Видалення EXIF даних: Очищення метаданих для безпеки користувачів
- Кольорові схеми: Шість попередньо налаштованих кольорових комбінацій
- Адаптивні розміри: Три варіанти розмірів для різних випадків використання

Основний Flow
Створення QR-коду
URL введення -> вибір стилю -> налаштування -> генерація -> відправка QR з tracking URL

Перегляд статистики
Команда /stats_CODE -> витягування даних з БД -> рендеринг графіків -> відправка детальної аналітики

Детальний процес:
1. Введення URL - користувач надсилає посилання для створення QR-коду.
2. Вибір параметрів - стиль очей, кольори, розмір, логотип та термін дії.
3. Генерація QR - створення зображення з tracking URL та збереження в БД.
4. Відстеження сканів - веб-сервер перехоплює скани, збирає аналітику та робить редирект.
5. Аналітика - агрегація даних по країнах, пристроях, часу з генерацією звітів.

Посилання
GitHub: [https://github.com/YouCanTrustMe/QRCraftBot}

#python #pytelegrambot #aiogram #SQLite

#webanalytics #geo #pillow #matplotlib #asyncio #tracking #telebot #qr