Product Overview¶

Drone Sky Check e' una piattaforma software per la consultazione operativa dello spazio aereo rilevante per le attivita' UAS. La componente piu' visibile e' la web application, ma il progetto include anche servizi cloud, API, dataset geografici e flussi realtime che condividono dati e logica operativa. Il prodotto organizza su mappa informazioni provenienti da dataset geografici, sorgenti aeronautiche, servizi cloud e flussi di traffico, con l'obiettivo di aiutare l'utente a comprendere se, dove e con quali limiti puo' pianificare un'attivita' di volo.

Il prodotto non si presenta come fonte ufficiale unica. Nell'interfaccia e nel codice e' esplicitato che Drone Sky Check fornisce supporto informativo e consapevolezza operativa, mentre le decisioni operative e legali restano legate alle pubblicazioni ufficiali e alla responsabilita' dell'utilizzatore.

Problema Risolto¶

Le informazioni utili a un'operazione UAS sono distribuite tra molte sorgenti: zone geografiche, limiti di quota, NOTAM, informazioni ENR/AIP, aree temporanee, meteo, infrastrutture aeronautiche, dati di terreno e traffico. Drone Sky Check raccoglie questi elementi in un'esperienza centrata sulla mappa, riducendo la necessita' di passare continuamente tra strumenti separati.

Il problema affrontato dal prodotto non e' soltanto mostrare dati geografici. Il codice evidenzia una funzione piu' ampia: separare i layer, contestualizzare le zone, rendere piu' leggibili i vincoli e collegare informazioni statiche e aggiornate.

Utilizzatori¶

Gli utilizzatori principali sono persone che devono valutare un'area di volo o monitorare un contesto operativo UAS.

Utilizzatore	Esigenza principale
Piloti ricreativi	Consultare zone, limiti, NOTAM e meteo per comprendere il contesto prima del volo.
Operatori professionali UAS	Pianificare missioni, valutare vincoli e preparare richieste o verifiche operative.
Persone coinvolte nella pianificazione	Disegnare aree, stimare missioni, verificare autorizzazioni e preparare dati operativi.
Osservatori o gestori di ricevitori	Visualizzare droni, tracker, ricevitori e traffico aereo quando disponibili.
Sviluppatori e integratori	Comprendere il prodotto prima di approfondire API, backend e architettura.

Funzionalita' Principali¶

Le funzionalita' elencate in questa sezione sono dedotte dai file presenti in public/ e functions/.

Area	Descrizione prodotto
Mappa operativa	Visualizzazione principale basata su mappa, con layer sovrapposti, pannelli informativi e controlli dedicati.
Zone di volo	Consultazione di zone UAS, NFZ, CTR, ATZ, aree regolamentate, pericolose, militari, parchi, SUP AIP e NOTAM rappresentati come layer geografici.
Informazioni sulle zone	Pannelli e helper mostrano dettagli, limiti, descrizioni, glossario e note associate alle zone selezionate.
NOTAM	Il sistema include dataset NOTAM, layer dedicati e un proxy backend per recuperare informazioni NOTAM da sorgenti esterne.
Meteo	Sono presenti strumenti METAR, elenco aeroporti italiani e proxy meteo verso dati aeronautici.
Infrastrutture aeronautiche	Il prodotto gestisce dati su aviosuperfici, aeroporti, elisuperfici e riferimenti collegati.
Drone Tracking	La mappa puo' mostrare oggetti UAS provenienti da sorgenti consentite e tracciati associati.
Receiver e tracker	Sono presenti layer per ricevitori e tracker, alimentati da dati aggiornati in cloud.
Air Traffic	Il prodotto visualizza traffico aereo sotto una soglia operativa, unendo sorgenti ADS-B/locali e traffico OGN quando disponibili.
Volo sportivo	Il codice include layer per traffico glider e sorgenti come FLARM, SafeSky, FreeFlight e FANET.
Flight Planning	Strumenti waypoint permettono di passare dalla verifica di un punto alla preparazione di una missione, disegnando geometrie, impostando parametri e preparando percorsi.
Autorizzazioni	Lo strumento autorizzazioni analizza l'area selezionata, presenta requisiti o soggetti coinvolti e puo' preparare documenti collegati al workflow manuale.
Vista 3D	Sono presenti viste 3D dello spazio aereo e preview 3D collegate ai dati geografici e al traffico.
Analisi AI	Un pannello AI costruisce un contesto operativo a partire da zona o posizione selezionata e lo invia a funzioni cloud dedicate.
API	Sono presenti API pubbliche per valutare un punto geografico e per ottenere geometrie di zone in una bounding box.

Organizzazione Generale Del Sistema¶

Drone Sky Check e' organizzato come una piattaforma modulare: una applicazione web statica servita dalla cartella public/, supportata da funzioni cloud nella cartella functions/, dataset condivisi e servizi realtime.

Il frontend gestisce l'esperienza utente: mappa, pannelli, layer, strumenti, visualizzazioni e interazione con i dati. I dataset statici sono distribuiti insieme all'applicazione e caricati dal browser quando servono.

Il backend fornisce servizi che non sono solo file statici: proxy verso dati esterni, API di valutazione geografica, ingestione di traffico e tracker, statistiche, funzioni AI e integrazioni con servizi esterni.

flowchart LR
  User["Utente"] --> Frontend["Frontend web in public/"]
  Frontend --> StaticData["Dataset locali in public/data/"]
  Frontend --> Firestore["Dati realtime in Firestore"]
  Frontend --> CloudFunctions["Cloud Functions in functions/"]
  CloudFunctions --> FunctionData["Dataset backend in functions/data/"]
  CloudFunctions --> ExternalSources["Sorgenti esterne"]
  CloudFunctions --> Firestore

Tipi Di Dati Utilizzati¶

Il prodotto usa piu' categorie di dati, ciascuna con uno scopo diverso.

Tipo di dato	Uso nel prodotto
GeoJSON	Disegno e analisi di zone, parchi, CTR, ATZ, aree regolamentate e altri layer geografici.
JSON arricchiti	Glossari, dettagli zona, aggiornamenti, NOTAM, ENR, SUP e riferimenti editoriali.
CSV/XLSX	Dataset tabellari, in particolare collegati ad aviosuperfici e riferimenti aeronautici.
Dati realtime	Droni, ricevitori, tracker e traffico locale letti o scritti tramite servizi cloud.
Dati meteo aeronautici	METAR recuperati e presentati in mappa tramite layer e pannelli dedicati.
Dati di traffico	Flussi ADS-B/locali, OGN e sorgenti per volo sportivo o traffico a bassa quota.
Dati altimetrici e territoriali	Informazioni DEM e basi cartografiche usate dagli strumenti di analisi e pianificazione.
Dati di configurazione	Manifest PWA, versione build, service worker e impostazioni UI come tema e base map.

Interazione Tra Frontend, Backend E Sorgenti Dati¶

Ad alto livello, Drone Sky Check funziona come una piattaforma di composizione dati.

Il frontend carica la mappa, i layer e gli strumenti. Per molti contenuti usa file locali presenti in public/data/, come GeoJSON e JSON di supporto. Quando servono dati aggiornati, analisi cloud o integrazioni esterne, chiama funzioni backend.

Le Cloud Functions elaborano richieste, proteggono alcuni endpoint, leggono dataset lato backend, interrogano sorgenti esterne e aggiornano Firestore. Il frontend usa Firestore per visualizzare elementi dinamici come traffico, droni, ricevitori e tracker.

Questa divisione permette al prodotto di combinare:

una base cartografica e documentale caricabile dal browser;
servizi cloud per operazioni dinamiche;
dati geografici versionati nel progetto;
sorgenti esterne usate per meteo, NOTAM, traffico e integrazioni operative.

Limiti Del Documento¶

Questo documento descrive il prodotto a livello generale. Non documenta ancora architettura interna, schema dei dati, formato delle API, collezioni Firestore o algoritmi di analisi delle zone. Questi aspetti saranno trattati nella documentazione developer.