> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/le-funzioni/struttura-standard-delle-pagine.md).

# Struttura standard delle pagine

I servizi digitali di OpenCity Italia seguono una struttura di pagine condivisa, con titoli e ordine standard. Questo standard garantisce un'esperienza coerente per il cittadino, che riconosce il flusso di compilazione indipendentemente dal tipo di servizio che sta utilizzando.

{% hint style="info" %}
Questo standard è allineato alle linee guida di [Designers Italia per i flussi di servizio](https://docs.italia.it/italia/designers-italia/design-comuni-docs/it/versione-corrente/flussi-di-servizi/moduli.html), che definiscono i moduli e le sezioni da utilizzare nella digitalizzazione dei servizi comunali.
{% endhint %}

### Pagine sempre presenti

{% tabs %}
{% tab title="Informativa privacy" %}

#### Informativa privacy (`panel_privacy_policy`)

La prima pagina raccoglie il consenso al trattamento dei dati personali prima di qualsiasi altra interazione.

**Contenuto:**

* un element "Informativa privacy" con all'interno il Nested form `OC - Informativa privacy`.

<figure><img src="/files/T0DH2prY6pFX0IaNlm0N" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Dati generali" %}

#### Dati generali (`panel_general_data`)

È la pagina più strutturata. Contiene nell'ordine:

1. un **messaggio di benvenuto** (testo introduttivo al servizio);
2. un **element Richiedente**, con nested form `OC _ Richiedente` e select `In qualità di` (`for_whom`);
3. un **element Beneficiario**, con il nested form specifico del beneficiario.

<figure><img src="/files/wsbGGX6oJj9wOredM3TK" alt=""><figcaption></figcaption></figure>

**Distinzione tra richiedente e beneficiario**

Il **richiedente** è chi compila e firma la domanda. Il **beneficiario** è chi riceverà la prestazione. Possono coincidere, ma spesso sono persone diverse: un genitore che iscrive un figlio, un delegato che agisce per un'impresa, un tutore che richiede un servizio per un assistito.

{% hint style="info" %}
Questa distinzione è un requisito del modello di Designers Italia. Le [linee guida per i flussi di servizio](https://docs.italia.it/italia/designers-italia/design-comuni-docs/it/versione-corrente/flussi-di-servizi/sezioni.html) prevedono esplicitamente sezioni separate per i dati di soggetti diversi coinvolti nella richiesta — tra cui il caso in cui il richiedente agisce per conto di altri.
{% endhint %}

La select "**In qualità di**" consente al richiedente di qualificarsi prima che vengano richiesti i dati del beneficiario. I ruoli standard sono: beneficiario del servizio, delegato da un'altra persona, legale rappresentante di un'impresa, delegato da un'impresa. Adattali al contesto: per servizi rivolti a minorenni usa genitore, tutore, affidatario; per servizi su immobili usa proprietario, locatario, ecc.

<figure><img src="/files/EhHw82WsBbqZVlO0fM1n" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
La lista dei ruoli deve sempre riflettere le vere relazioni possibili tra richiedente e beneficiario per quel servizio.
{% endhint %}
{% endtab %}

{% tab title="Informazioni aggiuntive" %}

#### Informazioni aggiuntive (`panel_additional_info`)

Contiene i campi specifici del servizio: il tipo di richiesta, i dati sull'oggetto della domanda, eventuali allegati. Il contenuto varia da servizio a servizio ed è qui che si concentra la maggior parte del lavoro di configurazione.

<figure><img src="/files/FzyxcUIZFFr3xY1TSuiB" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Pagine opzionali

{% tabs %}
{% tab title="Preferenze di servizio" %}

#### Preferenze di servizio (`panel_service_preferences`)

Da usare quando il cittadino deve esprimere una scelta tra opzioni disponibili (es. turno, sede, modalità di erogazione). Non inserirla se il servizio non prevede scelte da parte dell'utente.

<figure><img src="/files/6R6SiMRLP0Khdytg31iW" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Situazione reddituale" %}

#### Situazione reddituale (`panel_economic_situation`)

Da usare quando è richiesta la dichiarazione ISEE o altri dati reddituali (es. contributi economici, agevolazioni tariffarie).

<figure><img src="/files/PmlsOAFJOL0h9oyuBSOa" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Dati di accredito" %}

#### Dati di accredito (`panel_bank_account`)

Da usare quando il servizio prevede un pagamento verso il cittadino (rimborso, contributo, assegno) e quindi è necessario raccogliere l'IBAN.

<figure><img src="/files/tEpO8gqjpxxb8mQn4Z2l" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Dichiarazioni" %}

#### Dichiarazioni (`panel_declarations`)

Da usare quando il servizio prevede dichiarazioni sostitutive o prese d'atto formali. È sempre l'**ultima pagina** del modulo, prima dell'invio.

<figure><img src="/files/rifTJy1s8QxrrkhtXtgR" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/le-funzioni/struttura-standard-delle-pagine.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
