# Introduzione

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

Questo manuale OpenCity ha l’obiettivo di illustrare le funzionalità che la piattaforma mette a disposizione dei redattori per la creazione e la gestione dei contenuti del sito web istituzionale.

Il documento è strutturato in due parti principali:

## Funzionalità generali della piattaforma

In questa sezione vengono presentati:

* una panoramica delle [principali funzioni disponibili](/manuale-opencity-italia-sito-web-istituzionale-v3/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti.md) per l’aggiornamento dei contenuti del sito;
* i [moduli integrativi](/manuale-opencity-italia-sito-web-istituzionale-v3/moduli-integrativi-della-piattaforma/amministrare-la-trasparenza.md) che l’Ente può chiedere di attivare;
* le [linee guida](/manuale-opencity-italia-sito-web-istituzionale-v3/linee-guida/testi-e-linguaggio.md) per una corretta gestione editoriale dei contenuti, comprese indicazioni sull’utilizzo delle immagini.

## Il motore di ricerca del sito

La piattaforma usa un **motore di ricerca interno** per alimentare sia la barra di ricerca del sito sia tutti i blocchi di contenuti filtrabili (per tipologia, categoria, data e altri criteri). Tutte queste funzioni attingono all'indice di ricerca: nessuna interroga direttamente il database.

Ogni volta che pubblichi o modifichi un contenuto, la piattaforma lo indicizza automaticamente: il contenuto diventa subito cercabile e visibile nei blocchi che lo includono.

{% hint style="info" %}
Il motore di ricerca contiene una **copia** dei contenuti del sito, non è la fonte. Questo significa che un contenuto può esistere nel database ma non comparire nella ricerca o nei blocchi, se per qualche motivo non è stato indicizzato.
{% endhint %}

### Quando un contenuto non compare nella ricerca

Ci sono situazioni in cui il contenuto potrebbe non essere presente nell'indice:

* dopo la pubblicazione, se l'indicizzazione non è andata a buon fine;
* quando vengono aggiunti nuovi campi a un tipo di contenuto: i contenuti già esistenti di quel tipo non vengono reindicizzati automaticamente;
* dopo una migrazione di dati o un ripristino da backup.

In questi casi il contenuto è nel sito ma non è raggiungibile tramite ricerca né visibile nei blocchi filtrabili.

{% hint style="warning" %}
Se un contenuto non compare nella ricerca o in un blocco filtrabile dopo la pubblicazione, segnalalo all'**amministratore della piattaforma**. L'amministratore può avviare la reindicizzazione, che può riguardare un singolo tipo di contenuto o l'intero sito.
{% endhint %}

## Modelli di sito web e relative funzionalità

La seconda parte del manuale descrive le funzionalità specifiche previste per i diversi modelli di sito:

* sito per [**Comuni italiani**](/manuale-opencity-italia-sito-web-istituzionale-v3/modello-comuni/il-modello-di-sito-comunale.md);
* sito per [**Province e Regioni**](/manuale-opencity-italia-sito-web-istituzionale-v3/modello-regioni-e-province-autonome/il-modello-di-sito-regionale-e-provinciale.md);
* sito per [**Aziende Sanitarie Locali (ASL)** e **Aziende Ospedaliere (AO)**](/manuale-opencity-italia-sito-web-istituzionale-v3/modello-asl/il-modello-di-sito-per-asl.md).


---

# Agent Instructions: 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:

```
GET https://docs.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.