Integrazione con il frontend

Il componente di interfaccia (Frontend) è l'elemento che permette l'interazione diretta tra i cittadini e il motore di intelligenza artificiale configurato nel backend.

Il widget è stato sviluppato seguendo rigorosamente le linee guida ufficiali di Designers Italia. Questo garantisce:

• piena accessibilità e usabilità;

• coerenza grafica con gli standard dei siti della Pubblica Amministrazione;

• un'esperienza utente (UX) intuitiva.

Parametri di configurazione

Il codice sorgente completo del widget è disponibile al seguente indirizzo: https://gitlab.com/opencity-labs/sito-istituzionale/widget-opencity-ai

Per rendere operativo il widget e personalizzarlo secondo le specifiche dell'Ente, lo script di integrazione richiede la definizione obbligatoria di cinque parametri:

Parametro	Funzione	Esempio / Note
API URL	Indirizzo HTTP per le chiamate REST al backend.	https://chat.ente.it/cat
WebSocket URL	Indirizzo per la connessione in tempo reale (streaming).	wss://chat.ente.it/cat/ws
Nome Ente	Etichetta testuale mostrata nell'intestazione della chat.	Es. "Comune di Trento"
Colore Principale	Codice esadecimale per il branding (bottoni, header).	Es. #0066CC
Link Privacy	URL alla pagina dell'informativa sul trattamento dati.	Obbligatorio per conformità GDPR.