Help operativo

Obiettivo del plugin
Trasformare gli elementi del progetto QGIS in un computo metrico estimativo: ogni feature richiama un codice voce di prezziario e la sua quantità viene calcolata dalla geometria o letta da un campo manuale.

1. Flusso consigliato

Apri la scheda Info e crea il progetto demo se vuoi partire da un esempio già pronto.
Vai in Prezziari e usa prima il Catalogo regionale: per ogni regione vedi subito se il dataset è pronto, solo scaricabile oppure da compilare manualmente.
Se disponibile, importa il dataset locale pronto. In alternativa usa CSV/XLSX, un DCF leggibile, link salvati o download ufficiale.
Se il formato ufficiale non è direttamente importabile, crea il template manuale regionale e compila il CSV con la struttura richiesta.
Vai in Misurazioni, scegli il layer e verifica il mapping dei campi.
Clicca Calcola computo dal layer.
Vai in Computo per completare intestazione, logo, riferimenti e mappa del report.
Vai in Contabilità per generare SAL, certificato di pagamento, registro, libretto e giornale lavori.

Catalogo regionale
Il catalogo mostra tre stati:

Dataset pronto: il plugin include già un file normalizzato e importabile.
Conversione manuale: il portale ufficiale espone un file consultabile, ma non ancora affidabile per import diretto.
Portale censito: la regione è presente, ma il dataset non è ancora bundle locale.

Il file scaricato viene sempre salvato in una cartella locale accessibile dal plugin.

Supporto DCF
Il plugin prova a leggere un file .dcf solo se è realmente interpretabile come:

contenitore ZIP con CSV/XLSX interni;
database SQLite con tabelle riconoscibili;
tabella testuale uniforme.

Se il DCF è proprietario o non documentato, il plugin lo rifiuta e chiede la conversione in CSV/XLSX.

2. Formato atteso dei layer

Campo	Obbligatorio	Uso
`item_code`	Sì	Codice della voce presente nel prezziario attivo.
`descrizione`	No	Descrizione specifica della feature; se vuota viene usata quella del prezziario.
`categoria`	No	Raggruppamento di capitoli o lavorazioni.
`quantita_man`	No	Se compilata, sostituisce il calcolo geometrico automatico.
`coefficiente`	No	Moltiplicatore numerico applicato alla quantità finale.
`unita_override`	No	Forza l'unità di misura della singola feature.
`larghezza_m`	No	Permette di derivare superfici da linee e volumi da elementi lineari.
`altezza_m`	No	Permette di derivare volumi da linee o punti.
`spessore_m`	No	Permette di derivare volumi da poligoni o linee.
`pezzi`	No	Permette quantità a corpo più precise rispetto al semplice conteggio feature.
`note`	No	Annotazioni riportate nel dettaglio del report.

3. Formato atteso dei prezziari

__FORMAT_HELP__

4. Regole di misura automatiche

mq e ha: misura dell'area.
mq su layer lineari: se presente larghezza_m, usa lunghezza x larghezza.
ml e km: misura della lunghezza; per i poligoni usa il perimetro.
cad: una unità per feature, oppure il valore del campo pezzi.
mc: area x spessore oppure lunghezza x larghezza x altezza/spessore.

5. Report completo

Nella scheda Computo puoi impostare:

logo del documento;
titolo, sottotitolo e organizzazione;
riferimenti multipli con pulsante Add +;
piè di pagina / note finali;
inclusione della mappa corrente nel PDF.

Il profilo viene salvato nel database locale del plugin.

6. Avvisi importanti

Usa un CRS metrico proiettato per evitare risultati incoerenti.
Se il plugin segnala dati non uniformi, correggi intestazioni o valori numerici prima di importare.
Se un codice voce non esiste nel prezziario attivo, il plugin lo segnala e assegna prezzo zero.