Esplora Padova — starter repo del corso WebGIS Frontend

Repo di partenza per il corso video "WebGIS Frontend — Esplora Padova" di Federico Gianoli (Studio GIS).

Per la guida completa di setup leggi SETUP.md dei materiali del corso. Per il piano video leggi README.md della cartella materiali.

TL;DR — partire in 3 minuti

Hai già installato Docker Desktop, VS Code e l'estensione "Dev Containers"? Allora:

git clone https://github.com/fgianoli/corso_webGIS_fe.git
cd corso_webGIS_fe
code .

Dentro VS Code, alla notifica in basso a destra "Reopen in Container", clicca. La prima volta ci mette 5-10 minuti (scarica le immagini Docker). Dopo, secondi.

Quando l'ambiente è pronto:

# nel terminale di VS Code (che è già DENTRO il container)
cd frontend
npm run dev

Apri http://localhost:5173 sul tuo browser Windows. Apri http://localhost:8080/geoserver per la console GeoServer (admin / corsowebgis).

Cosa c'è qui dentro

.
├── docker-compose.yml             # 3 servizi: frontend, geoserver, db (opzionale)
├── Dockerfile.frontend            # immagine Node 20 + tools
├── .devcontainer/
│   └── devcontainer.json          # config VS Code Dev Containers
├── frontend/                      # codice della WebGIS
│   ├── package.json
│   ├── vite.config.js             # con proxy /geoserver pre-configurato
│   ├── index.html
│   └── src/
│       ├── main.js
│       └── style.css
├── data/                          # dataset Padova (montati in GeoServer)
│   ├── poi-padova.geojson
│   └── README.md
└── geoserver/
    └── README.md

Branch — un branch per video

main                          stato finale completo (V9)
v0-setup                      starter pulito (questo)
v1-fondamenti                 = v0 (V1 è solo teoria, niente codice)
v2-prima-mappa                + prima mappa Leaflet di Padova
v3-leaflet                    + GeoJSON, popup, cluster, draw
v4-geoserver-setup            + workspace e layer pubblicati
v5-geoserver-ogc              + chiamate WMS/WFS dal frontend
v6-maplibre-style             + mappa MapLibre con stile JSON
v7-maplibre-interattivita     + click, popup, hover, 3D
v8-geoserver-vector-tiles     + vector tiles da GeoServer
v9-app-finale-deploy          + UI finale + GitHub Pages CI/CD

Per saltare a un punto qualunque del corso:

git checkout v5-geoserver-ogc

Stop / pulizia

# Ferma i container, mantieni i dati GeoServer
docker compose down

# Reset completo (cancella anche il volume GeoServer)
docker compose down -v