# 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. |