Domain Knowledge Base - Cartografia
Come funziona il dominio, prima di scrivere una riga di codice? Scegli un documento dall'albero a sinistra: ogni pagina spiega una parte del modello.
Regole di Business - Cartografia
Questo documento elenca le regole fondamentali del dominio cartografico, identificate con codice univoco BR-NNN. Ogni regola è technology-independent e descrive un vincolo invariante su rilievo, proiezione, georeferenziazione e pubblicazione di dati geografici.
> Nota: Questo è un dominio tecnico-scientifico di rilevamento. Le regole modellano il processo di misura, proiezione e validazione dei dati spaziali, non transazioni commerciali.
---
BR-001 - Sistema di riferimento esplicito obbligatorio
Codice: BR-001
Nome: Ogni dato geografico deve dichiarare il proprio sistema di riferimento (CRS/EPSG)
Descrizione: Una Mappa, un LayerGeografico o un Rilievo non possono esistere senza un sistema di riferimento esplicito identificato da un codice EPSG (es. 4326 per WGS84, 25832 per ETRS89/UTM32N). Coordinate prive di CRS sono ambigue e non utilizzabili.
Motivazione: Prevenire errori di posizionamento dovuti all'interpretazione errata delle coordinate.
Priorità: CRITICA
Attori: Cartografo, Utente GIS
Tracciabilità: EPSG; ETRS89; WGS84; riproietta-layer.md.
---
BR-002 - Coerenza tra scala e precisione
Codice: BR-002
Nome: Il dettaglio del dato deve essere coerente con la scala di rappresentazione
Descrizione: Una Mappa a una data ScalaCartografica (es. 1:25.000) ha un'accuratezza posizionale minima implicita (errore graficabile ≈ 0,2 mm × denominatore di scala). Non si rappresentano feature con precisione superiore a quanto la scala consente.
Motivazione: Evitare di attribuire alla carta una precisione che il dato non possiede.
Priorità: ALTA
Attori: Cartografo, Fotointerprete
Tracciabilità: Scala; equidistanza; produci-mappa.md.
---
BR-003 - Validazione del rilievo prima della pubblicazione
Codice: BR-003
Nome: Un Rilievo deve essere elaborato e validato prima della pubblicazione
Descrizione: I dati di campo (punti GNSS, nuvole LiDAR, fotogrammetria) devono passare per elaborazione e controllo qualità (residui, chiusura delle poligonali, accuratezza) prima di transitare a pubblicato come LayerGeografico o Mappa.
Motivazione: Garantire l'affidabilità geometrica dei prodotti cartografici diffusi.
Priorità: ALTA
Attori: Geodeta, Cartografo
Tracciabilità: rilievo-lifecycle.md; RINEX; esegui-rilievo.md.
---
BR-004 - Tracciabilità della trasformazione di datum
Codice: BR-004
Nome: Ogni riproiezione tra datum deve usare una trasformazione documentata
Descrizione: La conversione tra sistemi di riferimento (es. Roma40/Gauss-Boaga → ETRS89) deve usare una trasformazione nota (es. Helmert a 7 parametri, grigliati ufficiali) e registrarla, perché trasformazioni diverse producono scarti di alcuni metri.
Motivazione: Rendere riproducibile e verificabile ogni riproiezione di coordinate.
Priorità: ALTA
Attori: Geodeta, Utente GIS
Tracciabilità: Trasformazione di Helmert; PROJ; riproietta-layer.md.
---
BR-005 - Georeferenziazione dei punti geodetici
Codice: BR-005
Nome: Ogni PuntoGeodetico ha coordinate, quota e accuratezza dichiarate
Descrizione: Un punto geodetico (vertice trigonometrico, caposaldo) riporta coordinate nel CRS dichiarato, quota (ortometrica o ellissoidica con il geoide di riferimento) e l'accuratezza stimata. La distinzione tra quota GPS (ellissoidica) e quota s.l.m. (ortometrica) è esplicita.
Motivazione: Evitare confusione tra tipi di quota che differiscono di decine di metri.
Priorità: ALTA
Attori: Geodeta, Cartografo
Tracciabilità: Vertice Geodetico; geoide; entità PuntoGeodetico.
---
BR-006 - Ufficialità dei toponimi
Codice: BR-006
Nome: I ToponimoUfficiale provengono da fonti autoritative
Descrizione: I nomi di luogo riportati su una mappa ufficiale derivano da fonti toponomastiche riconosciute (IGM, anagrafe comunale); le varianti non ufficiali sono distinte. La modifica di un toponimo segue un processo di registrazione.
Motivazione: Garantire coerenza e autorevolezza della toponomastica cartografica.
Priorità: MEDIA
Attori: Cartografo, Utente GIS
Tracciabilità: Toponomastica; IGM; entità ToponimoUfficiale.
---
BR-007 - Versionamento delle mappe
Codice: BR-007
Nome: Ogni aggiornamento di una Mappa pubblicata genera una nuova versione
Descrizione: Le correzioni o gli aggiornamenti di una mappa pubblicata producono una nuova versione tracciata (VersioneMappaRilasciata), mantenendo la versione precedente come riferimento storico fino alla deprecazione.
Motivazione: Consentire ai consumatori di sapere su quale edizione del dato stanno lavorando.
Priorità: MEDIA
Attori: Cartografo, Utente GIS
Tracciabilità: mappa-aggiornata (evento); entità Mappa.
---
BR-008 - Interoperabilità tramite formati e servizi standard
Codice: BR-008
Nome: I dati pubblicati usano formati e servizi standard (OGC)
Descrizione: Un LayerGeografico pubblicato è esposto in formati interoperabili (GeoJSON, GeoPackage, Shapefile, GeoTIFF) e/o servizi standard OGC (WMS, WMTS, WFS), con il CRS dichiarato, per garantire l'uso cross-piattaforma.
Motivazione: Evitare il lock-in e consentire l'integrazione tra strumenti GIS diversi.
Priorità: MEDIA
Attori: Utente GIS, Cartografo
Tracciabilità: WMS/WMTS/WFS; GeoJSON; GeoTIFF; BR-001.