For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integrazione con il gestionale atti

Attraverso il connettore con il gestionale atti dell'ente, delibere e determine non devono più essere caricate manualmente sul sito. Gli atti vengono importati automaticamente nella sezione Documenti, insieme ai principali metadati, e resi immediatamente disponibili per l'utilizzo da parte del sistema.

Questo elimina la necessità di duplicare il lavoro su due piattaforme diverse e riduce sensibilmente il rischio di errori nella pubblicazione.

Come funziona il connettore

L'importazione è periodica, con aggiornamento ogni 12 ore (la finestra temporale è configurabile, con valore predefinito di 48 ore).

La strategia adottata è di tipo insert-only: gli atti già presenti nel sito vengono riconosciuti e saltati automaticamente, evitando duplicazioni.

Il connettore utilizza le API REST di Sicraweb con autenticazione Bearer token. Il recupero degli atti avviene tramite la funzione listaAtti (con paginazione e filtro per data di aggiornamento) e la funzione dettaglioAtto per i campi estesi.

Mappatura con supporto AI

La mappatura dei dati importati avviene anche con il supporto dell'intelligenza artificiale, secondo le seguenti logiche:

  • selezione del tipo documento, dell'ufficio responsabile e degli argomenti tematici tra quelli già presenti nel sito di destinazione, garantendo coerenza con la tassonomia in uso;

  • normalizzazione della descrizione breve: l'oggetto dell'atto viene uniformato applicando il sentence case — solo la prima lettera in maiuscolo — mantenendo in maiuscolo acronimi (es. CIG, IVA, ANAC), sigle di province italiane, numeri romani e nomi propri di persona o geografici. Il testo non viene troncato né parafrasato;

  • generazione automatica di abstract e descrizione strutturata a partire dall'oggetto dell'atto e dal testo estratto dal PDF allegato. La descrizione è articolata in tre punti: azione principale, eventuali acronimi e impatto per i cittadini.

Arricchimento e leggibilità degli atti

Oltre alla mappatura, il sistema migliora la qualità e la trovabilità di ogni atto importato.

La descrizione breve viene normalizzata a partire dall'oggetto originale dell'atto: viene applicato il sentence case (solo la prima lettera in maiuscolo), mantenendo in maiuscolo acronimi come CIG, IVA o ANAC, le sigle di province italiane, i numeri romani e i nomi propri di persona o geografici. Il testo non viene modificato nel significato né troncato.

L'abstract generato automaticamente offre ai cittadini un'anteprima chiara del contenuto senza dover aprire il PDF.

La classificazione per argomento tematico rende ogni atto raggiungibile anche dalle altre sezioni del sito — non solo dall'Albo pretorio o dall'Amministrazione Trasparente, ma da qualsiasi pagina tematica correlata.

Puoi verificare il risultato dell'arricchimento AI direttamente sulla scheda del documento, prima che l'atto venga reso pubblico. Se necessario, puoi modificare manualmente titolo, abstract e classificazioni.

I documenti importati tramite il connettore riportano automaticamente, nella pagina pubblica, il seguente avviso ai cittadini:

Questa scheda sintetica è stata generata tramite sistemi di intelligenza artificiale per facilitare la lettura. Per i dettagli completi e il valore legale dell'atto, si rimanda al documento originale allegato.

L'avviso viene impostato dal sistema e non richiede alcun intervento da parte del redattore.

Esempio pratico

Un atto con oggetto "LIQ. LAVORO STRAORDINARIO PERSONALE DIP. 1° TRIM. 2026" viene importato con:

  • descrizione breve: "Liq. lavoro straordinario personale dip. 1° trim. 2026";

  • abstract: descrizione breve accessibile ai cittadini;

  • argomenti: classificazione automatica che collega l'atto alle sezioni tematiche del sito.

Sintesi mappatura campi Maggioli → OpenCity Italia

Campo Maggioli
Valore esempio
Campo OpenCity Italia
Valore esempio
Note

Categoria + Sottocategoria

ATTI AMMINISTRATIVI / DETERMINA IN TRASPARENZA

✨ Tipologia di documento

Atto amministrativo / Determinazione

Mappatura tramite vocabolario controllato "Documenti Albo pretorio". Per le Pubblicazioni di Matrimonio, il tipo documento viene sempre impostato a Pubblicazione di matrimonio.

Anno atto + Numero atto

2026 + 215

Numero atto

215/2026

Visualizzato come stringa: "Determina n. 215 del 2026"

Data documento / Data atto

27/05/2026

Data del documento

27/05/2026

Data esecutività

27/05/2026

Data inizio validità/efficacia

27/05/2026

Data di registro

27/05/2026

Data di inizio pubblicazione

27/05/2026

Data di rimozione dalla trasparenza

27/05/2032

Calcolata automaticamente: data di inizio pubblicazione + 5 anni

Data di protocollazione

27/05/2026

Data di protocollazione

27/05/2026

Numero di protocollo

3444454

Numero di protocollo

3444454

Anno di registro + Numero di registro

2026 + 916

Numero registro albo

2026/916

Proponente

Ufficio Ambiente

✨ Unità organizzativa responsabile

Ufficio Ambiente

Oggetto

AFFIDAMENTO INCARICO...

Descrizione breve

Affidamento incarico...

Sentence case: prima lettera maiuscola, acronimi e nomi propri mantenuti in maiuscolo, testo non modificato né troncato

Dirigente/Firmatario

Mario Rossi

Dirigente/Firmatario

Mario Rossi

Allegati del gestionale

(file PDF + P7M)

Documenti

(file PDF + P7M)

I file allegati vengono importati così come sono

✨ Descrizione estesa

(testo generato)

L'AI legge il PDF allegato e genera la descrizione estesa

✨ Argomenti

Lavoro, Economia, Politica

L'AI legge il PDF allegato e assegna gli argomenti

✨ Formati disponibili

PDF

Rilevati automaticamente dai file allegati

Licenza di distribuzione

CC-BY 4.0

Sempre CC-BY 4.0 per tutti gli atti importati da Maggioli

Nota in calce

"Questa scheda sintetica è stata generata..."

Aggiunta automaticamente a tutti gli atti con descrizione generata da AI

I campi contrassegnati con ✨ sono generati o compilati tramite il supporto dell'intelligenza artificiale.

Ultimo aggiornamento

È stato utile?