Sistema di Gestione Ordini Logistici

Un'applicazione web completa per la gestione di ordini logistici con generazione automatica di PowerPoint e esportazione Excel.

🚀 Caratteristiche Principali

• Gestione Completa Ordini: Raccolta di tutti i dati necessari per ordini logistici
• Generazione PowerPoint: Creazione automatica di presentazioni professionali in 5 slide
• Esportazione Excel: Export completo di tutti i dati in formato CSV
• Gestione HS Codes: Supporto completo per codici doganali con validazione
• Gestione ADR: Gestione merci pericolose secondo normative ADR
• Validazione Automatica: Controlli automatici per discrepanze e errori
• Interface Multilingue: Supporto italiano e inglese

📋 Funzionalità Dettagliate

Raccolta Dati

• Informazioni Ordine: Riferimento, date, tipo spedizione
• Parti Coinvolte: Mittente, destinatario, dichiarante doganale
• Siti di Carico: Gestione multipla con orari e attrezzature
• Dettagli Spedizione: Pesi, dimensioni, temperature, colli
• Codici HS: Gestione illimitata con validazione valori
• Merci Pericolose: Classificazione ADR completa
• Incoterm: Termini commerciali internazionali

Generazione Documenti

• PowerPoint Professionale: 5 slide strutturate con tutti i dati
• Export Excel/CSV: Tutti i parametri in formato tabellare
• Validazione Automatica: Avvisi per discrepanze nei dati

🛠️ Installazione e Uso

Requisiti

• Browser web moderno (Chrome, Firefox, Safari, Edge)
• Server web locale (opzionale per sviluppo)

Avvio Rapido

1. Clona o scarica il repository
2. Apri index.html nel browser
3. Inizia a inserire i dati del tuo ordine

Avvio con Server Locale

# Con Python
python -m http.server 8000

# Con Node.js
npx http-server

# Con PHP
php -S localhost:8000

Poi apri http://localhost:8000 nel browser.

📁 Struttura del Progetto

TEST/
├── index.html              # Pagina principale dell'applicazione
├── app.js                  # Logica principale e funzioni JavaScript
├── styles.css              # Stili CSS per l'interfaccia
├── polyfills.js            # Compatibilità browser legacy
├── browser-compatibility.css # Stili per compatibilità
├── test_equipment.html     # Pagina di test attrezzature
├── debug_powerpoint.html   # Pagina di debug PowerPoint
├── field_verification_report.md # Report verifica campi
└── BACKUP/                 # Versioni di sviluppo precedenti

🎯 Come Utilizzare

1. Informazioni Base

• Inserisci il riferimento ordine
• Compila i dati di mittente e destinatario
• Seleziona l'incoterm appropriato

2. Dettagli Spedizione

• Scegli il tipo di spedizione (FTL/LTL)
• Inserisci pesi, dimensioni e numero colli
• Configura temperature se necessario

3. Siti di Carico

• Aggiungi uno o più siti di carico
• Specifica orari di apertura e contatti
• Seleziona attrezzature necessarie

4. Codici HS (Doganali)

• Inserisci i codici HS per ogni prodotto
• Specifica pesi, valori e origine
• Il sistema validerà automaticamente i dati

5. Merci Pericolose (ADR)

• Indica se ci sono sostanze pericolose
• Compila i dettagli ADR se necessario
• Specifica classificazioni UN

6. Generazione Documenti

• Clicca "Genera PowerPoint" per la presentazione
• Usa "Esporta Excel" per i dati tabulari

🔧 Funzionalità Avanzate

Validazione Automatica

Il sistema controlla automaticamente:

• Coerenza tra valori HS e fattura
• Discrepanze nei pesi
• Completezza dei dati obbligatori

Gestione Errori

• Messaggi di errore chiari e specifici
• Evidenziazione campi problematici
• Suggerimenti per la correzione

Compatibilità Browser

• Supporto per browser legacy
• Polyfills per funzionalità moderne
• Interfaccia responsive

📊 Struttura PowerPoint Generato

Slide 1: Parti e Ubicazione Merci

• Riferimento ordine
• Informazioni mittente e destinatario
• Dettagli incoterm
• Riepilogo LDM/colli

Slide 2: Riepilogo Spedizione

• Dettagli tipo spedizione
• Informazioni siti di carico
• Orari e attrezzature
• Dati T1 se applicabili

Slide 3: Codici HS (Dogana)

• Informazioni doganali
• Dettagli fatturazione
• Tabella completa codici HS
• Avvisi di validazione

Slide 4: ADR - Merci Pericolose

• Status sostanze pericolose
• Dettagli classificazione ADR
• Tabella completa dati UN

Slide 5: Riepilogo Finale

• Sommario ordine completo
• Dettagli finali HS
• Data di generazione

🐛 Risoluzione Problemi

Problemi Comuni

• PowerPoint non si genera: Verifica che tutti i campi obbligatori siano compilati
• Export Excel fallisce: Controlla la presenza di caratteri speciali nei dati
• Validazione fallisce: Verifica formato numeri e date

Debug

• Usa debug_powerpoint.html per testare la generazione PowerPoint
• Controlla la console browser per errori JavaScript
• Verifica la compatibilità del browser

🤝 Contribuire

1. Fork del repository
2. Crea un branch per la tua feature (git checkout -b feature/AmazingFeature)
3. Commit delle modifiche (git commit -m 'Add some AmazingFeature')
4. Push al branch (git push origin feature/AmazingFeature)
5. Apri una Pull Request

📝 Licenza

Questo progetto è distribuito sotto licenza MIT. Vedi il file LICENSE per i dettagli.

📞 Supporto

Per supporto e domande:

• Apri un issue su GitHub
• Controlla la documentazione nel codice
• Verifica i file di debug inclusi

🔄 Versioni

• v1.0: Versione iniziale con funzionalità base
• v1.1: Aggiunta validazione automatica
• v1.2: Miglioramenti interfaccia e compatibilità
• v1.3: Ottimizzazioni PowerPoint e export

---

Sviluppato per la gestione professionale di ordini logistici internazionali