Sentieri d’Italia Torna alla landing

Guida e descrizione tecnica · versione 0.42

Sentieri,
in profondità.

Manuale d’uso, descrizione funzionale e scheda tecnica della piattaforma per la fruizione regolata del territorio. La pagina distingue ciò che è già disponibile nella versione sperimentale da ciò che richiede ancora sviluppo o validazione istituzionale.

Inizia dalla guida all’app

01 · Visione

Un’infrastruttura digitale tra territorio e visitatore.

Sentieri è una piattaforma multi-ente per catalogare percorsi, aree e parcheggi, comunicarne le condizioni di fruizione e, quando necessario, programmare gli accessi attraverso calendari, capienze, prenotazioni e titoli d’ingresso verificabili.

01

Orientamento

Catalogo affidabile, mappe vettoriali e profili altimetrici disponibili anche senza rete.

02

Regole chiare

Accesso libero, chiuso o prenotabile reso comprensibile prima della partenza.

03

Memoria personale

Registrazioni private, storico, copertura territoriale, ricordi, stelle e fotografie.

04

Governo del territorio

Strumenti distinti per visitatori, gestori e operatori di controllo.

Il nucleo concettuale

Ente → prodotto territoriale → regime di accesso → calendario → capienza → prenotazione → titolo d’ingresso.

02 · Ecosistema

Quattro superfici, con responsabilità separate.

Disponibile

App Sentieri d’Abruzzo

Applicazione Android per catalogo, mappe offline, profili, registrazione GPS, storico, copertura e primo flusso di prenotazione.

Parziale

Console gestore

Web app per catalogo, calendari, capienze, prenotazioni, operatori, controlli e configurazione visiva. L’editor geografico completo è da realizzare.

Beta

App Guardiaparco

App Android separata per account di servizio, scansione dei QR, verifica dei titoli e registro centrale dei controlli.

Pianificato

Portale verbali

Interfaccia web pubblica prevista per consultazione, contestazione e pagamento degli accertamenti, dopo la necessaria validazione legale.

03 · App escursionista

Come si usa Sentieri d’Abruzzo.

1

Installare o aggiornare

Scarica l’unico APK completo di Sentieri d’Abruzzo. Se l’app è già presente, non disinstallarla: installa la nuova versione sopra quella esistente per conservare tracce, profilo e dati personali. Il pacchetto include applicazione, mappe e dati territoriali offline aggiornati.

2

Cercare un percorso

La home mostra le card dei percorsi ordinate secondo i dati di popolarità disponibili. La ricerca lavora su nome, codice e identità CAI. La pagina Filtri restringe l’elenco per area, difficoltà, durata, lunghezza, dislivello, mezzo e fonte.

3

Aprire la panoramica

Toccando una card si accede alla scheda con codice, fonte, difficoltà, modalità consentite, metriche, mappa statica dell’intero itinerario e profilo altimetrico. Le icone sulle due anteprime aprono le viste approfondite.

4

Esplorare mappa e altimetria

La mappa dinamica mantiene il profilo sincronizzato in una linguetta inferiore. Il punto sul profilo corrisponde al punto evidenziato sulla planimetria. Sono disponibili livelli distinti per etichette, curve, cime e valichi, rete sentieristica, ombreggiatura e aree protette, oltre a ripristino del nord e centratura della posizione.

5

Avviare il percorso

Il comando a freccia avvia la sessione sul percorso selezionato. Se la posizione è lontana dalla partenza, l’app mostra prima la distanza in linea d’aria; vicino all’itinerario può seguire la posizione e preparare gli avvisi di orientamento.

6

Usare il menu personale

Dal menu si raggiungono Calendario, Prenotazioni, Storico, Registra, Copertura, Account e Informazioni. La freccia dell’app segue la stessa cronologia del comando Indietro del telefono.

7

Scoprire le attrazioni

La sezione Attrazioni cerca 679 luoghi per nome, comune, area e tag. La mappa mostra direttamente un punto per ogni attrazione georeferenziata e il ritorno dal dettaglio conserva il luogo selezionato. Siti e gallerie richiedono la rete; 1.350 riferimenti fotografici formano piccole gallerie e le immagini non vengono incorporate nell’app.

Uso offline

Catalogo, cartografia incorporata, profili e registrazione continuano a funzionare senza connessione. Prenotazioni, backup remoto e aggiornamenti richiedono invece il collegamento al servizio.

04 · Registrazione GPS

Una traccia personale resta prima di tutto dell’utente.

La voce Registra permette di documentare un percorso libero, anche quando non corrisponde a un itinerario del catalogo.

Prima della partenza

  1. Scegliere il mezzo: a piedi, bici, e-bike o cavallo.
  2. Scegliere il campionamento visibile: 30, 60 o 120 secondi.
  3. Concedere la posizione precisa e, per l’uso a schermo spento, il permesso di localizzazione richiesto da Android.
  4. Premere Avvia e verificare che la posizione compaia sulla mappa.

Durante e dopo

  1. La linea cresce sulla mappa mentre i punti vengono salvati progressivamente.
  2. Un arresto inatteso non elimina la sessione: alla riapertura viene proposto di proseguirla o conservarla come bozza.
  3. Al termine si assegna un nome, da una a cinque stelle, un ricordo e fino a cinque fotografie private.
  4. Dallo Storico nome, giudizio, ricordo e foto possono essere modificati in qualsiasi momento; l’intera traccia può sempre essere eliminata con conferma, anche dalla copia online.

Correzioni automatiche prudenti

  • I singoli salti che implicherebbero velocità superiori a 50 km/h vengono scartati come errori GPS.
  • Soste prolungate all’inizio o alla fine e code evidentemente percorse in automobile possono essere rimosse senza cancellare il corpo dell’escursione.
  • Frammenti compatibili possono essere riuniti; quelli dubbi vengono conservati come bozze separate.
  • Piccoli buchi tra posizioni affidabili vengono ricostruiti soltanto entro limiti di tempo, distanza e velocità compatibili con il mezzo.
  • La quota del telefono non diventa dato definitivo: profilo e dislivelli vengono arricchiti usando il modello del terreno disponibile.

05 · Accessi, prenotazioni e QR

Il permesso nasce dal calendario del prodotto territoriale.

Percorso o areaDataPersoneDisponibilitàTitolo QR

Dalla scheda di un percorso configurato, l’icona di prenotazione apre il calendario specifico. Ogni giorno può essere libero, chiuso, prenotabile o esaurito. Per un accesso di gruppo si indica il numero delle persone; il server verifica e consuma la capienza in un’unica transazione, evitando che due richieste contemporanee superino il limite.

Una prenotazione confermata genera un titolo distinto con codice e QR. Il QR non contiene dati personali in chiaro e può essere mostrato dal telefono o stampato. Nella versione attuale il caso pilota completo è il percorso A1; gli altri prodotti dichiarano correttamente quando non possiedono ancora un regime pubblicato.

Operativo nel pilota

Disponibilità, capienza, prenotazione gratuita, titolo e verifica server.

Da completare

Pagamenti, rimborsi, modifiche del gruppo, parcheggi reali e capienze condivise complesse.

06 · Storico e copertura

Una sola mappa dei passi; una progressione distinta per ogni territorio.

Storico

Elenco cronologico delle escursioni, anche ripetute sullo stesso percorso. Mostra data, traccia, percentuale coperta, ricordo, giudizio e fotografie private. Registrazioni salvate con stesso nome, mezzo e giornata vengono riunite quando la giunzione nel tempo e nello spazio è plausibile; i punti originali restano conservati.

Copertura

Unione cumulativa degli esagoni attraversati sui sentieri dell’app. Non replica le singole uscite e resta visibile su una mappa unica e navigabile.

La griglia usa esagoni reali di circa 100 metri. La mappa mostra sempre gli esagoni validi di tutti i sentieri del catalogo e colora in fucsia semitrasparente quelli visitati. Il selettore non nasconde il resto dell’Abruzzo: cambia soltanto il perimetro usato per percentuale, titolo e classifica.

1

Scegliere l’ambito

In Account → Impostazioni si seleziona il parco o l’area di esplorazione preferita. La scelta resta memorizzata sul dispositivo.

2

Leggere la card

Nella pagina Copertura la linguetta bianca si trascina verso l’alto. Mostra esagoni, percorsi del catalogo, titolo, prossimo traguardo e classifica dell’ambito scelto.

3

Cambiare territorio

Toccando il nome nella card si passa direttamente a un altro ambito senza ricaricare o limitare la mappa globale.

Gli ambiti iniziali comprendono i tre parchi nazionali che interessano l’Abruzzo — PNALM, Maiella, Gran Sasso e Monti della Laga — e il Parco Regionale Sirente-Velino. I sentieri esterni sono raccolti in aree di esplorazione pensate per la passeggiata: Alto Sangro e Scanno, Marsica e Fucino, Aquilano e valli interne, colline e costa. Queste aree sono indipendenti dalle 28 destinazioni usate per le attrazioni turistiche.

Ogni percorso appartiene a un solo ambito statistico. Oggi l’assegnazione usa fonte del percorso e area territoriale primaria; resterà modificabile e verificabile dal gestore quando saranno adottati i poligoni ufficiali delle aree protette. Velocità e ripetizioni non producono vantaggi artificiali.

La classifica corrente è dimostrativa. Una versione reale richiederà soprannome pubblico, consenso esplicito e possibilità di non partecipare.

07 · Console gestore

Il pannello con cui un ente governa l’offerta territoriale.

La console è una web app separata. Un operatore autenticato vede soltanto gli enti e i prodotti per i quali possiede un ruolo.

ModuloFunzioneStato
CatalogoRicerca, correzione dei dati, aggiunta di bozze, ritiro reversibile e validazione distinta dalla fonte.Collegato
CalendarioGiornate libere, chiuse o a numero chiuso; capienza da 1 a 999 e residuo disponibile.Collegato
PrenotazioniElenco completo, ricerca per persona, codice o percorso e apertura della giornata interessata.Collegato
OperatoriAbilitazione delle Guardie e consultazione degli esiti dei controlli QR.Prima versione
Identità visivaNome, logo, palette e area cartografica con anteprima mobile.Locale
GeografiaDisegno e modifica su mappa, import GPX/GeoJSON/KML, punti, linee, aree e parcheggi.Da realizzare

La console pubblica mantiene una modalità dimostrativa nel browser. Le operazioni collegate al server richiedono un account esplicitamente autorizzato.

08 · Guardiaparco

Controllare un titolo senza accedere alle funzioni amministrative.

1

Accedere

L’operatore usa un account di servizio che deve essere abilitato dal gestore per uno specifico ente.

2

Scansionare

Il QR viene inquadrato dalla fotocamera; in alternativa è possibile digitare il codice.

3

Leggere l’esito

L’app distingue titolo valido, sconosciuto, revocato, scaduto, non ancora valido o in attesa di pagamento.

4

Conservare l’audit

Il controllo viene registrato con data, dispositivo ed esito e compare nella cronologia autorizzata.

Limiti della beta

La verifica richiede attualmente il server. Controllo offline firmato, posizioni volontariamente condivise, parcheggi, verbali, stampa portatile e pagamenti non sono ancora operativi.

09 · Dati e metodologia

Una scheda pubblica, molte osservazioni conservate.

Sentieri separa il percorso canonico mostrato nell’app dalle osservazioni provenienti dalle diverse fonti. Tracce coincidenti non generano automaticamente più card. La geometria e il nome più autorevoli diventano il riferimento pubblico; fonti, varianti, revisioni e confronti rimangono conservati per verifiche future.

Provenienza

Fonte, indirizzo, data di acquisizione, identità originale e livello di affidabilità rimangono distinti dalla validazione del gestore.

Identità CAI

Codice, nome, sezione e segnavia bianco-rosso possono accompagnare una scheda anche quando la geometria primaria proviene da un ente parco.

Quote

Le quote originali vengono conservate. Dove mancano, il profilo può essere arricchito dal DEM TINITALY senza modificare le coordinate planimetriche.

Pendenze

Scala assoluta comune a mappa e profilo: blu 0–5%, celeste 5–10%, verde 10–15%, giallo 15–20%, arancio 20–25% e rosso oltre il 25%.

Fatica

Il modello usa un costo energetico non lineare rispetto alla pendenza e restituisce anche chilometri equivalenti in piano. È una stima, non un’indicazione medica.

Fotografie

Il modello prevede fino a cinque foto per recensione e una galleria curata dal gestore. Nella fase corrente le fotografie personali restano locali.

10 · Architettura tecnica

Offline sul campo, autorità del server sulle decisioni condivise.

Mobile AndroidKotlin · Jetpack Compose · MapLibre

Interfaccia nativa, localizzazione in background, database e file locali, mappe MBTiles e logica di recupero delle sessioni.

Mobile iPhoneSwiftUI · MapLibre · Core Location

Base nativa condivisa sul catalogo; la parità funzionale con Android e la distribuzione TestFlight sono ancora da completare.

Console webHTML · CSS · JavaScript

Applicazione web leggera pubblicata separatamente dal repository privato di sviluppo.

ServiziSupabase · PostgreSQL · Auth · RLS · RPC

Dati multi-ente, autorizzazioni, sincronizzazione delle tracce, capienze transazionali, prenotazioni, titoli e audit dei controlli.

Dati territorialiGeoJSON · GPX/KML · MBTiles · DEM

Catalogo versionato, mappe vettoriali, curve di livello, profili e pacchetti territoriali verificabili tramite SHA-256.

DistribuzioneGitHub Pages · GitHub Releases

Landing e documentazione pubbliche; unico APK completo e Guardiaparco distribuiti come allegati versionati.

Principio offline-first

La mancanza di rete non deve interrompere orientamento e registrazione. Il server resta però l’unica autorità per posti disponibili, prenotazioni, pagamenti e titoli d’ingresso.

11 · Privacy e sicurezza

Prenotazione, posizione e controllo sono finalità diverse.

  • Una prenotazione non autorizza automaticamente il monitoraggio della posizione.
  • La traccia personale viene salvata prima localmente e resta privata; la sincronizzazione non la rende un percorso pubblico.
  • Un eventuale accesso consentito soltanto con monitoraggio deve essere dichiarato prima della prenotazione, limitato nel tempo e avviato consapevolmente.
  • Le posizioni condivise per sicurezza non diventano automaticamente prove per una sanzione.
  • Ruoli e regole di sicurezza del database isolano utenti, gestori e operatori per ente.
  • Prima dell’uso pubblico servono informativa, consensi, tempi di conservazione, esportazione/cancellazione e valutazione giuridica.

12 · Identità dell’opera software

Elementi caratterizzanti del prodotto.

Ai fini descrittivi, Sentieri è un sistema software modulare la cui originalità progettuale risiede nell’integrazione coerente tra governo degli accessi, catalogo territoriale canonico, navigazione offline, registrazione personale, copertura esagonale e strumenti distinti per enti e operatori.

Denominazione

Sentieri; prima edizione configurata: Sentieri d’Abruzzo.

Categoria

Piattaforma software mobile e web per fruizione, gestione e controllo degli accessi territoriali.

Struttura

App utente, console gestore, app Guardiaparco, servizi dati e futuro portale verbali.

Modello centrale

Ente, prodotto territoriale, regime, calendario, capienza, prenotazione e titolo.

Funzioni distintive

Catalogo senza duplicazioni pubbliche, provenienza conservata, pacchetti offline, copertura esagonale e accessi regolati.

Versione descritta

Android 0.45.0, edizioni regionali Abruzzo e Lazio con rete sentieristica OSM-first gerarchica. Il Lazio pubblica 1.635 percorsi identificabili, 14.514 nodi di catalogo e 61.310 nodi terziari. I 57.610 archi terziari restano un livello escursionistico di primo piano per esplorare la rete, senza etichette né presenza in elenco; marciapiedi, attraversamenti e percorsi urbani non qualificati sono esclusi. I 14.636 tratti carrabili sono resi come viabilità distinta, anche quando un sentiero li percorre. Abruzzo applica lo stesso criterio con 6.719 nodi complessivi e 8.690 tratti carrabili. I nodi non attribuiscono ufficialità e la continuità turn-by-turn resta da certificare. Entrambe le edizioni usano mappe vettoriali offline e curve TINITALY; i raster fisici sono stati rimossi per evitare sovrapposizioni e peso inutile. Ogni nuova regione deve completare profili, DEM, gerarchia e nodi principali prima della distribuzione.

Codice, interfacce, documentazione e modello applicativo costituiscono l’opera software. Banche dati, cartografie, marchi e contenuti provenienti da terzi mantengono titolarità e licenze proprie e devono essere elencati separatamente nell’eventuale documentazione di deposito.

13 · Stato e prossimi sviluppi

Cosa è pronto e cosa manca.

Realizzato

Prototipo Android da campo

Catalogo, cartografia offline pilota, altimetria, registrazione GPS, recupero, storico, copertura e prenotazione A1.

Realizzato

Nucleo server

Catalogo multi-ente, ruoli, disponibilità, prenotazioni transazionali, titoli QR, sincronizzazione e controllo.

Priorità

Pacchetti regionali

Per ora mappe, curve, cataloghi e DEM derivati sono distribuiti nell’unico APK completo; la separazione dei dati resta un’evoluzione futura.

Priorità

Editor GIS

Disegno, modifica, importazione, validazione e pubblicazione delle geometrie dalla console.

In corso

Account e iPhone

Accesso anonimo, Google, Apple ed email/password sono configurati per il recupero multi-dispositivo. Restano la prova Apple sui dispositivi e la parità iOS con distribuzione TestFlight.

Successivo

Pagamenti e sanzioni

Moduli da affrontare soltanto insieme a sicurezza, fiscalità, privacy e validazione legale.

Stato sperimentale

Sentieri non è ancora un’app ufficiale di un parco o comune e non deve essere usata come unico ausilio di navigazione, per emergenze, permessi reali o accertamenti.