# Upvote

> Das Bereichsmodul Upvote im Tab Community. Ein Board, auf dem Mitglieder Themen vorschlagen, abstimmen (eine Stimme pro Person, zurücknehmbar) und kommentieren, und das Team freigibt, den Status ändert, Duplikate zusammenführt, mit Grund archiviert und wieder öffnet. Sortierung, Filter, Spalten, öffentliches Lesen, Limits, E-Mail-Hinweise und dieselben Aktionen über den Assistenten und die API.

**Upvote** ist ein Board, auf dem Mitglieder sagen, was sie wollen: Jede Person schlägt **Themen** vor (eine Idee, einen Wunsch, eine Verbesserung), alle stimmen für die, die sie unterstützen, und die mit den meisten Stimmen steigen nach oben. Das Team antwortet, indem es den Status jedes Themas ändert (**Geplant**, **In Arbeit**, **Erledigt** oder **Archiviert**, mit Grund), und wer abgestimmt hat, wird benachrichtigt.

Es ist ein [Bereichsmodul](/conceitos/modulos) im Tab **Community** von **Bereich Hinzufügen**. **Ein Bereich ist ein Board**: Für getrennte Boards (Produkt, Events, Inhalte) legst du mehrere Bereiche an. Wer den Bereich anlegt: Eigentümer oder Administrator.

## Upvote, Umfrage oder Befragung?

| | [Umfrage](/espacos/enquetes) | [Befragung](/espacos/pesquisas) | **Upvote** |
|---|---|---|---|
| Wer fragt | Das Team | Das Team | **Die Mitglieder** schlagen vor |
| Optionen | Fest, vom Team geschrieben | Fragebogen in Abschnitten | Offene Liste, die täglich wächst |
| Wo sie lebt | In einem Beitrag im Feed oder in Inhalten | Eigener Bereich und öffentlicher Link | Eigener Bereich |
| Stimme | Option wählen; nur das Team sieht, wer was gewählt hat | Namentliche oder anonyme Antwort | Eine Stimme pro Thema, für beliebig viele Themen; zurücknehmbar |
| Ende | Endet zu einer Frist | Zeitraum, mit Ergebnis und NPS | Endet nie; jedes Thema hat sein eigenes Ergebnis |
| Wofür | Jetzt zwischen wenigen Optionen entscheiden | Zufriedenheit und Klima messen | Herausfinden, was die Community will, und zeigen, was daraus wurde |

**Faustregel:** Das Team will wissen, ob A, B oder C → Umfrage; will messen → Befragung; will, dass die Mitglieder sagen, was sie wollen, und zeigen, was es daraus gemacht hat → Upvote.

## Wer was darf

| Aktion | Wer |
|---|---|
| Das Board, die Themen und die Kommentare lesen | Wer den Bereich öffnet; in einem **öffentlichen** Bereich auch Besucher ohne Anmeldung |
| Abstimmen, die Stimme zurücknehmen und kommentieren | Wer den Bereich öffnet, angemeldet |
| Ein Thema vorschlagen | Wen **Wer posten darf** des Bereichs zulässt |
| Das eigene Thema bearbeiten und löschen | Wer es vorgeschlagen hat, bis eine andere Person dafür stimmt |
| Freigeben, bearbeiten, Status ändern, zusammenführen, archivieren, wieder öffnen, sehen, wer abgestimmt hat, und löschen | Das **Team**: Eigentümer, Administrator und Moderator. Finanzen gehört nicht dazu |
| Die Vorabfreigabe einschalten | Eigentümer und Administrator |

## So funktioniert es

### Das Board

Jedes Thema erscheint als Karte mit dem **Abstimmungsbutton links** (Pfeil und Zahl, ausgefüllt, wenn du abgestimmt hast), dem Titel, einem Auszug der Beschreibung, der vorschlagenden Person, den Kommentaren und dem Status-Abzeichen.

- **Sortieren nach:** **Meiste Stimmen** (Standard; bei Gleichstand das neueste), **Neueste** und **Im Trend** (die meisten Stimmen der letzten 7 Tage, stündlich aktualisiert).
- **Filter:** **Alle** (alle außer archivierten), **Offen**, **Geplant**, **In Arbeit**, **Erledigt**, **Archiviert**, **Meine Themen** und **Abgestimmt**.
- **Ansicht:** **Liste** oder **Spalten** (Offen, Geplant, In Arbeit und Erledigt, jeweils nach Stimmen). Am Handy werden die Spalten zu Tabs nach Status, einer nach dem anderen.

Die Liste bekommt eine einzige Zeile mit den Status und kompakten Menüs, **Sortieren** und **Filter** (einschließlich **Alle Themen**), und die Spalten wiederholen den Status nicht mehr auf jeder Karte. Im Thema behält die Leiste **Bearbeiten** und **Status ändern**, der Rest wandert unter **Weitere Aktionen**.

### Die Stimme

Jede Person hat **eine Stimme pro Thema** und stimmt für beliebig viele Themen. Ein erneuter Klick nimmt die Stimme zurück. Wer ein Thema vorschlägt, stimmt bereits dafür (und kann die Stimme zurücknehmen).

Alle sehen die Zahl; **wer abgestimmt hat, sieht nur das Team**, unter **Wer abgestimmt hat**, mit dem Datum, an dem jede Person der Community beigetreten ist (das hilft, doppelte Konten zu erkennen).

Abstimmen und die Stimme zurücknehmen geht nur bei Themen in **Offen**, **Geplant** oder **In Arbeit**. In **Erledigt** und **Archiviert** ist die Abstimmung eingefroren: weder abstimmen noch die Stimme zurücknehmen.

### Die Status

| Status | Was er bedeutet | Stimme | Kommentar |
|---|---|---|---|
| **Offen** | Nimmt Stimmen an | Ja | Ja |
| **Geplant** | Das Team wird es umsetzen | Ja | Ja |
| **In Arbeit** | Das Team setzt es gerade um | Ja | Ja |
| **Erledigt** | Fertig | Eingefroren | Ja |
| **Archiviert** | Wird nicht umgesetzt, mit für alle sichtbarem Grund | Eingefroren | Nein |

Nur das Team ändert den Status. Jede Änderung nimmt eine **Notiz für alle, die abgestimmt haben** an (*„kommt mit dem März-Release"*); Archivieren verlangt den **Grund**. **Wieder öffnen** setzt ein erledigtes oder archiviertes Thema zurück auf Offen. Die Stimmen bleiben immer.

### Gibt es schon etwas Ähnliches?

Beim Vorschlagen erscheinen ab dem dritten Wort des Titels bis zu 5 Themen desselben Boards mit gemeinsamen Wörtern unter **Gibt es schon etwas Ähnliches?**. Ist eines davon das, was du willst, gibt **Dafür stimmen** ihm deine Stimme, statt ein neues anzulegen.

### Duplikate zusammenführen

Wenn zwei Themen dasselbe wollen, nutzt das Team beim doppelten **Zusammenführen mit…** und wählt das Original, das Offen, Geplant oder In Arbeit sein muss, im selben Board. Das doppelte wird als *„Duplikat von <Titel>"* archiviert, mit Link; die Stimmen gehen an das Original, **ohne doppelt zu zählen**, wer bei beiden abgestimmt hat; die Kommentare bleiben beim doppelten. **Ein zusammengeführtes Thema lässt sich nicht wieder öffnen.**

### Kommentare

Wer den Bereich öffnet, kommentiert und antwortet (eine Antwortebene), bis zu 2.000 Zeichen. Wer den Kommentar geschrieben hat und das Team löschen ihn; mit einem Kommentar verschwinden seine Antworten. Ein archiviertes Thema nimmt keine Kommentare mehr an.

### Vorabfreigabe

Mit eingeschalteter **Vorabfreigabe** erscheinen die Themen der Mitglieder erst nach der Freigabe durch das Team auf dem Board. Bis dahin ist das Thema **Wartet auf Freigabe**, nur für die vorschlagende Person (unter **Meine Themen**) und das Team sichtbar, und nimmt weder Stimmen noch Kommentare an. Bearbeitet die vorschlagende Person den Text eines bereits freigegebenen Themas, geht es zurück in die Freigabe. Themen des Teams erscheinen sofort.

Das Team sieht die Leiste **Board verwalten** mit der Zahl der wartenden Themen und dem Button **Freigabe-Warteschlange**, der die wartenden mit **Freigeben** und **Ablehnen** auflistet (ein abgelehntes bleibt nur für die vorschlagende Person und das Team sichtbar). Die wartenden erscheinen auch in der [Moderation](/membros/moderacao).

### Öffentliches Lesen

In einem Bereich mit der Sichtbarkeit **Öffentlich** lesen Besucher ohne Anmeldung alles (das Board, die Themen, die Zahl, die Status und die Kommentare), außer wer abgestimmt hat. Abstimmen, kommentieren oder vorschlagen öffnet *„Melde dich an, um für das zu stimmen, was du unterstützt"* (oder *„Melde dich an, um zu kommentieren"*, *„Melde dich an, um ein Thema vorzuschlagen"*), mit **Anmelden** und **Konto erstellen**; danach kommt die Person zum Board zurück. In einem nicht öffentlichen Bereich liest nur, wer den Bereich öffnet.

### Limits

| Limit | Wert |
|---|---|
| Neue Themen | 5 pro Person und Tag (das Team hat kein Limit; wartende und gelöschte zählen mit) |
| Stimmen | 120 pro Person und Stunde |
| Titel | 140 Zeichen |
| Beschreibung | 5.000 Zeichen |
| Fotos | Bis zu 4 pro Thema (JPG, PNG oder WebP) |
| Notiz oder Grund | 500 Zeichen |

### E-Mail-Hinweise

| Wer sie bekommt | Wann |
|---|---|
| Die vorschlagende Person und wer abgestimmt hat | Das Thema wechselt zu **Geplant**, **In Arbeit**, **Erledigt** oder **Archiviert** (mit Notiz oder Grund), wird **wieder geöffnet** oder mit einem anderen **zusammengeführt** |
| Das Team | Ein neues Thema wird vorgeschlagen |

Mitglieder bekommen **keine** E-Mail für jedes neue Thema. Die Hinweise kommen auch in die Glocke. Sie gehen nur an Personen, die im Moment des Hinweises **noch Zugang zum Bereich** haben. Abschalten lässt sich das über die Kategorie **Upvote: Themen, die du unterstützt** in [E-Mails dieser Community](/notificacoes/emails-desta-comunidade) oder über den Link in der Fußzeile.

## Schritt für Schritt

### Ein Board anlegen

*Rolle: Eigentümer oder Administrator.*

1. Öffne im Menü unter **Bereich Hinzufügen** den Tab **Community** und wähle **Upvote**.
2. Gib Namen, Beschreibung, Sichtbarkeit (**Öffentlich** lässt alle lesen) und **Wer posten darf** an. Schalte **Vorabfreigabe** ein, wenn du jedes Thema freigeben willst.
3. Anlegen. Später schaltet **Einstellungen** in der Leiste **Board verwalten** die Vorabfreigabe ein und aus.

### Ein Thema vorschlagen

1. Klicke auf dem Board auf **Neues Thema** (am Handy in der Fußleiste: *„Eine Idee? Schlag sie vor."*).
2. Schreibe den **Titel** und prüfe **Gibt es schon etwas Ähnliches?**: Ist ein Thema das, was du willst, **Dafür stimmen**.
3. Schreibe die **Beschreibung** und, wenn du willst, **Fotos hinzufügen** (bis zu 4).
4. Klicke auf **Thema veröffentlichen**.

### Ein Thema verwalten

*Rolle: Eigentümer, Administrator oder Moderator.*

Öffne das Thema. Die Leiste **Thema verwalten** zeigt die Stimmen, den Status und die Aktionen:

- **Freigeben**: wenn das Thema auf Freigabe wartet.
- **Bearbeiten**: Titel, Beschreibung und Fotos.
- **Status ändern**: Wähle den Status und, wenn du willst, die Notiz für alle, die abgestimmt haben. **Status speichern** benachrichtigt die vorschlagende Person und alle, die abgestimmt haben.
- **Zusammenführen mit…**: Wähle das Original-Thema und bestätige.
- **Archivieren**: mit Grund, Pflicht.
- **Wieder öffnen**: von Erledigt oder Archiviert zurück auf Offen.
- **Wer abgestimmt hat**: die Liste, mit dem Beitrittsdatum jeder Person.
- **Löschen**: Das Thema verschwindet mit Stimmen, Kommentaren und Fotos vom Board. Ist die Idee noch wertvoll, bewahrt Archivieren mit Grund den Verlauf.

## Beispiele

**Vorschlagsboard einer Online-Schule.** **Öffentlicher** Bereich „Was willst du lernen", **Wer posten darf = Alle**. Die Teilnehmenden schlagen Kurse vor; *„Excel für Fortgeschrittene"* erreicht 80 Stimmen, das Team setzt es mit der Notiz *„Aufnahme im November"* auf **Geplant**, und die 80 bekommen den Hinweis.

**Verbesserungen in einem Coworking.** Bereich für Mitglieder mit **Vorabfreigabe**. Ein Mitglied schlägt *„Mehr Steckdosen in Raum 2"* vor; das Team gibt frei, das Thema sammelt Stimmen, wird **In Arbeit** und dann **Erledigt**. Ein zweiter, gleicher Wunsch wird mit dem ersten zusammengeführt und bringt seine Stimmen mit.

## Häufige Fehler und ihre Lösung

| Situation | Was tun |
|---|---|
| **Neues Thema** erscheint nicht | **Wer posten darf** des Bereichs schließt deine Rolle nicht ein |
| Abstimmen geht nicht | Das Thema ist Erledigt, Archiviert oder wartet auf Freigabe; oder du bist nicht angemeldet (Besucher) |
| Das eigene Thema lässt sich nicht bearbeiten | Eine andere Person hat schon dafür gestimmt; jetzt bearbeitet nur das Team |
| Kommentieren geht nicht | Das Thema ist archiviert oder wartet auf Freigabe |
| Limit von 5 Themen pro Tag | Warte, bis seit dem ersten Thema 24 Stunden vergangen sind |
| Wieder öffnen geht nicht | Das Thema wurde mit einem anderen zusammengeführt: Die Stimmen sind schon dort |
| Archivieren speichert nicht | Gib den Grund an, Pflicht |

## Häufige Fragen

**Wissen die Mitglieder, wofür ich gestimmt habe?**
Nein. Nur das Team sieht, wer abgestimmt hat.

**Verliert jemand, der die Community verlässt, seine Stimme?**
Nein. Die Stimmen bleiben in der Zählung; die Hinweise hören auf, weil die Person keinen Zugang mehr hat.

**Kann man ohne Konto abstimmen?**
Nein. Auf einem öffentlichen Board lesen Besucher; zum Abstimmen melden sie sich an oder erstellen ein Konto.

## Über den Assistenten

Der Assistent schlägt Themen vor, stimmt ab und verwaltet Themen mit denselben Regeln wie die Person, die ihn verbunden hat. Siehe [Werkzeuge · Inhalte](/mcp/ferramentas-conteudo#upvote).

- **Lesen:** `get_upvote_board`, `list_upvote_topics` (mit Sortierung und Status), `get_upvote_topic` und `find_similar_upvote_topics`.
- **Für alle, die den Bereich öffnen:** `vote_upvote_topic`, `unvote_upvote_topic` und `create_upvote_comment` ohne Bestätigung; `create_upvote_topic` mit Bestätigung; `update_upvote_topic` und `delete_upvote_topic` (mit Bestätigung), die vorschlagende Person, bis jemand anderes abstimmt.
- **Team:** `set_upvote_topic_status` (inklusive Archivieren), `reopen_upvote_topic` und `merge_upvote_topics`, alle mit Bestätigung, die den Grund und die Zahl der Benachrichtigten zeigt; `merge_upvote_topics` lässt sich nicht rückgängig machen. `list_upvote_voters`, nur lesend.
- **Eigentümer und Administrator:** `update_upvote_board`, das die Vorabfreigabe ein- oder ausschaltet.

Frag so: *„Prüfe, ob es schon ein Thema ähnlich wie ‚Dark Mode in der App' gibt, bevor du eines anlegst; wenn ja, stimm dafür."* Siehe das [Rezept](/mcp/receitas#91-prufen-ob-es-schon-ein-ahnliches-thema-gibt).

## In der API

Die Routen liegen unter `/api/upvotes`, mit `X-CommunityId`; der Pfad enthält die Community nicht. Lesende Routen funktionieren in einem öffentlichen Bereich auch ohne Anmeldung.

| Route | Was sie tut | Wer |
|---|---|---|
| `GET /api/upvotes/spaces/{spaceId}` | Das Board: ob die Person vorschlagen und verwalten darf, und die Limits | Wer liest |
| `PUT /api/upvotes/spaces/{spaceId}` | Schaltet `requireApproval` ein oder aus | Eigentümer und Administrator |
| `GET` · `POST /api/upvotes/spaces/{spaceId}/topics` | Liste (`sort` = `top`, `new` oder `trending`; `status`; `mine`; `voted`; `cursor`) · schlägt vor | Wer liest · wer posten darf |
| `GET /api/upvotes/spaces/{spaceId}/similar?title=` | Bis zu 5 ähnliche Themen | Wer liest |
| `GET` · `PATCH` · `DELETE /api/upvotes/topics/{id}` | Detail · bearbeitet · löscht | Wer liest · vorschlagende Person (bis zu einer anderen Stimme) oder Team |
| `PUT` · `DELETE /api/upvotes/topics/{id}/vote` | Stimmt ab · nimmt die Stimme zurück | Wer den Bereich öffnet |
| `GET /api/upvotes/topics/{id}/voters` | Wer abgestimmt hat | Team |
| `GET` · `POST /api/upvotes/topics/{id}/comments` · `DELETE /api/upvotes/comments/{id}` | Kommentare | Wer liest · wer den Bereich öffnet · Verfasser oder Team |
| `POST /api/upvotes/topics/{id}/status` · `…/reopen` · `…/merge` | Ändert den Status (`status`, `note`) · öffnet wieder · führt zusammen (`targetId`) | Team |

Fehler: `400` (Archivieren ohne Grund, leerer oder zu langer Text), `403` (keine Berechtigung), `404` (Thema aus einem anderen Board oder einer anderen Community), `409` (Abstimmen bei Erledigt, Archiviert oder wartend; Kommentieren bei archiviert; Wiederöffnen eines zusammengeführten Themas), `429` (5 Themen pro Tag, 120 Stimmen pro Stunde). Ein API-Schlüssel nutzt das Modul `upvotes` (siehe [Authentifizierung](/api/autenticacao#der-bereich)). Siehe [Upvotes](/api/referencia/upvotes).

## Verwandte Artikel

- [Umfragen](/espacos/enquetes)
- [Befragungen](/espacos/pesquisas)
- [Moderation](/membros/moderacao)
- [Module](/conceitos/modulos)
- [E-Mails dieser Community](/notificacoes/emails-desta-comunidade)
- [Werkzeuge · Inhalte](/mcp/ferramentas-conteudo#upvote)