Torna alla Home

Documentazione Progetto PPL NIBBIO

Piattaforma di studio per la licenza di pilota privato (PPL-A)

Panoramica

Questo progetto e una piattaforma web completa per la preparazione all'esame teorico PPL (Private Pilot License) secondo le normative ENAC/EASA. Include materiali di studio, quiz interattivi, simulazioni d'esame e documentazione tecnica per il TECNAM P92-JS.

Tecnologie Utilizzate

HTML5 CSS3 JavaScript (Vanilla) Firebase (Auth + Firestore) LocalStorage JSON

Struttura del Progetto

ppl_nibbio_completo/
├── index.html (Homepage principale)
├── admin.html (Pannello admin novita)
├── centro_esami.html (Simulazioni esame)
├── novita.html (Pagina novita/changelog)
├── guida-iscrizione.html (Guida iscrizione corso)
├── documentazione.html (Questa pagina)
├── quiz_*.html (10 quiz per materia)
├── ppl_progress.js (Sistema progresso lezioni)
├── firebase-auth.js (Autenticazione Firebase)
├── quiz-cloud-sync.js (Sync quiz su cloud)
│
├── materiali/ (Dispense docente)
│ └── *.html (Dispense per lezione)
│
├── materiali_libro/ (Dispense libro)
│ └── *.html (Capitoli libro)
│
├── manuali/
│ ├── manuale_volo_p92js*.html (9 sezioni AFM tradotto)
│ ├── indice_manuale_p92js.html (Indice manuale)
│ ├── *.pdf (PDF originali)
│ ├── cockpit/
│ │ ├── index.html (Cockpit interattivo)
│ │ ├── admin.html (Editor hotspot)
│ │ ├── cockpit_data.json (Dati strumenti)
│ │ ├── cockpit_main.png (Immagine cruscotto)
│ │ └── cockpit_console.png (Immagine console)
│ └── images/ (Immagini manuale)
│
├── JSON_QuizPPL/ (Database domande quiz)
│ └── *.json (1 file per materia)
│
├── images/ (Immagini generali)
└── guida/ (Guide e tutorial)

Funzionalita Principali

📝
Centro Esami PPL
centro_esami.html

Simulatore completo dell'esame ENAC con:

File correlati

✓
Quiz per Materia
quiz_*.html

10 pagine quiz dedicate, una per ogni materia dell'esame:

FileMateriaDomande
quiz_principi_volo.htmlPrincipi del Volo201
quiz_nozioni_generali_aeromobili.htmlNozioni Generali aa/mm~200
quiz_procedure_operative.htmlProcedure Operative~150
quiz_prestazioni_pianificazione.htmlPrestazioni e Pianificazione~180
quiz_meteorologia.htmlMeteorologia~250
quiz_regolamentazione_aeronautica.htmlRegolamentazione~200
quiz_comunicazioni.htmlComunicazioni VFR~150
quiz_limitazioni_umane.htmlFattore Umano~150
quiz_navigazione.htmlNavigazione~300
🎛️
Cockpit Interattivo TECNAM P92-JS
manuali/cockpit/index.html

Mappa interattiva del cruscotto con 32 strumenti mappati:

File correlati

Nota tecnica: I dati vengono caricati con priorita: 1) File JSON, 2) localStorage, 3) Dati embedded nel HTML. In sviluppo locale (file://), il JSON non puo essere caricato per CORS, quindi usa localStorage o i dati embedded.
📖
Manuale di Volo P92-JS (AFM)
manuali/manuale_volo_p92js*.html

Traduzione completa in italiano dell'Aircraft Flight Manual:

Riferimenti EASA

Edizione 3, Revisione 5 - EASA Type Certificate A.060

📊
Sistema Progresso Lezioni
ppl_progress.js

Tracciamento delle lezioni completate con:

Integrazione Firebase

Il progetto usa Firebase per:

Fallback: Se Firebase non e disponibile, il sistema usa localStorage come fallback. I dati locali funzionano sempre anche offline.

Chiavi localStorage principali

ChiaveDescrizione
cockpit_data_backupCache dati cockpit interattivo
ppl_progress_*Progresso lezioni per materia
quiz_stats_*Statistiche quiz per materia
p92js_manual_images_sez*Immagini manuale per sezione
ppl_news_last_visitUltima visita pagina novita

Funzionalita Admin

Pannello Novita (admin.html)

Gestione annunci e changelog:

Editor Cockpit (manuali/cockpit/admin.html)

Editor visuale per hotspot:

Troubleshooting

Hotspot cockpit in posizione sbagliata

Se gli hotspot appaiono fuori posizione (es. nel cielo invece che sugli strumenti):

  1. Apri la console del browser (F12)
  2. Esegui: localStorage.removeItem('cockpit_data_backup')
  3. Ricarica la pagina

Questo cancella la cache locale e forza il caricamento dal JSON aggiornato.

Quiz non carica domande

Verifica che i file JSON in JSON_QuizPPL/ siano accessibili. In sviluppo locale potrebbe essere necessario usare un server HTTP locale.

Firebase non si connette

Il sistema continua a funzionare con localStorage. I dati saranno sincronizzati quando la connessione sara ristabilita.

Informazioni Corso

Corso: PPL NIBBIO IV

Orario: Martedi e Giovedi 18:30-20:30

Scuola: AEC Roma

Aeromobile: TECNAM P92-JS

Documentazione aggiornata: 24 Gennaio 2026

Versione progetto: 2.0 (con Cockpit Interattivo)