# Upvote

> Il modulo di spazio Upvote, nella scheda Community. Una bacheca in cui i membri propongono argomenti, votano (un voto a persona, ritirabile) e commentano, e il team approva, cambia lo stato, unisce i duplicati, archivia con un motivo e riapre. Ordinamenti, filtri, colonne, lettura pubblica, limiti, avvisi via e-mail, e le stesse azioni dall'assistente e dall'API.

L'**Upvote** è una bacheca in cui i membri dicono cosa vogliono: ogni persona propone **argomenti** (un'idea, una richiesta, un miglioramento), tutti votano quelli che sostengono, e i più votati salgono. Il team risponde cambiando lo stato di ogni argomento (**Pianificato**, **In corso**, **Fatto** o **Archiviato**, con il motivo), e chi ha votato riceve l'avviso.

È un [modulo di spazio](/conceitos/modulos) della scheda **Community** di **Aggiungi Spazio**. **Uno spazio è una bacheca**: per avere bacheche separate (prodotto, eventi, contenuti), crea più spazi. Chi crea lo spazio: proprietario o amministratore.

## Upvote, Sondaggio o Questionario?

| | [Sondaggio](/espacos/enquetes) | [Questionario](/espacos/pesquisas) | **Upvote** |
|---|---|---|---|
| Chi chiede | Il team | Il team | **I membri** propongono |
| Opzioni | Fisse, scritte dal team | Questionario a sezioni | Elenco aperto, che cresce ogni giorno |
| Dove vive | In un post del Feed o dei Contenuti | Spazio proprio e link pubblico | Spazio proprio |
| Voto | Si sceglie un'opzione; solo il team vede chi ha votato cosa | Risposta identificata o anonima | Un voto per argomento, su quanti argomenti vuoi; ritirabile |
| Fine | Si chiude a una scadenza | Periodo, con risultato e NPS | Non si chiude mai; ogni argomento ha il suo esito |
| A cosa serve | Decidere ora tra poche opzioni | Misurare soddisfazione e clima | Scoprire cosa vuole la community e mostrare cosa è stato fatto |

**La regola pratica:** il team vuole sapere tra A, B o C → Sondaggio; vuole misurare → Questionario; vuole che i membri dicano cosa vogliono e mostrare cosa ne ha fatto → Upvote.

## Chi può fare cosa

| Azione | Chi |
|---|---|
| Leggere la bacheca, gli argomenti e i commenti | Chi apre lo spazio; in uno spazio **pubblico**, anche il visitatore senza accesso |
| Votare, ritirare il voto e commentare | Chi apre lo spazio, con accesso effettuato |
| Proporre un argomento | Chi il **Chi può pubblicare** dello spazio permette |
| Modificare ed eliminare il proprio argomento | L'autore, finché un'altra persona non lo vota |
| Approvare, modificare, cambiare lo stato, unire, archiviare, riaprire, vedere chi ha votato ed eliminare | Il **team**: proprietario, amministratore e moderatore. La finanza non ne fa parte |
| Attivare l'approvazione preventiva | Proprietario e amministratore |

## Come funziona

### La bacheca

Ogni argomento compare in una scheda con il **pulsante di voto a sinistra** (la freccia e il numero, pieno quando hai votato), il titolo, un estratto della descrizione, l'autore, i commenti e l'etichetta dello stato.

- **Ordina per:** **Più votati** (predefinito; a parità, il più recente), **Nuovi** e **Di tendenza** (i più votati negli ultimi 7 giorni, aggiornato ogni ora).
- **Filtri:** **Tutti** (tutti tranne gli archiviati), **Aperti**, **Pianificati**, **In corso**, **Fatti**, **Archiviati**, **I miei argomenti** e **Votati**.
- **Vista:** **Elenco** o **Colonne** (Aperto, Pianificato, In corso e Fatto, ciascuna per i più votati). Sul telefono, le colonne diventano schede per stato, una alla volta.

L'elenco ha una sola riga con gli stati e menu compatti, **Ordina** e **Filtro** (incluso **Tutti gli argomenti**), e le colonne non ripetono più lo stato in ogni scheda. Nell'argomento, la barra mantiene **Modifica** e **Cambia stato**, e il resto va in **Altre azioni**.

### Il voto

Ogni persona ha **un voto per argomento** e vota su quanti argomenti vuole. Un nuovo clic ritira il voto. Chi propone parte già votando il proprio argomento (e può ritirare il voto).

Tutti vedono il conteggio; **chi ha votato lo vede solo il team**, in **Chi ha votato**, con la data in cui ogni persona è entrata nella community (aiuta a notare account duplicati).

Votare e ritirare il voto valgono solo per argomenti **Aperti**, **Pianificati** o **In corso**. In **Fatto** e **Archiviato**, la votazione si congela: non si può votare né ritirare il voto.

### Gli stati

| Stato | Cosa significa | Voto | Commento |
|---|---|---|---|
| **Aperto** | Riceve voti | Sì | Sì |
| **Pianificato** | Il team lo farà | Sì | Sì |
| **In corso** | Il team lo sta facendo | Sì | Sì |
| **Fatto** | Pronto | Congelato | Sì |
| **Archiviato** | Non andrà avanti, con il motivo visibile a tutti | Congelato | No |

Solo il team cambia lo stato. Ogni cambio accetta una **Nota per chi ha votato** (*"uscito nella versione di marzo"*); archiviare richiede il **Motivo**. **Riapri** riporta un argomento Fatto o Archiviato ad Aperto. I voti restano sempre.

### Esiste già qualcosa di simile?

Quando proponi, dalla terza parola del titolo compaiono fino a 5 argomenti della stessa bacheca che condividono parole con esso, sotto **Esiste già qualcosa di simile?**. Se uno di questi è quello che vuoi, **Vota questo** gli dà il tuo voto invece di crearne un altro.

### Unire i duplicati

Quando due argomenti chiedono la stessa cosa, il team usa **Unisci a…** su quello ripetuto e sceglie l'originale, che deve essere Aperto, Pianificato o In corso, nella stessa bacheca. Il ripetuto viene archiviato come *"Duplicato di <titolo>"*, con il link; i voti passano all'originale **senza contare due volte** chi ha votato entrambi; i commenti restano sul ripetuto. **Un argomento unito non si riapre.**

### Commenti

Chi apre lo spazio commenta e risponde (un livello di risposta), fino a 2.000 caratteri. L'autore del commento e il team lo eliminano; eliminare un commento porta via le sue risposte. Un argomento archiviato non riceve più commenti.

### Approvazione preventiva

Con **Approvazione preventiva** attiva, gli argomenti dei membri compaiono in bacheca solo dopo l'approvazione del team. Fino ad allora, l'argomento è **In attesa di approvazione**, visibile solo all'autore (in **I miei argomenti**) e al team, e non riceve voti né commenti. Se l'autore modifica il testo di un argomento già approvato, torna in approvazione. Gli argomenti del team entrano subito.

Il team vede la barra **Gestisci bacheca**, con quanti argomenti sono in attesa e il pulsante **Coda di approvazione**, che elenca quelli in attesa con **Approva** e **Rifiuta** (quello rifiutato resta visibile solo all'autore e al team). Quelli in attesa compaiono anche nella [moderazione](/membros/moderacao).

### Lettura pubblica

In uno spazio con visibilità **Pubblico**, il visitatore senza accesso legge tutto (la bacheca, gli argomenti, il conteggio, gli stati e i commenti), tranne chi ha votato. Votare, commentare o proporre apre *"Accedi per votare ciò che sostieni"* (oppure *"Accedi per commentare"*, *"Accedi per proporre un argomento"*), con **Accedi** e **Crea account**; poi la persona torna alla bacheca. In uno spazio non pubblico, legge solo chi apre lo spazio.

### Limiti

| Limite | Valore |
|---|---|
| Nuovi argomenti | 5 a persona al giorno (il team non ha limite; contano quelli in attesa e quelli eliminati) |
| Voti | 120 a persona all'ora |
| Titolo | 140 caratteri |
| Descrizione | 5.000 caratteri |
| Foto | Fino a 4 per argomento (JPG, PNG o WebP) |
| Nota o motivo | 500 caratteri |

### Avvisi via e-mail

| Chi lo riceve | Quando |
|---|---|
| L'autore e chi ha votato | L'argomento passa a **Pianificato**, **In corso**, **Fatto** o **Archiviato** (con la nota o il motivo), viene **riaperto** o **unito** a un altro |
| Il team | Viene proposto un nuovo argomento |

Il membro **non** riceve un'e-mail per ogni nuovo argomento. Gli avvisi arrivano anche nella campanella. Li riceve solo chi **ha ancora accesso allo spazio** al momento dell'avviso. Si disattivano nella categoria **Upvote: argomenti che sostieni**, in [E-mail di questa community](/notificacoes/emails-desta-comunidade), o con il link a piè di pagina.

## Passo dopo passo

### Creare una bacheca

*Ruolo: proprietario o amministratore.*

1. Nel menu, in **Aggiungi Spazio**, apri la scheda **Community** e scegli **Upvote**.
2. Dai il nome, la descrizione, la visibilità (**Pubblico** fa leggere chiunque) e il **Chi può pubblicare**. Attiva **Approvazione preventiva** se vuoi approvare ogni argomento.
3. Creala. In seguito, **Configura**, nella barra **Gestisci bacheca**, attiva e disattiva l'approvazione preventiva.

### Proporre un argomento

1. Nella bacheca, fai clic su **Nuovo argomento** (sul telefono, nel piè di pagina: *"Hai un'idea? Proponila."*).
2. Scrivi il **Titolo** e guarda **Esiste già qualcosa di simile?**: se un argomento è quello che vuoi, **Vota questo**.
3. Scrivi la **Descrizione** e, se vuoi, **Aggiungi foto** (fino a 4).
4. Fai clic su **Pubblica argomento**.

### Gestire un argomento

*Ruolo: proprietario, amministratore o moderatore.*

Apri l'argomento. La barra **Gestisci argomento** mostra i voti, lo stato e le azioni:

- **Approva**: quando l'argomento è in attesa di approvazione.
- **Modifica**: titolo, descrizione e foto.
- **Cambia stato**: scegli lo stato e, se vuoi, la nota per chi ha votato. **Salva stato** avvisa l'autore e chi ha votato.
- **Unisci a…**: scegli l'argomento originale e conferma.
- **Archivia**: con il motivo, obbligatorio.
- **Riapri**: da Fatto o Archiviato ad Aperto.
- **Chi ha votato**: l'elenco, con la data di ingresso di ogni persona.
- **Elimina**: l'argomento esce dalla bacheca con i voti, i commenti e le foto. Se l'idea vale ancora, archiviare con un motivo conserva lo storico.

## Esempi

**Bacheca dei suggerimenti di una scuola online.** Spazio **Pubblico** "Cosa vuoi imparare", **Chi può pubblicare = Chiunque**. Gli studenti propongono corsi; *"Excel avanzato"* arriva a 80 voti, il team lo passa a **Pianificato** con la nota *"Lo registriamo a novembre"*, e gli 80 ricevono l'avviso.

**Miglioramenti di un coworking.** Spazio per i membri con **Approvazione preventiva**. Un residente propone *"Più prese nella sala 2"*; il team lo approva, riceve voti, passa a **In corso** e poi a **Fatto**. Una seconda richiesta uguale viene unita alla prima, portandole i voti.

## Errori comuni e come risolverli

| Situazione | Cosa fare |
|---|---|
| **Nuovo argomento** non compare | Il **Chi può pubblicare** dello spazio non include il tuo ruolo |
| Non si può votare | L'argomento è Fatto, Archiviato o in attesa di approvazione; oppure non hai effettuato l'accesso (visitatore) |
| Non si può modificare il proprio argomento | Un'altra persona l'ha già votato; ora lo modifica solo il team |
| Non si può commentare | L'argomento è archiviato o in attesa di approvazione |
| Limite di 5 argomenti al giorno | Attendi che passino 24 ore dal primo argomento |
| Non si può riaprire | L'argomento è stato unito a un altro: i voti sono già lì |
| Archiviare non salva | Indica il motivo, obbligatorio |

## Domande frequenti

**I membri sanno cosa ho votato?**
No. Solo il team vede chi ha votato.

**Chi esce dalla community perde il voto?**
No. I voti restano nel conteggio; gli avvisi si fermano, perché la persona non ha più accesso.

**Si può votare senza account?**
No. In una bacheca pubblica, il visitatore legge; per votare, accede o crea l'account.

## Tramite l'assistente

L'assistente propone, vota e gestisce gli argomenti con le stesse regole di chi lo ha collegato. Vedi [Strumenti · Contenuti](/mcp/ferramentas-conteudo#upvote).

- **Lettura:** `get_upvote_board`, `list_upvote_topics` (con ordinamento e stato), `get_upvote_topic` e `find_similar_upvote_topics`.
- **Per chi apre lo spazio:** `vote_upvote_topic`, `unvote_upvote_topic` e `create_upvote_comment`, senza conferma; `create_upvote_topic` chiede conferma; `update_upvote_topic` e `delete_upvote_topic` (con conferma), l'autore finché nessun altro vota.
- **Del team:** `set_upvote_topic_status` (incluso archiviare), `reopen_upvote_topic` e `merge_upvote_topics`, tutte con conferma, mostrando il motivo e quante persone saranno avvisate; `merge_upvote_topics` non si può annullare. `list_upvote_voters`, sola lettura.
- **Del proprietario e dell'amministratore:** `update_upvote_board`, che attiva o disattiva l'approvazione preventiva.

Chiedi così: *"Controlla se esiste già un argomento simile a 'modalità scura nell'app' prima di crearlo; se c'è, votalo."* Vedi la [ricetta](/mcp/receitas#91-controlla-se-esiste-gia-un-argomento-simile-prima-di-crearlo).

## Nell'API

Le rotte stanno in `/api/upvotes`, con `X-CommunityId`; il percorso non contiene la community. Le letture non richiedono l'accesso in uno spazio pubblico.

| Rotta | Cosa fa | Chi |
|---|---|---|
| `GET /api/upvotes/spaces/{spaceId}` | La bacheca: se la persona può proporre e gestire, e i limiti | Chi legge |
| `PUT /api/upvotes/spaces/{spaceId}` | Attiva o disattiva `requireApproval` | Proprietario e amministratore |
| `GET` · `POST /api/upvotes/spaces/{spaceId}/topics` | Elenca (`sort` = `top`, `new` o `trending`; `status`; `mine`; `voted`; `cursor`) · propone | Chi legge · chi può pubblicare |
| `GET /api/upvotes/spaces/{spaceId}/similar?title=` | Fino a 5 argomenti simili | Chi legge |
| `GET` · `PATCH` · `DELETE /api/upvotes/topics/{id}` | Dettaglio · modifica · elimina | Chi legge · autore (fino a un altro voto) o team |
| `PUT` · `DELETE /api/upvotes/topics/{id}/vote` | Vota · ritira il voto | Chi apre lo spazio |
| `GET /api/upvotes/topics/{id}/voters` | Chi ha votato | Team |
| `GET` · `POST /api/upvotes/topics/{id}/comments` · `DELETE /api/upvotes/comments/{id}` | Commenti | Chi legge · chi apre lo spazio · autore o team |
| `POST /api/upvotes/topics/{id}/status` · `…/reopen` · `…/merge` | Cambia lo stato (`status`, `note`) · riapre · unisce (`targetId`) | Team |

Errori: `400` (archiviare senza motivo, testo vuoto o troppo lungo), `403` (senza permesso), `404` (argomento di un'altra bacheca o community), `409` (votare su Fatto, Archiviato o in attesa; commentare su archiviato; riaprire un argomento unito), `429` (5 argomenti al giorno, 120 voti all'ora). La chiave API usa il modulo `upvotes` (vedi [Autenticazione](/api/autenticacao#l-ambito)). Vedi [Upvotes](/api/referencia/upvotes).

## Correlati

- [Sondaggi](/espacos/enquetes)
- [Questionari](/espacos/pesquisas)
- [Moderazione](/membros/moderacao)
- [Moduli](/conceitos/modulos)
- [E-mail di questa community](/notificacoes/emails-desta-comunidade)
- [Strumenti · Contenuti](/mcp/ferramentas-conteudo#upvote)