Calcolo Spedizioni

6.5.0 - Soft Delete Spedizioni + Fix Amministrazione + UX

Soft Delete Spedizioni:
- Cestino: Le spedizioni eliminate vengono spostate nel cestino invece di essere cancellate definitivamente
- Ripristino: Gli admin possono ripristinare spedizioni dal cestino tramite il pannello Cestino in admin.php
- Migration 23: Aggiunta colonna deleted_at DATETIME NULL con indice su tabella spedizioni
- Amministrazione: Le spedizioni nel cestino sono ora escluse da statistiche e lista finanziaria
Fix Messaggi Admin:
- Toast Fissi: I messaggi di conferma/errore ora sono toast in posizione fissa e non spostano la lista spedizioni (eliminato rischio di cliccare sulla riga sbagliata)
Fix Tariffa Internegozio Elita:
- Errore "non trovata tariffa per 48km": Risolto bug nel calcolo fascia per spedizioni con peso ≤ 30kg a distanze medio-lunghe
- Allineamento PHP/JS: La logica PHP ora usa la stessa strategia best-of del frontend JS (fasciaPerPeso vs fasciaPerDistanza, vince quella con tariffa_base più alta)
UX Calcolatore Udine:
- Rimosso bottone "Crea Spedizione Rhenus": Il calcolatore mostra solo il preventivo Rhenus, la creazione avviene tramite la pagina dedicata

6.4.1 - Fix Calcolo Tariffa Internegozio + UX Elita

Bug Fix - Tariffa Internegozio:
- Calcolo sempre server-side: La tariffa fornitore per spedizioni internegozio ora viene sempre ricalcolata server-side, eliminando il bug che causava tariffa = 0 quando si accedeva a Elita senza passare dal calcolatore
- ID filiale dinamico: Corretto bug con ID Udine hardcoded (era 1 nel JS), ora usa l'ID reale dalla risposta API
- Fascia per peso eccedente: Per spedizioni con peso > 30kg la fascia tariffaria viene cercata solo per distanza (non peso+distanza), allineando il calcolo server-side al client-side
- Sovrapprezzo per 10kg: Corretto calcolo sovrapprezzo da "per kg" a "per 10kg" come da tariffe reali
UX - Pagina Elita:
- Consegna al piano disabilitata per internegozio: Il flag viene automaticamente deselezionato e disabilitato quando si seleziona il tipo spedizione internegozio (non applicabile)
- Redirect post-salvataggio: Dopo la generazione dell'etichetta e conferma, l'utente viene reindirizzato al Gestore Spedizioni invece di restare sulla pagina con form resettato

6.4.0 - Navigazione Rapida con Sidebar Menu

Hamburger Menu + Sidebar Drawer:
- Nuovo Componente: Drawer laterale slide-in con navigazione rapida a tutti i servizi
- Filtro per Ruolo: Voci menu filtrate automaticamente in base al ruolo utente
- Pagina Attiva: Evidenziazione della pagina corrente nel menu
- Animazione: Slide-in/out con overlay semitrasparente, chiusura via ESC o click esterno
- Mobile-First: Ottimizzato per smartphone, accessibile da tutte le 8 pagine autenticate
Header Semplificato:
- Rimosso Pulsante Hub: Navigazione ora gestita dal sidebar menu, header meno affollato
- Logo Visibile: Piu spazio per il logo JYSK su schermi piccoli
Pulizia Codebase:
- File Rimossi: migration.php, api/migration-api.php, migrations/, tariffe.json, gs.js, Elita.csv
- Directory Rimosse: legacy/, docs/, scripts/ (file obsoleti post-migrazione MySQL)
- Risultato: -8800 righe di codice non piu utilizzato

6.3.4 - Controllo Stati + Amministrazione Migliorata

🔄 Gestione Stati Spedizioni:
- Cambio Stato Admin: Solo admin puo retrocedere lo stato di una spedizione (es. da affidata a creata)
- Dropdown Stato: Nuovo selettore stato per admin direttamente nella lista spedizioni
- Controllo Server: Validazione lato server impedisce retrocessioni da utenti non admin
💰 Amministrazione Finanziaria:
- Modifica Tariffa Cliente: Ora e possibile modificare anche la tariffa cliente oltre a quella fornitore
- Modal Unificato: Un unico modal mostra entrambe le tariffe con ricalcolo margine automatico
- Filtro Date: Le date personalizzate ora filtrano automaticamente al cambio valore
🎨 UX Migliorata:
- Modal Affidamento: Conferma affidamento al corriere con modal custom invece di alert browser
🐛 Bug Fix:
- Filtro Esportazione: Corretto bug critico: l'esportazione ignorava il filtro stato e esportava tutte le spedizioni

6.3.2 - Fix Migrazione + Archiviazione Automatica

🔄 Migrazione Sistema Migliorata:
- Abbinamento PDF: Usa FATTURA_PDF_ID da Google Sheets per abbinare automaticamente i PDF
- Stato Spedizioni: Le spedizioni migrate ora hanno stato 'affidata' (visibili in admin)
- Interfaccia Web: Pannello migrazione accessibile da Hub per admin
📦 Archiviazione Automatica:
- Auto-Archiviazione: Spedizioni 'affidata' o 'consegnata' piu vecchie di 60 giorni vengono archiviate automaticamente
- Nessun Cronjob: Processo eseguito all'apertura di admin.php
- Predisposto Tracking: Pronto per futura integrazione API tracking vettori
🐛 Bug Fix:
- Permessi Admin: Corretto bug che impediva agli admin di modificare/eliminare spedizioni esportate

6.3.1 - Hub Servizi + Migrazione Sistema + Calcolatore Materassi

🏠 Hub Servizi (hub.php):
- Pagina Indice: Nuova pagina di selezione servizi post-login
- Servizi per Ruolo: Calcolatore Materassi (tutti), Spedizioni Elita (3109+admin), Rhenus (altri negozi)
- Cards Interattive: Design moderno con accesso rapido ai servizi disponibili
- Redirect Unificato: Tutti gli utenti vengono reindirizzati all'hub dopo il login
🛏️ Calcolatore Materassi (materassi.php):
- SSO Integrato: Richiede autenticazione come tutti gli altri servizi
- Hilding Anders: Calcolo prezzi misure speciali materassi
- Navigazione: Link "Indietro" per tornare all'hub
🔄 Sistema Migrazione da Google Sheets:
- Script PHP: migrations/migrate_from_sheets.php per importazione CSV
- Script GAS: migrations/export_pdf_from_drive.gs per export PDF fatture
- Mapping Completo: 42 colonne Google Sheets → schema MySQL
- Migrazione PDF: Supporto per trasferimento fatture da Google Drive
- Modalita Dry-Run: Simulazione prima dell'import reale
🎨 Restyling Completo Amministrazione:
- Layout Compatto: Header minimale, filtri inline, KPI in barra orizzontale
- Piu Spazio Tabella: Tabella spedizioni occupa la maggior parte dello schermo con scroll interno
- Filtri Rapidi: Pulsanti preset per Oggi, Settimana, Mese, Anno
- Sticky Header: Intestazioni tabella fisse durante lo scroll
- Icone SVG: Pulsanti azione con icone vettoriali
📄 Upload PDF Fatture:
- Drag & Drop: Area drag-and-drop per caricare PDF fattura nel modal riconciliazione
- Validazione: Solo file PDF, max 10MB
- Link Download: Nella tabella, link diretto al PDF se presente
- Nuovo Endpoint: api/upload-fattura.php per gestione upload
🗄️ Database:
- Nuova Colonna: pdf_fattura per salvare nome file PDF
- Script: 21_add_pdf_fattura_column.sql
📋 Admin Spedizioni (admin.php):
- Ordinamento Corretto: Spedizioni ordinate dalla piu recente alla meno recente
- Filtro Stati Completo: Aggiunti tutti gli stati (Da inviare, Esportata, Affidata, In transito, Consegnata, In giacenza, Problema, Annullata)
- Restrizioni Permessi: Dopo l'esportazione, solo gli admin possono modificare o eliminare spedizioni

6.2.6BETA - Bugfix e Migliorie Admin/Amministrazione

📋 Admin Spedizioni (admin.php):
- Ricerca e Filtri: Nuova barra di ricerca testuale (nome, citta, ID, CAP) e filtri per tipo spedizione e stato
- Badge Internegozio: Le spedizioni internegozio sono evidenziate con bordo viola e badge "Internegozio"
- Rimosso Export Excel: Eliminato pulsante "Export Excel" ridondante, mantenuto solo "Esporta e Invia"
- Ordinamento: Spedizioni ordinate dalla piu recente alla meno recente (default)
💰 Amministrazione Finanziaria:
- Badge Tipo: Badge "INT" per internegozio e "NEG" per spedizioni a costo negozio
- Tariffa Cliente a Costo Negozio: Se flaggato "a costo negozio", tariffa cliente = 0 (barrata con nota)
- Modifica Tariffa Fornitore: Possibilita di modificare tariffa fornitore per riconciliazione fatture
- Ricalcolo Margine: Il margine si ricalcola automaticamente quando si modifica la tariffa
🔧 Backend:
- Tariffa Cliente Auto-Zero: Quando a_costo_negozio=true, tariffa_cliente viene salvata come 0
- Nuovo Endpoint: modificaTariffaFornitore per aggiornamento tariffa con ricalcolo margine

6.2.5BETA - Nuova Amministrazione Finanziaria

🔄 Riscrittura Amministrazione:
- Migrazione a MySQL: Eliminata dipendenza da Google Sheets, ora utilizza API MySQL locale
- Dashboard KPI: Nuova dashboard con indicatori chiave (spedizioni, fatturate, in attesa, margine)
- Dettaglio Margini: Sezione dedicata con costo fornitore, ricavo cliente e margine percentuale
- Ricerca Avanzata: Filtro per destinatario, città, ID spedizione con ricerca testuale
- Riconciliazione Fatture: Modal dedicata per inserimento numero fattura e note
- Flag Bulk: Possibilità di marcare/smarcare multiple spedizioni come fatturate
- Layout Responsive: Interfaccia ottimizzata per desktop e mobile
🔌 Nuovi Endpoint API:
- leggiTuttoAmministrazione: Lettura spedizioni con dati finanziari e statistiche aggregate
- flagFatturato: Flag singola spedizione come fatturata
- flagFatturatoBulk: Flag multiplo spedizioni
- statisticheFinanziarie: Statistiche aggregate per periodo/mese

6.2.4BETA - Bugfix e Layout Mobile Admin

🔧 Bugfix:
- Dati Filiale Udine: I dati (telefono, email, indirizzo) ora vengono caricati da database invece che hardcoded
- Ristampa Etichetta: Corretto passaggio parametro "azienda" per layout B2B
📱 Layout Mobile Admin:
- Header: Pulsanti in griglia 2 colonne su mobile
- Card Spedizioni: Layout responsivo con azioni che si adattano
- Statistiche: Compatte su mobile, espanse su desktop
- Padding: Ridotto su schermi piccoli per ottimizzare spazio

6.2.3BETA - Correzione Zone Altimetriche FVG

🏔️ Zone Altimetriche:
- Criteri Elita: "Montana" = solo zone alte (Carnia, Tarvisiano, Dolomiti Friulane)
- 11 Comuni corretti: Amaro, Cavazzo Carnico, Venzone, Verzegnis, Montenars (UD) + Aviano, Maniago, Sequals, Travesio, Meduno, Fanna (PN)
- Script SQL 20: 20_fix_zone_altimetriche_fvg.sql

6.2.2BETA - Elita Opera il Sabato

📅 Consegne Sabato Elita:
- Nuova Funzionalità: Elita ora accetta consegne il sabato
- Maggiorazione Cliente: +30% sul prezzo cliente (come Rhenus)
- Tariffa Fornitore: Rimane invariata (giorni feriali)
- Ordine Calcolo: Margine fascia → Sabato 30% → IVA → Arrotondamento
- Note Corriere: "Richiesta spedizione il sabato" aggiunta automaticamente
🗄️ Database:
- Script SQL 19: 19_add_sabato_moltiplicatore_elita.sql
- Nuova Costante: SABATO_MOLTIPLICATORE = 1.30 in tariffe_costanti (vettore_id=1)

6.2.1BETA - Distanze Udine per Comuni Confine Veneto

📍 Distanze Udine → Comuni Confine:
- 23 Comuni Aggiornati: Calcolate distanze stradali da Martignacco (Udine) per tutti i comuni Veneto con elita_ok=1
- Province Coperte: VE (9 comuni), TV (4 comuni), BL (10 comuni Cadore)
- Script SQL 18: 18_update_distanze_udine_comuni_confine.sql

6.2.0BETA - Supporto Multi-Filiale e Indicatori Vettori Automatici

🏪 Architettura Multi-Filiale:
- Distanze per Filiale: Database esteso con distanze da Udine (Martignacco) e Portogruaro
- Colonne Aggiuntive: distanza_udine_km, distanza_portogruaro_km
- CAP Veneto: Aggiunti 214 comuni delle province di Belluno, Treviso e Venezia
🚚 Indicatori Disponibilità Vettori:
- elita_ok: Indica se un CAP è servito da Elita (0=no, 1=sì)
- rhenus_zona: Indica la zona Rhenus (1=Udine tariffa normale, 2=Padova fuori zona, 3=entrambi)
- Calcolo Automatico: Il sistema determina automaticamente disponibilità vettori e tariffa applicabile
🖥️ Calcolatore Udine Semplificato:
- Rimosso: Input distanza manuale (ora tutto automatico da database)
- Rimosso: Checkbox "fuori regione" (calcolato in base a rhenus_zona)
- Info Vettori: Mostra disponibilità vettori nel suggerimento destinazione
📊 Migration Database:
- 15_migrate_cap_comuni_multi_filiale.sql: Struttura tabella multi-filiale
- 16_update_fvg_distanze_portogruaro.sql: Distanze Portogruaro→FVG
- 17_insert_cap_veneto.sql: CAP Veneto con indicatori

6.1.1BETA - Gestione Ragione Sociale e Correzioni Distanze

📝 Gestione Ragione Sociale B2B:
- Campo Facoltativo: Aggiunto campo "Ragione Sociale" in elita.php per spedizioni verso aziende (B2B)
- Etichette PDF Intelligenti: Logica priorità visualizzazione:
  - Se presente azienda + nome/cognome: azienda in grassetto, nome/cognome sotto in normale
  - Se solo nome/cognome: visualizzazione in grassetto
  - Se solo azienda: visualizzazione in grassetto
- Database: Nuova gestione campo mit_azienda e dest_azienda
🏢 Internegozio - Nome Azienda Standardizzato:
- Mittente e Destinatario: Sempre "JYSK Italia srl" nel database per tutte le spedizioni interfiliali
- Etichette PDF: Mostrano "JYSK Italia srl" + nome filiale sotto (es. "Fiume Veneto 3120")
- Admin: Visualizzazione prioritaria filiale destinataria (es. "JYSK Fiume Veneto 3120")
📊 Admin - Visualizzazione Intelligente:
- Priorità 1 Internegozio: Mostra filiale destinataria specifica (es. "JYSK Fiume Veneto 3120")
- Priorità 2 B2B: Mostra ragione sociale cliente (escluso "JYSK Italia srl")
- Priorità 3 B2C: Mostra nome e cognome cliente
📍 Correzioni Distanze Filiali:
- Udine ↔ Fiume Veneto: 48 km (era 45.5 km)
- Udine ↔ Portogruaro: 65 km (era 85.2 km)
- Fiume Veneto ↔ Portogruaro: 22 km (era 40 km)
- Rimozione Conegliano: Distanze con Conegliano eliminate (non può fare internegozio Elita)
- Migration 14: Ridotto da 12 a 6 record (3 coppie bidirezionali)
🔧 Supporto Ristampa PDF:
- Aggiunto supporto campo azienda nei parametri URL ristampa
- Visualizzazione corretta ragione sociale nelle ristampe

6.1.0BETA - Calcolo Tariffe Server-Side e Auto-Calcolo Internegozio

⚙️ TariffaService.php - Single Source of Truth:
- Servizio Centralizzato: Tutta la logica calcolo tariffario spostata su backend PHP
- Metodi Completi: calcolaElita(), calcolaRhenus(), calcolaInternegozio()
- Sicurezza: Formule tariffarie protette lato server, non più esposte nel frontend
- Manutenibilità: Modifiche tariffe richiedono update solo in TariffaService.php
🔄 Auto-Calcolo Tariffe in Spedizione::create():
- Logica Intelligente: Se tariffe = 0, backend calcola automaticamente
- Backward Compatibility: Se tariffe fornite dal frontend, vengono usate quelle
- Fix Bug Internegozio: Risolto problema tariffe = 0€ per spedizioni interfiliali dirette da elita.php
- Logging: Log dettagliati per debug calcoli automatici vs pre-calcolati
🏢 Tabella distanze_filiali:
- Migration 14: Nuova tabella distanze_filiali con distanze precompilate
- Distanze Reali: Valori stradali (Google Maps) tra tutte le coppie di filiali abilitate
- Query Simmetrica: Ricerca automatica in entrambe le direzioni (A→B, B→A)
- Utilizzo: Calcolo internegozio usa distanza da tabella invece di GPS runtime
🔌 Nuovo Endpoint API calcolaTariffa:
- Preview Senza Salvare: Calcola tariffe senza creare record database
- Multi-Vettore: Supporto Elita, Rhenus, Internegozio tramite parametro vettore
- JSON Response: Ritorna tariffa_fornitore, tariffa_cliente, margini, fascia, dettagli
- Uso Futuro: Permette frontend di usare calcolo server invece di JS locale
🐛 Fix Bug NaN Tariffe (Calcolatori):
- Problema: Dopo migrazione MySQL, calcolatori mostravano "NaN" invece di tariffe
- Causa Root: MySQL DECIMAL restituiti come stringhe, comparazioni fallite in JavaScript
- Fix Tariffe.php: Type casting esplicito float per tutti i valori DECIMAL
- Fix Chiavi Rhenus: Formato corretto '0-50' invece di '0-50.00', 'extra' invece di '500.01-99999'
- Cache Invalidation: Chiavi localStorage aggiornate a _v6 per forzare refresh
📚 Documentazione Completa:
- PIANO_CALCOLO_SERVER_SIDE.md: Piano implementazione con diagrammi architettura
- TEST_CALCOLO_SERVER_SIDE.md: Guida test passo-passo con esempi API
- Commenti Codice: TariffaService.php ampiamente documentato con PHPDoc
💰 Logica Tariffaria Internegozio:
- Tariffa Fornitore: Calcolata con tariffe Elita standard (peso + distanza)
- Tariffa Cliente: Sempre 0€ (nessun cliente da fatturare, costo aziendale interno)
- Margine: 0€ (spedizione interna tra filiali, non genera ricavo)

6.0.1BETA - BUGFIX RELEASE: Ottimizzazioni Sistema e Permessi Granulari

🔧 PHPSpreadsheet 2.0 Compatibility Fixes:
- API Migration: Risolti errori di compatibilità con PHPSpreadsheet 2.0 usando Coordinate::stringFromColumnIndex()
- Export Excel Stabilizzato: Sistema export Elita ora funziona correttamente con tutte le 32 colonne
- Codice Cliente Fisso: Aggiunto codice cliente "159" hardcoded per JYSK Udine in tutti gli export
📦 Composer Integration e Dependency Management:
- Setup Composer: Integrato Composer per gestione dipendenze PHP in /api/
- GitHub Actions: Automatizzato composer install nel workflow di deploy
- Directory Structure: Correttamente posizionato vendor/ in /api/vendor/
👥 Sistema Username Modernizzato:
- Numeri Negozio: Usernames migrati a numeri filiale (3109, 3120, 3207, 3124) invece di nomi testuali
- UI Update: Display numero filiale accanto icona utente in header
- Session Management: Aggiunto numero_filiale e filiale_nome nei dati sessione
- Dev Mode: Credenziali aggiornate nella sezione sviluppatori
🏢 Filiale Conegliano (3124):
- Nuova Filiale: Aggiunta JYSK Conegliano con accesso limitato a solo Rhenus
- Dati Completi: viale Venezia 14A, 31015 Conegliano (TV), telefono 043860719
- Restrizione Internegozio: Conegliano NON può inviare/ricevere spedizioni internegozio Elita
- Migration 12: Script SQL per creazione filiale e user associato
🔐 Sistema Permessi Internegozio Granulare:
- Flag Database: Colonna internegozio_elita (BOOLEAN) in tabella filiali
- Filiali Abilitate: Udine (3109), Fiume Veneto (3120), Portogruaro (3207) possono fare internegozio
- Filiali Disabilitate: Conegliano (3124) escluso da spedizioni internegozio
- API Filtering: Endpoint leggiFiliali con parametro solo_internegozio_elita
- UI Logic: Dropdown internegozio filtra automaticamente solo filiali abilitate ed esclude se stessa
- Helper Function: canAccessInternegozioElita() per controllo accesso pagina
📧 Resend Email Integration:
- Sostituzione SMTP: Rimosso PHPMailer in favore di Resend API per migliore deliverability
- cURL Implementation: Invio email via REST API con Bearer token authentication
- Base64 Attachments: Excel export allegati come base64 per compatibilità API
- Configurazione: Email mittente jysk@marcocereda.it, destinatario vettore configurabile
🎨 Frontend Optimization:
- CDN Tailwind Removal: Rimosso cdn.tailwindcss.com da admin_sistema.php
- Compiled CSS: Utilizzo esclusivo di style.css compilato con Tailwind CLI
- Production Ready: Eliminata dipendenza da risorse esterne CDN
💾 Database Migrations:
- Migration 12: Username updates + aggiunta Conegliano
- Migration 12b: Fix creazione user Conegliano (pattern INSERT IGNORE + SELECT)
- Migration 13: Aggiunta flag internegozio_elita con valori iniziali

6.0.0BETA - MAJOR RELEASE: Migrazione MySQL/PHP e Sistema Enterprise Completo

🗄️ Migrazione Database Google Sheets → MySQL:
- Architettura Moderna: Completa migrazione da Google Sheets/Apps Script a MySQL + PHP backend
- Database Relazionale: Schema MySQL con tabelle spedizioni, users, filiali, tariffe_rhenus, tariffe_elita
- Performance: Query ottimizzate con indici e relazioni foreign key
- Scalabilità: Sistema pronto per gestione centinaia di spedizioni giornaliere
- Backup Automatico: Sistema backup MySQL giornaliero
🔐 Sistema SSO e Autenticazione Multi-Ruolo:
- Login Centralizzato: Sistema SSO con sessioni PHP sicure
- 3 Ruoli Utente:
  - admin: Accesso completo (calcolatori + amministrazione sistema)
  - negozio_udine: Rhenus + Elita completo + pannello admin
  - altro_negozio: Solo Rhenus + Internegozio Elita
- Password Hashing: bcrypt con salt per sicurezza password
- Session Management: Timeout automatico, CSRF protection
- Access Control: Helper functions hasRole(), requireAuth()
🏢 Sistema Multi-Filiale:
- 4 Filiali Supportate: Udine (3109), Fiume Veneto (3120), Portogruaro (3207), Conegliano (3124)
- Gestione Granulare: Ogni filiale con proprie credenziali e permessi specifici
- Internegozio Intelligente: Spedizioni tra filiali JYSK con tariffe dedicate
- Tracking Per Filiale: Dashboard filtrata per filiale utente
📊 Sistema Tracking e Stati Spedizione:
- Colonna stato_spedizione: Stati tracciabili: in_attesa, ritirata, in_transito, consegnata
- Dashboard Admin: Visualizzazione real-time stato spedizioni con filtri
- Storico Modifiche: Log modifiche stato con timestamp
- Export Filtrato: Possibilità export per stato spedizione
📧 Sistema Export Automatizzato con Email:
- Export Service: Classe PHP dedicata ExportService.php per generazione Excel
- PHPSpreadsheet: Libreria enterprise per export .xlsx con formattazione
- Email Automatica: Invio automatico export al vettore via email
- Formato Elita: 32 colonne conformi al formato CSV/Excel Elita ufficiale
- Trigger Manuale/Auto: Export on-demand da pannello admin o schedulato
⚙️ API RESTful JSON:
- Endpoint Unificato: /api/endpoints.php con routing basato su azione
- Models MVC: Classi Spedizione.php, Filiale.php, User.php, Tariffa.php
- JSON Request/Response: API moderne con Content-Type application/json
- Error Handling: Gestione errori standardizzata con HTTP status codes
- Database Singleton: Pattern singleton per connessione MySQL
🔄 Cronjob e Automazione:
- Cron Setup: File /api/cron/ per task schedulati
- Export Giornaliero: Automatizzazione export spedizioni (configurabile)
- Cleanup Database: Pulizia automatica dati vecchi (configurable retention)
- Health Checks: Monitoring automatico sistema
🎨 Frontend Modernizzato:
- Index Unificato: Login centralizzato in index.php
- Tailwind CSS v4: Design system moderno con build process
- Componenti Modulari: Header riutilizzabile, modal, toast notifications
- Responsive Design: Mobile-first per tutte le pagine
- AJAX Real-time: Fetch API per interazioni senza reload
🔧 Infrastructure e DevOps:
- GitHub Actions: CI/CD automatizzato con deploy FTP
- Composer: Dependency management per librerie PHP
- Tailwind CLI: Build automatico CSS nel workflow
- Migration System: Script SQL numerati per aggiornamenti database
- Environment Config: File config.php con costanti ambiente
📋 Pannelli Amministrazione:
- Admin Spedizioni: Gestione completa spedizioni con edit/delete
- Admin Sistema: Gestione utenti, filiali, tariffe
- Export/Import: Funzionalità import tariffe e export dati
- Statistiche: Dashboard con KPI spedizioni per filiale
🔒 Sicurezza Enterprise:
- Prepared Statements: Protezione SQL Injection su tutte le query
- XSS Prevention: Sanitizzazione input e output HTML
- CSRF Tokens: Protezione form critici
- Session Security: Secure cookies, regenerate session ID
- Error Logging: Log errori in file separato, no info sensibili al frontend

5.1.0 - FEATURE RELEASE: Protezione Integrità Tariffaria e Sicurezza Dati

🔒 Sistema Readonly Intelligente (Elita):
- Campi CAP/Città Protetti: Se passati dal calcolatore, CAP e Città diventano readonly per mantenere la tariffa corretta
- Consegna al Piano Locked: Parametro trasporto al piano non modificabile quando impostato dal calcolatore
- Warning Informativi: Messaggi chiari che spiegano perché i campi sono bloccati
- Visual Feedback: Campi readonly con styling grigio e cursor disabled
⚖️ Limiti Peso Dinamici per Scaglioni Tariffari:
- Calcolo Automatico Limite: Peso modificabile solo fino alla decina superiore dello scaglione (es. 32kg → max 39kg)
- Validazione Real-Time: Controllo continuo che il peso totale non superi il limite tariffario
- Blocco Automatico Submit: Pulsante "Genera Etichetta" disabilitato se limite superato
- Alert Doppio Livello: Warning visivo rosso + messaggio esplicativo all'utente
- Info Scaglione: Badge blu informativo che mostra il limite peso consentito
🛡️ Protezione Perdita Dati Google Apps Script:
- Esecuzione Sequenziale: Pulizia foglio avviene solo dopo esportazione completata (stesso trigger)
- Flag di Sicurezza: Script Properties usato per verificare esportazione giornaliera
- Doppio Controllo: Pulizia bloccata se esportazione non confermata
- Trigger Unico: Eliminato trigger separato pulizia per evitare race conditions
- Warning Log: Messaggi console dettagliati per troubleshooting
🎨 Miglioramenti UI/UX:
- Debug Logs Rimossi: Pulizia console log produzione in elita.html
- Cache Busting: Timestamp automatici per forzare aggiornamento browser
- CSS Rigenerato: Build Tailwind con nuove classi per readonly fields

5.0.1 - BUGFIX RELEASE: Risoluzione Problemi Telefoni e Ottimizzazioni

📱 Gestione Telefoni Separati Completa:
- Implementazione Dual Phone: Telefono fisso e cellulare gestiti separatamente in elita.html
- UI Migliorata: Due campi distinti con validazione appropriata (cellulare obbligatorio, fisso opzionale)
- PDF Generation: Display intelligente con formattazione "Tel: cellulare, fisso" o singolo numero
- Mapping Database Corretto: Cellulare → campo "telefono", Telefono fisso → campo "Telefono Destinatario"
🔢 Preservazione Zero Iniziale Telefoni:
- Problema Risolto: Telefoni fissi con zero iniziale (es. 0432123456) non più troncati
- Soluzione Elegante: Aggiunta spazio automatico dopo prefisso (0432 123456) per impedire conversione numerica
- Regex Dinamico: Supporto automatico prefissi italiani 2-4 cifre (02, 040, 0432, etc.)
- Export/Archivio Corretti: Zero preservato in XLSX export e archiviazione mensile
🔧 Correzioni ID Spedizione PDF:
- Sincronizzazione Database-PDF: ID nel PDF ora corrisponde esattamente all'ID del database
- Server Response Fix: Backend ora restituisce correttamente ID_SPEDIZIONE_INTERNO nella risposta
- Fallback Migliorato: Formato ID fallback aggiornato al nuovo schema v5.0.0
🧹 Ottimizzazioni Produzione:
- Debug Code Cleanup: Rimosso tutto il codice debug da elita.html per produzione
- Console Warning Fix: Risolti warning meta tag PWA e preload in index.html
- CSS Minificato: Rigenerazione CSS produzione ottimizzata con Tailwind
🔒 Miglioramenti Modal Amministrazione:
- Campi Read-Only: CAP, città, peso, colli e consegna al piano non modificabili (influenzano tariffe)
- Avviso Utente: Warning chiaro su campi che richiedono nuova spedizione per modifica
- Telefoni Editabili: Solo dati di contatto cliente (nome, cognome, indirizzo, telefoni, email) modificabili

5.0.0 - MAJOR RELEASE: Multi-Carrier Support e Sistema Amministrativo Completo

🚚 Architettura Multi-Carrier con ID Spedizione Potenziato:
- Nuovo Formato ID: J109yyyydddxzz dove x=numero vettore (1=Elita) e zz=progressivo 01-99
- Sistema Scalabile: Architettura pronta per integrazione futuri vettori aggiuntivi
- Tracciabilità Carrier: Identificazione univoca spedizione per vettore con progressivo giornaliero
- Compatibilità Backwards: Mantenimento compatibilità con ID esistenti v4.x
💼 Sistema Amministrativo Enterprise Completo:
- Modulo Amministrazione Tariffe: amministrazione.html per gestione completa riconciliazione fatture
- Calcolo Margini Automatico: Calcolo automatico margini euro e percentuali con IVA 22%
- Workflow Fatturazione: Sistema flag fatturate con caricamento PDF fatture su Google Drive
- Archivio Storico Integrato: Lettura dati da fogli archivio mensili per reportistica completa
- Export Excel XLSX: Esportazione dati amministrativi in formato Excel avanzato
🗄️ Sistema Database 42 Colonne (32 Elita + 10 Amministrative):
- Schema Elita Originale: 32 colonne conformi al formato CSV Elita ufficiale
- Estensioni Amministrative: 10 colonne aggiuntive per gestione interna (ID_SPEDIZIONE_INTERNO, tariffe, margini, flag)
- Campo COD Sempre Vuoto: COD impostato sempre vuoto per uso esclusivo interno vettore
- Integrità Dati Garantita: Validazione e consistenza tra colonne Elita e amministrative
⚡ Automazione Trigger Giornaliera Avanzata:
- Export Automatico: Trigger automatico Lunedì-Giovedì ore 9:00 per export Excel
- Archiviazione Mensile: Trigger automatico Lunedì-Giovedì ore 9:30 per archiviazione dati
- Gestione Header Intelligente: Sistema automatico gestione header nei fogli archivio
- Processo Robusto: Gestione errori e recupero automatico in caso di problemi
🎨 Correzioni UI e Usabilità Critiche:
- Fix Visibilità Pulsanti: Risolto problema pulsanti bianchi invisibili in admin.html
- CSS Tailwind v4 Ottimizzato: Rigenerazione CSS con classi solide (bg-green-600, bg-red-600)
- Responsive Design Migliorato: Interfaccia amministrativa completamente responsive
- Modal Professionali: Sostituzione alert con modal user-friendly
🔧 Ottimizzazioni Tecniche e Sicurezza:
- Gestione Errori Robusta: Sistema retry e timeout per tutte le operazioni API
- Validazione Dati Avanzata: Controlli integrità su sorting e operazioni database
- Sicurezza ID Spedizione: Validazione e prevenzione errori su ID mancanti o malformati
- Performance Ottimizzate: Caricamento parallelo dati e operazioni batch

4.1.0 - MAJOR RELEASE: Sistema Elita Completamente Ridisegnato

🗄️ Ristrutturazione Database Completa - Formato Elita CSV 32 Colonne:
- Mapping Completo CSV Elita: Implementato schema esatto a 32 colonne come richiesto dal sistema Elita ufficiale
- Campi Obbligatori/Opzionali: Gestione corretta campi con asterisco (*) obbligatori vs opzionali
- Google Apps Script Redesign: Riscrittura completa backend per compatibilità formato Elita
- Archivio Mensile Automatico: Sistema di archiviazione automatica con creazione fogli mensili
📅 Automazione Export Quotidiano:
- Export Schedulato: Esportazione automatica Excel TUTTI i giorni lavorativi Lunedì-Giovedì alle ore 9:00
- Formato Excel Elita: Export diretto nel formato .xlsx con 32 colonne esatte per caricamento immediato
- Nomenclatura Automatica: File nominati automaticamente con data per organizzazione
⚖️ Sistema Gestione Pesi Multi-Collo Avanzato:
- Peso Individuale per Collo: Possibilità di inserire peso specifico per ogni collo della spedizione
- Calcolo Peso Totale Automatico: Somma automatica pesi individuali con validazione
- Note Private Corriere: Memorizzazione dettagli pesi nella "Nota privata corriere" per referenza Elita
- Workflow Semplificato: Dimensioni sempre vuote (non richieste da Elita), COD sempre a zero
🎯 Refactoring Admin Interface Enterprise:
- Visualizzazione Dettagli Pesi: Interfaccia che mostra chiaramente peso totale + dettaglio pesi individuali colli
- Modal Professionali: Sostituzione alert con modal responsive per migliore UX
- Export Excel Nativo: Pulsante export diretto formato Elita 32 colonne con formattazione automatica
🔧 Ottimizzazioni e Correzioni:
- Form Validation: Peso obbligatorio, dimensioni opzionali come da specifiche Elita
- Data Flow: Passaggio dati corretto da form calcolo a form etichetta
- Mobile Compatibility: Interfaccia admin completamente responsive

4.0.0 - MAJOR RELEASE: Ottimizzazione Enterprise e Accessibilità

🚀 Sistema di Caching Intelligente:
- Cache LocalStorage: Tariffe salvate in cache locale per 24h, riducendo del 90% i tempi di caricamento nelle visite successive
- Fallback Graceful: Sistema automatico di recupero dal server in caso di cache corrotta
- Preload Ottimizzato: Precaricamento delle risorse critiche per performance ottimali
📱 Ottimizzazioni Mobile Avanzate:
- Meta Tags PWA: Supporto Progressive Web App con theme-color e apple-mobile-web-app tags
- Zoom Prevention iOS: Prevenzione zoom automatico su dispositivi iOS (font-size 16px)
- Debouncing Adattivo: Ricerca autocompletamento ottimizzata (250ms desktop, 400ms mobile)
- Touch Optimization: Gestione eventi touch migliorata per fluidità ottimale
♿ Accessibilità WCAG 2.1 AA:
- ARIA Labels Completi: aria-label, aria-required, aria-describedby per tutti i controlli
- Screen Reader Support: role="combobox", aria-live="polite", aria-expanded per autocompletamento
- Classe .sr-only: Descrizioni nascoste per context aggiuntivo agli screen reader
- Keyboard Navigation: Supporto completo navigazione da tastiera con tabindex appropriati
📊 Admin Panel Enterprise:
- Export Excel Nativo: Sostituzione CSV con export .xlsx usando SheetJS, completo di formattazione colonne
- Rimozione Test API: Interfaccia semplificata e più pulita
- Gestione Errori Robusta: Sistema retry automatico con timeout progressivo (3 tentativi: 15s, 30s, 45s)
- Chiarezza Commerciale: "Tariffa Fornitore (IVA escl.)" per distinguere da tariffe cliente
🔒 Correzioni Critiche Prioritarie:
- Validazione Telefono: Supporto formati internazionali (+39, spazi, parentesi, 8-20 cifre)
- Feedback Smaltimento: Tooltip esplicativo ⚠️ "Servizio temporaneamente sospeso"
- Bug CORS Risolto: Rimozione header Content-Type per compatibilità Google Apps Script
🎨 Miglioramenti UX:
- Tooltip Touch-Friendly: Gestione hover/click per desktop e mobile
- Cache Busting: Versioning CSS automatico per aggiornamenti
- Loading States: Feedback visivo migliorato per tutte le operazioni async

3.6.1 - Integrazione Funzionalità e Correzione Dati

Flusso di Lavoro (Calcolo → Etichetta):
- Precompilazione Automatica Campi: Passaggio automatico di CAP e Città da index.html a etichetta.html per una compilazione più rapida.
- Integrazione "Consegna al Piano": Il servizio viene ora tracciato end-to-end, dal calcolo fino al database finale.
Logica di Calcolo e Dati:
- Correzione Logica Margine Elita: Il margine di profitto viene ora applicato correttamente solo sulla tariffa di trasporto, escludendo il costo fisso della consegna al piano.
- REVISIONE COMPLETA Database CAP/Comuni: Ricostruzione totale del database dei comuni FVG basata su file CSV ufficiale, garantendo massima accuratezza nell'associazione CAP-comune.
Interfaccia Utente (UI/UX):
- Miglioramento Autocompletamento: Aumentato il limite di suggerimenti mostrati da 10 a 30 per gestire correttamente i CAP con molti comuni associati.
- Visualizzazione Dati Aggiuntivi nel Pannello Admin: Il pannello admin ora mostra se una spedizione include la "Consegna al Piano", evidenziando il servizio per una rapida identificazione.
- Correzione Definitiva Tooltip Mobile: Risolto il problema di visualizzazione (trasparenza) dovuto alla cache aggressiva dei browser mobili e aggiunto versioning al file CSS (cache-busting) per prevenire problemi futuri.
Integrazione Backend (Google Sheets):
- Aggiunta nuova colonna Consegna_al_Piano nel database delle spedizioni.
- Lo script ora registra "SI" o "NO" per ogni spedizione Elita.
- La colonna è stata posizionata tra "Numero_Colli" e "Stato" per una migliore leggibilità.

3.4.0 - MAJOR UX REDESIGN: Esperienza Utente Ottimizzata

🎯 Progressive Disclosure per Riduzione Cognitive Load:
- Campo "Regione" nascosto di default (90% delle spedizioni sono in regione FVG)
- Checkbox "Spedizione fuori regione?" per mostrare campo regione solo quando necessario
- Campo "Zona" (pianura/montana) visibile solo se rilevante per la destinazione
- Default intelligenti pre-selezionati: In regione, Pianura, Fronte strada, Feriale
🗺️ Autocompletamento CAP/Città Intelligente:
- Database completo CAP Friuli-Venezia Giulia con oltre 200 comuni
- Ricerca bidirezionale: inserisci CAP → suggerisce comuni, inserisci città → suggerisce CAP
- Auto-impostazione automatica di regione e zona basata sulla località selezionata
- Calcolo distanza automatico da Martignacco per ogni destinazione
- Distinzione automatica tra zone pianeggianti e montane
- Fallback a inserimento distanza manuale per destinazioni non in database
✅ Validazione Real-time e Feedback Visivo:
- Bordi verdi/rossi durante la digitazione per feedback immediato
- Validazione peso (0.01-2500kg) e distanza (0.01-500km) in tempo reale
- Campi obbligatori evidenziati con asterisco rosso (*)
- Auto-focus sul campo peso all'avvio (campo prioritario)
🎨 Miglioramenti UI/UX:
- Tooltip informativi con icona ℹ️ per guidare l'utente
- Font size più grande per campo peso (campo più importante)
- UI più pulita e focalizzata con meno distrazioni visive
- Transizioni fluide per show/hide degli elementi
🧠 Ottimizzazione Cognitive Load:
- Ridotti i campi visibili simultaneamente da 8 a 4-5 mediamente
- Informazioni contestuali mostrate solo quando rilevanti
- Flusso di inserimento dati più naturale e intuitivo

3.2.0

Miglioramenti Interfaccia Utente:
- Rinominate etichette campi: "Zona regionale" → "Regione", "Tipo zona" → "Zona", "Zona normale" → "Pianura"
- Logo JYSK correttamente dimensionato e centrato
- Sfondo verde chiaro per vettore consigliato migliorato con stili CSS diretti
Limiti e Validazioni Aggiornati:
- Limite distanza aumentato da 120km a 500km
- Rimosso limite peso 120kg per Elita
- Aggiunto alert per Elita quando peso > 30kg: avviso sui limiti di trasportabilità per singolo operatore
Alert Zona Montana: Aggiunto avviso specifico per Elita che informa che le consegne in zona montana (Carnia, Dolomiti Pordenonesi, Canal del Ferro e Valcanale) sono effettuate solo il mercoledì.
Correzione Etichette: Risolto problema di visibilità del pulsante "Torna al Calcolatore" nel generatore etichette di spedizione.

3.1.0 - MAJOR RELEASE: Webapp Unificata

Unificazione Completa: Creata una singola webapp che combina le funzionalità di calcolo per entrambi i vettori (Rhenus ed Elita).
Confronto Automatico: Il sistema calcola automaticamente i costi per entrambi i vettori (quando disponibili) e suggerisce l'opzione più conveniente.
Logica di Esclusione Intelligente:
- Elita viene automaticamente escluso per: spedizioni fuori regione, peso > 120kg, consegne al piano, sabato, richieste di montaggio
- Rhenus gestisce tutti i tipi di spedizione fino a 2500kg
Interfaccia Migliorata:
- Design mobile-first con separazione visiva chiara tra opzione consigliata (sfondo verde) e alternativa
- Visualizzazione di tutti i vettori disponibili e non disponibili con relative motivazioni
- Logo JYSK integrato
File Tariffe Unificato: Singolo file tariffe.json con sezioni separate per ciascun vettore.
Gestione Servizi Completa: Supporto completo per montaggio (solo Rhenus) e smaltimento (temporaneamente disabilitato).
Flusso Differenziato:
- Rhenus: visualizzazione diretta del preventivo
- Elita: possibilità di generare etichetta di spedizione

📋 Storico delle Webapp Separate

Rhenus 2.1.0RHENUS

Rilascio ufficiale: uscita dalla fase BETA.
Servizio "Smaltimento" temporaneamente disabilitato (contrassegnato come "servizio sospeso").
Logica sottostante mantenuta per riattivazione futura.

Elita 2.1.0ELITA

Admin Panel: Introdotto pannello amministrativo mobile-first (admin.html) per visualizzare e gestire spedizioni attive.
Styling: Creato nuovo file style.css pulito e valido usando Tailwind CSS v4 CLI.
Refactoring e miglioramento Google Apps Script per gestione errori più robusta.

Rhenus 2.0.0 - 2.0.5RHENUSBETA

Rilascio beta finale con funzionalità smaltimento operativa.
Ottimizzazione avvisi consegna fronte strada/ritiro.
Aggiunto controllo quantità articoli selezionati.
Creazione loghi WebP e ottimizzazione codice.
Creazione file CSS esterno.
Aggiunto costo smontaggio per smaltimento selezionato.
Limite quantità montaggio (richiesta preventivo personalizzato se superato).

Elita 2.0.0ELITA

AGGIORNAMENTO MAGGIORE: Sistema Automazione e Archiviazione.
Automazione Report Settimanali: Processo server-side usando Google Apps Script.
- Esportazione automatica lista spedizioni attive in file .xlsx.
- Invio report via email ogni mercoledì mattina.
Archiviazione Dati:
- Spedizioni elaborate spostate automaticamente in foglio archivio.
- Nomenclatura automatica fogli archivio per settimana e anno.
- Reset foglio principale per nuova settimana.

Rhenus 1.5.0 - 1.9.1RHENUS

Rilascio iniziale sistema calcolo costi JYSK.
Aggiunta funzionalità montaggio con dettagli per tipologia mobili.
Implementazione checkbox smaltimento (implementazione futura).
Avvisi peso massimo e validazione input.
Multiple correzioni di bug e ottimizzazioni.

Elita 1.0.0 - 1.5.0ELITA

Integrazione Database: Salvataggio dati spedizione in Google Sheets centralizzato.
Generazione Etichette PDF: Capacità di generare etichette spedizione multi-pagina.
Creata pagina etichetta.html per inserimento dettagli destinatario.
Etichette generate in formato A5 landscape con layout professionale.
API Google Apps Script robusto per gestione scrittura dati.
Aggiunto campo "Numero Telefono" nei dettagli spedizione.
Rilascio iniziale calcolatore costi consegna.
Pricing basato su Distanza, Peso e Zona.
Fetching dinamico tariffe da tariffe.json.
Correzione bug critico per spedizioni oltre 30kg.
Aggiornamento limiti peso massimo (100kg) e distanza (120km).

Calcolo Spedizioni - Changelog