-orange.svg){kind=icon}
Geo Fibra Collesalvetti è una piattaforma civica e documentale open source che mappa l'infrastruttura di telecomunicazioni in fibra ottica (FTTH FiberCop / Wholesale), monitora in tempo reale le ordinanze municipali di scavo e offre un'enciclopedia tecnica e divulgativa sulla banda ultralarga in Italia.
Il progetto nasce per garantire trasparenza sull'avanzamento dei lavori stradali, sui tempi di ripristino dell'asfalto e sullo stato reale della connettività a Collesalvetti e nelle sue frazioni.
Important
Dispositivi supportati:
-
Mappa GIS e Tracker Cantieri: Sviluppati per computer desktop e tablet (
$\ge$ 768 px). Su smartphone un blocco a tutto schermo motiva l'esigenza di una risoluzione grafica adeguata per la lettura dei tracciati ad alta densità e non carica le librerie cartografiche né i dati geografici. - Wiki Tecnica: Pienamente accessibile e ottimizzata per la lettura su qualsiasi dispositivo, compresi smartphone (con tabelle a scorrimento orizzontale dedicate).
- Caratteristiche del Portale
- Dati e Statistiche Ufficiali (Snapshot 5)
- Registro Cantieri e Ordinanze di Polizia Municipale
- La Wiki Tecnica e Divulgativa
- Architettura del Repository
- Pipeline Dati e Riproducibilità
- Avvio Rapido Locale
- Pubblicazione su GitHub Pages e Ridenominazione
- Dichiarazione d'Indipendenza e Licenza
- Visualizzazione multilivello: commutazione istantanea tra OpenStreetMap, ortofoto Satellite HD (Esri) e visuale ad alto contrasto Cyber Dark.
- Vincolo geografico: navigazione limitata al perimetro toscano (
TOSCANA_BOUNDS) per impedire disorientamenti fuori zona. - Tracciati e apparati vettoriali: minitrincee, dorsali primarie, armadi ARLO, ARL rame, centrali e pozzetti con popup completi di quote metriche, note di rilievo e link a Google Street View.
- Filtro interattivo cantieri: selezione rapida per visualizzare tratte completate, cantieri in completamento (C2), autorizzati (C3) o in attesa di proroga (C1).
- Incrocio con l'Albo Pretorio: collegamento diretto agli atti di disciplina della circolazione emessi dal Comune di Collesalvetti.
- Calcolo dinamico dello stato lavorativo:
PROGRAMMATO: prima dell'inizio formale dell'atto.IN COMPLETAMENTO: cantieri con condotte posate e pozzetti in chiusura finale (es. Cantiere 2 Stagno).CANTIERE ATTIVO ORA: solo ed esclusivamente nei giorni feriali e nella fascia autorizzata (08:00 – 18:00).NON LAVORATIVO: di domenica o nei giorni festivi con ordinanza vigente, con avviso esplicito di sospensione dei lavori.FUORI ORARIO: nelle ore serali e notturne feriali.LAVORI CONCLUSI: alla scadenza dei termini autorizzati.
- Distinzione tra atto formale e rilievo di campo: evidenziazione separata di eventuali posticipi osservati sul terreno (
slittamento_osservato).
- 11 voci di approfondimento scritte in italiano chiaro e rigoroso.
- Tabelle comparative con parametri fisici e normativi conformi a standard ITU-T, AGCOM e MIMIT.
- Motore di rendering autonomo leggero (
marked.min.js), ricerca istantanea e box fonti strutturato.
Tutti i conteggi sono calcolati deterministicamente sul rilievo geospaziale Snapshot 5 del 17/10/2026:
| Categoria Elemento | Quantità | Dettaglio / Note |
|---|---|---|
| Feature Geospaziali Totali | 71 | 37 punti, 30 linee, 4 poligoni di perimetro |
| Estensione Tracciati Rete | 23,840 km | Somma metrica di tutte le tratte stradali e dorsali (+2,062 km netti) |
Apparato = punto di rete censito (armadio ARL/ARLO o centrale). Linee, poligoni e punti di infrastruttura non sono apparati. Dei 37 punti dello Snapshot, 36 sono apparati (35 nel territorio comunale + 1 esterno al Comune) e 1 è un punto di infrastruttura non conteggiato.
| Tipologia | Categoria GIS | Quantità | Note |
|---|---|---|---|
| Armadio Ripartilinea (ARL, rame) | arl |
24 | |
| Armadio Ripartilinea Ottico (ARLO) | arlo |
4 | |
| Totale armadi (ARL + ARLO) | 28 | ||
| Centrale Comunale | centrale_comunale |
1 | |
| Centrali di Frazione | centrale_frazione |
6 | |
| Totale apparati sul territorio comunale | 35 | ||
| Apparati esterni al Comune (non inclusi nel totale): Centrale Feeder (Livorno Nord) | centrale_feeder |
1 | fuori dal territorio comunale |
| Punti non-apparato (esclusi dal conteggio): Coppie di corrugati scoperti | infrastruttura |
1 | punto di infrastruttura, non apparato |
| Frazione | Apparati | ARLO | ARL | Centrali | Tratte (km) | Quota % km |
|---|---|---|---|---|---|---|
| Stagno | 10 | 3 | 6 | 1 | 10,545 km | 44,2% |
| Collesalvetti | 9 | 1 | 7 | 1 | 3,300 km | 13,8% |
| Vicarello | 9 | 0 | 8 | 1 | 0,000 km | 0,0% |
| Guasticce | 4 | 0 | 3 | 1 | 0,000 km | 0,0% |
| Nugola | 1 | 0 | 0 | 1 | 0,000 km | 0,0% |
| Parrana San Martino | 1 | 0 | 0 | 1 | 0,000 km | 0,0% |
| Parrana San Giusto | 1 | 0 | 0 | 1 | 0,000 km | 0,0% |
| Altro / non attribuito | 0 | 0 | 0 | 0 | 9,995 km | 41,9% |
| Totale | 35 | 4 | 24 | 7 | 23,840 km | 100,0% |
Gli apparati sono contati per frazione dal solo territorio comunale; i km delle tratte comprendono anche la dorsale INFRATEL BUL e le tratte senza frazione (Altro).
Questo osservatorio adotta come unica fonte di verità documentale data/ordinanze.json, citando sia il numero interno di settore della Polizia Municipale (P.M.) sia il Registro Generale (Reg. Gen.):
- Cantiere 2 - Stagno (Nuova Espansione FTTH):
- Atto: Ordinanza P.M. n. 95/2026 (Reg. Gen. 102/104/2026)
- Periodo ufficiale: 21/09/2026 – 17/10/2026 (feriali 08:00 – 18:00)
- Rilievo di campo: Finestra effettiva 05/10 - 17/10. Stato In completamento (posa condotte completata, 6 pozzetti in chiusura, tratta via Romita/XXV Aprile verificata come completata per 292,9 m). Nuovo ARLO posato adiacente a S [04] ARL (privo di etichetta numerica, 3° ARLO censito a Stagno).
- Vie: Via Romita sud, Via De Gasperi, Via Machiavelli, Via XXV Aprile, Piazza Di Vittorio, Via Don Verità, Via 8 Marzo.
- Cantiere 3 - Stagno (Via Aiaccia / Via Umbria):
- Atto: Ordinanza P.M. n. 105/2026 (Reg. Gen. 105) + Concessione Suolo n. 77/2026 (60 mq)
- Periodo ufficiale: 19/10/2026 – 23/10/2026 (5 giorni feriali, 08:00 – 18:00)
- Stato: Autorizzato / Avvio programmato. Raccordo con dorsale provinciale SP555.
- Cantiere 1 - Collesalvetti Centro:
- Atto: Ordinanza P.M. n. 88 del 02/09/2026 (Reg. Gen. 95)
- Periodo ufficiale: 14/09/2026 – 02/10/2026. Termini scaduti.
- Rilievo di campo (11/10/2026): Tratte Sud-Est e anello rotatoria (71,8 m) eseguite con minitrincea sigillata (Fender 4x10/14), 4 pozzetti FiberCop e primo ARLO cittadino (
C [] ARLO, futuro ARLO 01). Tratte Nord-Ovest (Via Nenni) non eseguite (soli segni spray blu su asfalto, in attesa di proroga).
- Ripristino Manto Stradale - Stagno:
- Atto: Ordinanza P.M. n. 70 del 16/07/2026 (Reg. Gen. 75)
- Periodo ufficiale: 03/08/2026 – 13/08/2026. Lavori conclusi.
- Vie: Via Marx, Via Guerrazzi, Via La Malfa.
- Tratte senza ordinanza comunale ordinaria:
- Opera sulla Backbone: Tratta interurbana di 519 metri verso Livorno lungo la provinciale SP555.
Accessibile da desktop e da smartphone all'indirizzo wiki.html:
| Voce | File | Argomento Trattato |
|---|---|---|
| 1. Come Funziona la Fibra FTTH | wiki/ftth-come-funziona.md |
Riflessione totale interna, attenuazione in dB/km, architettura albero PON. |
| 2. Tecnologie a Confronto | wiki/tecnologie-a-confronto.md |
Tabella comparativa FTTH, FTTC, FWA, ADSL e bollini AGCOM (Verde, Giallo, Rosso). |
| 3. Standard PON | wiki/standard-pon.md |
GPON (G.984), XGS-PON (G.9807.1), lunghezze d'onda e filtro di coesistenza WDM1r. |
| 4. Apparati sul Territorio | wiki/apparati-sul-territorio.md |
Come riconoscere OLT, Feeder, ARLO, pozzetti rompitratta, muffole IP68 e PTE/ROE. |
| 5. Fibre e Connettori | wiki/fibre-e-connettori.md |
Fibre G.652.D vs G.657, connettori verdi SC/APC vs blu SC/UPC, codice colori CEI 86-46. |
| 6. Operatori e Piani Pubblici | wiki/operatori-e-piani-pubblici.md |
Wholesale FiberCop e Open Fiber, Aree Bianche/Grigie/Nere, PNRR Piano Italia a 1 Giga. |
| 7. Anatomia di un Cantiere | wiki/anatomia-di-un-cantiere.md |
Iter SUAP/PM, minitrincea, No-Dig e le tre fasi obbligatorie del ripristino asfalto. |
| 8. Fine Lavori e Attivazione | wiki/dalla-fine-dei-lavori-allattivazione.md |
Soffiaggio cavi, collaudo riflettometrico OTDR, vendibilità wholesale e delivery utente. |
| 9. Glossario Tecnico | wiki/glossario.md |
Oltre 40 lemmi e definizioni rigorose di acronimi, protocolli e apparati. |
| 10. Domande Frequenti (FAQ) | wiki/faq.md |
Diritti condominiali (art. 91 CCE), segni spray su asfalto, portabilità e costi. |
| 11. La Rete a Collesalvetti | wiki/collesalvetti.md |
Dati territoriali ufficiali di Collesalvetti derivati da Snapshot 3 (63 feature, 21,72 km). |
geofibra/
├── index.html # Applicazione cartografica GIS (Desktop/Tablet) + Blocco Mobile
├── wiki.html # Portale documentale autonomo Wiki (Desktop & Mobile)
├── start_server.py # Launcher server locale Python multi-piattaforma
├── css/
│ ├── app.css # Stili principali per la mappa e i pannelli
│ └── wiki.css # Stili per la lettura prose e tabelle a scorrimento
├── data/
│ ├── network_data.json # GeoJSON FeatureCollection consolidato (Snapshot 3, 63 feature)
│ ├── ordinanze.json # Fonte di verita' ordinanze e prescrizioni viabilita'
│ ├── rete_ftth_collesalvetti.xlsx # Export Microsoft Excel nativo completo
│ ├── rete_ftth_collesalvetti_*.csv # Export CSV standard e per Excel italiano
│ └── snapshots/ # Archivio KML storici e CHANGELOG_DATI.md
├── js/
│ ├── data.js # Assegnazione window.FTTH_NETWORK_DATA
│ ├── cantieri_tracker.js # Motore calcolo orari Europe/Rome e modale ordinanze
│ ├── map.js # Istanza Leaflet, livelli Esri/OSM e popup informativi
│ ├── telemetry.js # Telemetria, contatori e barra ricerca apparati
│ └── main.js # Coordinamento eventi e avvio applicazione
├── docs/
│ └── HANDOFF_REDESIGN.md # Manuale di architettura per il futuro redesign grafico
├── vendor/
│ └── marked.min.js # Parser Markdown leggero client-side (v11.1.1 pinned)
├── wiki/
│ ├── index.json # Catalogo strutturato delle 11 voci
│ ├── articles_data.js # Fallback dati per esecuzione offline su file://
│ └── *.md # I file Markdown delle singole voci
├── ordinanze/ # File PDF originali delle ordinanze di Polizia Municipale
└── scripts/
├── kml_to_geojson.py # Pipeline di conversione KML -> GeoJSON (Haversine & aree)
└── export_sheets.py # Pipeline di generazione fogli CSV e XLSX
I dati del progetto sono rigenerabili deterministicamente dal rilievo KML sorgente mediante due comandi Python privi di dipendenze pesanti:
# 1. Rigenera data/network_data.json e js/data.js dal KML corrente
python scripts/kml_to_geojson.py
# 2. Rigenera i file CSV e il foglio Excel (data/rete_ftth_collesalvetti.*)
python scripts/export_sheets.pyIl passo 1 esegue anche scripts/compute_stats.py, che scrive data/stats.json e js/stats.js: unica fonte dei conteggi (apparati, feature, km) letta dal pannello statistiche del sito. Per riallineare i blocchi auto-generati dei Markdown (contrassegnati da <!-- AUTO-STATS:BEGIN ... -->) e wiki/articles_data.js:
# 3. Rigenera i blocchi statistici di README, README_EN e wiki/collesalvetti.md e il bundle della wiki
python3 scripts/sync_docs.py
# 4. Verifica la coerenza (statistiche e test integrità export Excel)
python3 -m unittest tests.test_stats -v
python3 -m unittest tests.test_xlsx_export -vDefinizione di apparato e metodologia: docs/APPARATI_RECOUNT.md. Ordine completo: kml_to_geojson.py → export_sheets.py → sync_docs.py → test.
Il sito non richiede Node.js né procedure di build. È possibile avviarlo con Python standard:
python start_server.pyLo script individuerà una porta TCP libera (default 8080), aprirà automaticamente il browser predefinito all'indirizzo http://localhost:8080 e servirà i file con i corretti MIME types.
Il portale è ospitato come sito statico su GitHub Pages.
- Accedi a GitHub:
Settings$\rightarrow$ General$\rightarrow$ Repository name$\rightarrow$ rinomina ingeofibra. - Aggiorna la descrizione del repository:
"Osservatorio civico della rete FTTH e registro cantieri nel Comune di Collesalvetti (LI) con wiki tecnica sulla banda ultralarga"
- Topic consigliati:
ftth,fibercop,open-fiber,leaflet,gis,collesalvetti,open-data,civic-tech. - Verifica che GitHub Pages rimanga impostato su Deploy from a branch
$\rightarrow$ main/ root. - Aggiorna il puntamento remoto nel tuo terminale locale:
git remote set-url origin https://github.com/hainetsoftware/geofibra.git
Questo progetto è un'iniziativa informativa e civica indipendente, senza fini di lucro. Non è sponsorizzato né affiliato ad alcuno degli operatori di rete citati (FiberCop, Telecom Italia, Fastweb, Open Fiber) né al Comune di Collesalvetti.
Il codice sorgente è distribuito con licenza MIT. I dati geospaziali e i testi della Wiki sono rilasciati per finalità civiche con licenza aperta.