Telegram-bot do tworzenia kodów QR z szczegółową analizą

Przegląd projektu
QRCraft Bot - to w pełni funkcjonalny bot do generowania stylowych kodów QR z zintegrowanym systemem analityki i śledzenia. Projekt demonstruje kompleksową architekturę z serwerem WWW do śledzenia, geolokalizacją po IP, analityką urządzeń oraz zautomatyzowanym systemem czyszczenia danych.

Kluczowe możliwości
- Generowanie stylowych kodów QR: Trzy style wykonania z obsługą logo, schematów kolorów i różnych rozmiarów
- System śledzenia skanów: Punkt końcowy WWW do przechwytywania skanów z przekierowaniem na oryginalny URL
- Szczegółowa analityka: Geolokalizacja po IP, analiza urządzeń, przeglądarek, wzorców czasowych oraz statystyki według krajów
- Wizualizacja danych: Automatyczne generowanie wykresów skanów z użyciem matplotlib
- Zautomatyzowany system czyszczenia: Zadania w tle do usuwania przestarzałych kodów QR oraz optymalizacji bazy danych

Stos technologiczny
Backend:
- Python - programowanie asynchroniczne z async/await
- SQLAlchemy - asynchroniczny ORM do pracy z bazą danych
- aiogram - nowoczesny framework dla Telegram Bot API
- aiohttp - asynchroniczny serwer HTTP do punktów końcowych śledzenia

API Integracji:
- Telegram Bot API - główny interfejs użytkownika
- ipapi.co - geolokalizacja po adresach IP

DevOps & Narzędzia:
- aiosqlite - asynchroniczny sterownik dla SQLite
- PIL/Pillow - przetwarzanie obrazów i generowanie kodów QR
- matplotlib - tworzenie wykresów i wizualizacja statystyk
- user-agents - parsowanie nagłówków User-Agent

System śledzenia i analityki
- Pośrednie URL: Tworzenie linków śledzących do przechwytywania skanów przed przekierowaniem
- Geolokalizacja w czasie rzeczywistym: Określenie kraju i miasta użytkownika przez IP API
- Analiza urządzeń: Szczegółowe parsowanie User-Agent w celu określenia przeglądarki, systemu operacyjnego i typu urządzenia
- Analityka czasowa: Zbieranie statystyk według godzin i dni w celu wykrywania wzorców użycia

Przetwarzanie obrazów i personalizacja
- Ładowanie logo: Obsługa PNG/JPG do 1MB z automatycznym kompresowaniem
- Usuwanie danych EXIF: Czyszczenie metadanych dla bezpieczeństwa użytkowników
- Schematy kolorów: Sześć wstępnie skonfigurowanych kombinacji kolorów
- Adaptacyjne rozmiary: Trzy opcje rozmiarów dla różnych przypadków użycia

Główny przepływ
Tworzenie kodu QR
URL wejściowy -> wybór stylu -> konfiguracja -> generacja -> wysyłka QR z tracking URL

Przegląd statystyk
Komenda /stats_CODE -> pobieranie danych z Bazy Danych -> renderowanie wykresów -> wysyłka szczegółowej analityki

Szczegółowy proces:
1. Wprowadzenie URL - użytkownik przesyła link do stworzenia kodu QR.
2. Wybór parametrów - styl oczu, kolory, rozmiar, logo i termin ważności.
3. Generacja QR - tworzenie obrazu z tracking URL i zapis w Bazie Danych.
4. Śledzenie skanów - serwer WWW przechwytuje skany, zbiera analitykę i wykonuje przekierowanie.
5. Analityka - agregacja danych według krajów, urządzeń, czasu z generowaniem raportów.

Linki
GitHub: [https://github.com/YouCanTrustMe/QRCraftBot}

#python #pytelegrambot #aiogram #SQLite

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