Scadenziario Consegne (Delivery Tracker) v2.6.0

Un'applicazione desktop moderna e completa in Python per gestire le scadenze delle consegne da diverse piattaforme online.

✨ Funzionalità Principali

📦 Gestione Ordini Completa

• Tracciamento Dettagliato: Monitora ordini con informazioni complete:
  • Data Ordine e Consegna Prevista
  • Piattaforma (con suggerimenti predefiniti: Amazon, eBay, AliExpress, ecc.)
  • Venditore e Destinazione
  • Descrizione Oggetto
  • Link cliccabile al prodotto
  • Quantità
  • ID Ordine Sito (es. Amazon: 123-1234567-1234567)
  • Stato Dinamico colorato (In Attesa, Spedito, In Transito, ecc.)
  • Posizione fisica (Magazzino, Casa, Ufficio, ecc.)
  • Categoria personalizzabile
  • Note per difformità o difetti

🎨 Interfaccia Utente Moderna

• Design Premium: Interfaccia moderna con gradientie colori curati
• Tema Chiaro/Scuro: Supporto per entrambi i temi
• Dashboard Interattiva: Visualizzazione statistiche con grafici
  • Grafico a torta per distribuzione piattaforme
  • Grafico a barre per stato consegne
  • Card statistiche in tempo reale
• Sidebar Collassabile: Ottimizza lo spazio di lavoro
• Ricerca e Filtri Avanzati:
  • Ricerca globale in tutti i campi (Tracking, ID Ordine, Destinazione, ecc.)
  • Filtro per piattaforma e categoria
  • Mostra/nascondi ordini consegnati

🔔 Sistema di Allarmi Visivi

• Verde: Materiale consegnato (evidenziazione intera riga)
• Rosso: Consegna scaduta
• Arancione: Consegna prevista per oggi
• Giallo: Consegna in arrivo (entro 2 giorni)
• Notifiche Popup: Avviso all'avvio per consegne scadute

📊 Export/Import Dati

• Export Multipli Formati:
  • Excel (.xlsx): Con formattazione colori e stili
  • CSV: Per compatibilità universale
  • JSON: Per backup completi
• Import JSON: Importa ordini da file JSON

💾 Backup Automatico

• Backup automatico del database
• Gestione automatica dei backup (mantiene ultimi 10)
• Creazione backup manuale dalle impostazioni
• Ripristino da backup
• Archiviazione Immagini Locale: Download e salvataggio automatico delle immagini nel DB (BLOB) per uso offline.

⚙️ Impostazioni Personalizzabili

• Selezione tema (Chiaro/Scuro)
• Configurazione notifiche
• Giorni di anticipo per allarmi
• Integrazione Email OAuth2 (Hotmail/Outlook)
• Backup automatico
• Visualizzazione ordini consegnati

📧 Sincronizzazione Email Avanzata

• Auto-Tracking: Estrazione automatica di tracking, vettore e stato dalle email.
• Supporto Multilingua: Rilevamento termini in Italiano e Inglese.
• Smart Matching: Associazione intelligente basata su numero di tracking o ID ordine.

🔍 Funzionalità Avanzate

• Menu Contestuale: Click destro per azioni rapide
• Doppio Click: Modifica rapida ordini
• Validazione Input: Controlli su URL, quantità e campi obbligatori
• Logging Completo: Tracciamento di tutte le operazioni
• Performance Ottimizzate: Indici database per query veloci
• Ordinamento Colonne: Click su intestazioni per ordinare
• Ricerca Globale: Trova ordini per Numero di Tracking, ID Sito o Destinazione istantaneamente.
• Preview Immagini: Tooltip con miniature (150px) ricavate dal database locale al passaggio del mouse su qualsiasi cella.

🛍️ Piattaforme Supportate

L'applicazione include parser avanzati e workflow ottimizzati per le seguenti piattaforme principali:

• ✅ Amazon (Estrazione automatica e parsing date intelligente)
• ✅ AliExpress (Deep Scraping di tracking, venditore e date)
• ✅ eBay (Workflow di importazione assistito)
• ✅ Temu (Workflow di importazione assistito)

Important

Hai bisogno di supporto per un'altra piattaforma (es. Vinted, Shein, Zalando, ecc.)? Apri una Issue su GitHub per farne esplicita richiesta! Svilupperemo nuovi parser in base ai suggerimenti della community.

📥 Installazione Rapida (Linux)

Il modo più semplice per configurare tutto è usare lo script di setup automatizzato:

git clone https://github.com/losciuto/delivery-tracker.git
cd delivery-tracker
chmod +x setup.sh
./setup.sh

Questo script configurerà l'ambiente virtuale, installerà le dipendenze e verificherà le librerie di sistema.

---

🛠️ Requisiti

• Python 3.8+
• PyQt6
• PyQt6-Charts
• openpyxl (per export Excel)

📥 Installazione Manuale

Se preferisci installare manualmente:

1. Clona o scarica la repository:

git clone https://github.com/losciuto/delivery-tracker.git
cd delivery-tracker

2. Installa le dipendenze (si consiglia l'uso di un ambiente virtuale):

pip install -r requirements.txt

🚀 Utilizzo

Avvia l'applicazione con lo script di avvio rapido:

./run.sh

Oppure manualmente:

python main.py

Prima Configurazione

1. All'avvio, l'applicazione creerà automaticamente il database
2. Accedi alle Impostazioni per configurare tema e notifiche
3. Inizia ad aggiungere i tuoi ordini!

Navigazione

• Dashboard: Visualizza statistiche e panoramica generale
• Ordini: Gestisci la lista completa degli ordini
• Sidebar: Accesso rapido a tutte le funzioni
• Menu File: Export/Import dati
• Menu Visualizza: Cambia vista rapidamente

Gestione Ordini

• Aggiungi: Click su "Aggiungi" nella sidebar o Ctrl+N
• Modifica: Doppio click su un ordine o seleziona e click "Modifica"
• Elimina: Seleziona e click "Elimina" (con conferma)
• Segna Consegnato: Click destro → "Segna come Consegnato"

Ricerca e Filtri

• Usa la barra di ricerca per trovare ordini specifici
• Filtra per piattaforma o categoria
• Nascondi ordini consegnati per focus sui pendenti

📁 Struttura Progetto

delivery-tracker/
├── main.py              # Entry point con styling
├── gui/                 # Package interfaccia grafica
│   ├── __init__.py      # Espone MainWindow
│   ├── main_window.py   # Logica principale finestra
│   └── dialogs.py       # Dialoghi (Ordine, Impostazioni)
├── database.py          # Gestione database SQLite
├── config.py            # Configurazioni e temi
├── utils.py             # Utility e helper functions
├── widgets.py           # Widget personalizzati (Dashboard, ecc.)
├── export_manager.py    # Gestione export/import
├── requirements.txt     # Dipendenze Python
├── README.md           # Questo file
├── README_EN.md        # English version
├── LICENSE             # Licenza GPL-3.0
├── logs/               # File di log (auto-creato)
├── backups/            # Backup database (auto-creato)
└── delivery_tracker.db # Database SQLite (auto-creato)

🔧 Tecnologie Utilizzate

• PyQt6: Framework GUI moderno
• PyQt6-Charts: Grafici e visualizzazioni
• SQLite: Database leggero e veloce
• openpyxl: Export Excel con formattazione
• Python logging: Sistema di logging robusto

📝 Note Tecniche

Database

• Utilizza SQLite con indici ottimizzati
• Foreign keys abilitate per integrità referenziale
• Migrazione automatica per nuove colonne
• Supporto per categorie e allegati (futuro)

Performance

• Indici su colonne frequentemente interrogate
• Query ottimizzate con filtri
• Caricamento lazy dei dati
• Caching intelligente

Sicurezza

• Validazione input completa
• Gestione errori robusta
• Backup automatici
• Logging di tutte le operazioni

🐛 Risoluzione Problemi

L'applicazione non si avvia

• Verifica che Python 3.8+ sia installato
• Controlla che tutte le dipendenze siano installate: pip install -r requirements.txt
• Controlla i log in logs/ per errori specifici

Errori di export Excel

• Assicurati che openpyxl sia installato: pip install openpyxl

Database corrotto

• Ripristina da un backup in backups/
• O elimina delivery_tracker.db per ricrearlo (perderai i dati)

🔄 Aggiornamenti v2.6.0

• ✅ Ricerca Globale Ottimizzata: Estesa la ricerca a tutti i campi (Tracking, ID Ordine Sito, Destinazione, Vettore, ecc.).
• ✅ Persistence Imaging (BLOB): Le immagini dei prodotti vengono ora scaricate e memorizzate direttamente nel database.
• ✅ Thumbnail Tooltips: Visualizzazione istantanea di una miniatura dell'articolo (150x150) passando con il mouse su qualsiasi cella della riga.
• ✅ AliExpress Deep Scraping: Estrazione automatica avanzata di Venditore, Destinazione, Numero di Tracking e Consegna Stimata.

🔄 Aggiornamenti v2.4.0

• ✅ Merge Intelligente Duplicati: Possibilità di unire dati da file esterni in ordini esistenti, riempiendo solo i campi vuoti.
• ✅ Logica Best-Match: Sistema di associazione articoli per ordini multi-prodotto basato su tokenizzazione delle descrizioni.
• ✅ Documentazione Scraping: Nuova guida sulle Soluzioni di Scraping e workflow assistiti.

🔄 Aggiornamenti v2.3.0

• ✅ Importazione Universale: Supporto per Excel, CSV e JSON con anteprima e rilevamento duplicati intelligente.
• ✅ Dati Prodotto: Nuovi campi per Prezzo e Link Immagine con visualizzazione in tabella.
• ✅ IA Scraping: Workflow /import-temu per l'estrazione automatizzata di ordini complessi via browser.
• ✅ Cleanup UI: Rimozione delle procedure di importazione HTML/URL obsolete per una maggiore stabilità.

🔄 Aggiornamenti v2.2.1

• ✅ Ottimizzazione UI: Layout migliorato per monitor da 19" e riorganizzazione sidebar.
• ✅ Azioni Rapide: Pulsante Aggiorna spostato in posizione prioritaria.

🔄 Aggiornamenti v2.2.0

• ✅ Email Sync 2.0:
  • Scansione dinamica basata sulle piattaforme attive nel database.
  • Supporto ottimizzato per Too Good To Go.
  • Estrazione ID Temu migliorata (supporto 15-20 cifre).
  • Priorità estrazione Order ID rispetto al Tracking per evitare sovrapposizioni.
  • Logica "Smart State": priorità all'oggetto email e riconoscimento conferme d'ordine.
• ✅ UI & UX:
  • Raggruppamento Ordini: Evidenziazione dinamica degli articoli appartenenti allo stesso ID Ordine.
  • Indicatore Visivo: Icona 🔗 per ordini multipli.
  • Duplicazione Intelligente: Funzione per copiare un ordine esistente.
  • Ordinamento LIFO predefinito e alfabetizzazione di piattaforme e categorie.

🔄 Aggiornamenti v2.1.1

• ✅ Fix Impostazioni: Campo email ora modificabile manualmente.

🔄 Aggiornamenti v2.1.0

• ✅ ID Ordine Sito: Nuovo campo per tracciamento ordini Amazon/eBay/ecc.
• ✅ Stato Dinamico: Colonna stato con colorazione condizionale intelligente.
• ✅ Email Sync Pro:
  • Supporto IT/EN completo.
  • Ricerca per data (SINCE) e scansione folder ottimizzata.
  • Fix bug estrazione e logging avanzato.

🔄 Aggiornamenti v2.0.2

• ✅ Fix: Risolto problema dipendenza mancante (PyQt6-Charts)
• ✅ UI: Icone sidebar più intuitive e moderne
• ✅ Miglioramenti: Stabilità generale e cleanup codice

🔄 Aggiornamenti v2.0.0

Nuove Funzionalità

• ✅ Dashboard con statistiche e grafici
• ✅ Ricerca e filtri avanzati
• ✅ Export Excel con formattazione
• ✅ Sistema di backup automatico
• ✅ Supporto categorie
• ✅ Tema chiaro/scuro
• ✅ Impostazioni personalizzabili
• ✅ Menu contestuale
• ✅ Validazione input migliorata
• ✅ Logging completo

Miglioramenti

• ✅ UI/UX completamente ridisegnata
• ✅ Performance ottimizzate con indici database
• ✅ Codice modulare e manutenibile
• ✅ Gestione errori robusta
• ✅ Documentazione completa

👨‍💻 Autore

Massimo Lo Sciuto

• Supporto: Antigravity
• Sviluppo: Gemini 3 Pro

📄 Licenza

Questo progetto è rilasciato sotto licenza GPL-3.0. Vedi il file LICENSE per i dettagli.

🤝 Contributi

I contributi sono benvenuti! Sentiti libero di aprire issue o pull request.

📧 Supporto

Per supporto o domande, apri una issue su GitHub.

---

Buon tracciamento delle tue consegne! 📦✨