# Upvote

> El módulo de espacio Upvote, de la pestaña Comunidad. Un tablero en el que los miembros proponen temas, votan (un voto por persona, que se puede retirar) y comentan, y el equipo aprueba, cambia el estado, une duplicados, archiva con motivo y reabre. Ordenaciones, filtros, columnas, lectura pública, límites, avisos por correo, y las mismas acciones desde el asistente y la API.

El **Upvote** es un tablero en el que los miembros dicen lo que quieren: cada persona propone **temas** (una idea, una petición, una mejora), todos votan los que apoyan, y los más votados suben. El equipo responde cambiando el estado de cada tema (**Planificado**, **En curso**, **Hecho** o **Archivado**, con el motivo), y quien votó recibe el aviso.

Es un [módulo de espacio](/conceitos/modulos) de la pestaña **Comunidad** de **Añadir Espacio**. **Un espacio es un tablero**: para tener tableros separados (producto, eventos, contenido), crea varios espacios. Quién crea el espacio: propietario o administrador.

## ¿Upvote, Votación o Encuesta?

| | [Votación](/espacos/enquetes) | [Encuesta](/espacos/pesquisas) | **Upvote** |
|---|---|---|---|
| Quién pregunta | El equipo | El equipo | **Los miembros** proponen |
| Opciones | Fijas, escritas por el equipo | Cuestionario por secciones | Lista abierta, que crece cada día |
| Dónde vive | En una publicación del Feed o del Contenido | Espacio propio y enlace público | Espacio propio |
| Voto | Se elige opción; solo el equipo ve quién votó qué | Respuesta identificada o anónima | Un voto por tema, en tantos temas como quieras; se puede retirar |
| Fin | Cierra en un plazo | Periodo, con resultado y NPS | Nunca cierra; cada tema tiene su desenlace |
| Para qué | Decidir entre pocas opciones ahora | Medir satisfacción y clima | Descubrir lo que quiere la comunidad y mostrar lo que se hizo |

**La regla práctica:** el equipo quiere saber entre A, B o C → Votación; quiere medir → Encuesta; quiere que los miembros digan lo que quieren y mostrar lo que hizo con ello → Upvote.

## Quién puede hacer qué

| Acción | Quién |
|---|---|
| Leer el tablero, los temas y los comentarios | Quien abre el espacio; en un espacio **público**, también el visitante sin sesión |
| Votar, retirar el voto y comentar | Quien abre el espacio, con sesión iniciada |
| Proponer un tema | Quien permita el **Quién puede publicar** del espacio |
| Editar y borrar el propio tema | El autor, hasta que otra persona lo vote |
| Aprobar, editar, cambiar el estado, unir, archivar, reabrir, ver quién votó y borrar | El **equipo**: propietario, administrador y moderador. Finanzas no entra |
| Activar la aprobación previa | Propietario y administrador |

## Cómo funciona

### El tablero

Cada tema aparece en una tarjeta con el **botón de voto a la izquierda** (la flecha y el número, relleno cuando has votado), el título, un fragmento de la descripción, el autor, los comentarios y la etiqueta del estado.

- **Ordenar por:** **Más votados** (por defecto; en caso de empate, el más nuevo), **Nuevos** y **En alza** (los más votados en los últimos 7 días, actualizado cada hora).
- **Filtros:** **Todos** (todos menos los archivados), **Abiertos**, **Planificados**, **En curso**, **Hechos**, **Archivados**, **Mis temas** y **Voté**.
- **Vista:** **Lista** o **Columnas** (Abierto, Planificado, En curso y Hecho, cada una por los más votados). En el móvil, las columnas pasan a ser pestañas por estado, una cada vez.

La lista gana una sola línea con los estados y menús compactos, **Ordenar** y **Filtro** (incluido **Todos los temas**), y las columnas dejan de repetir el estado en cada tarjeta. En el tema, la barra mantiene **Editar** y **Cambiar estado**, y el resto pasa a **Más acciones**.

### El voto

Cada persona tiene **un voto por tema** y vota en tantos temas como quiera. Pulsar de nuevo retira el voto. Quien propone ya empieza votando su propio tema (y puede retirarlo).

Todos ven el recuento; **quién votó, solo lo ve el equipo**, en **Quién votó**, con la fecha en que cada persona entró en la comunidad (ayuda a detectar cuentas duplicadas).

Votar y retirar el voto solo valen en temas **Abiertos**, **Planificados** o **En curso**. En **Hecho** y **Archivado**, la votación se congela: no se puede votar ni retirar el voto.

### Los estados

| Estado | Qué significa | Voto | Comentario |
|---|---|---|---|
| **Abierto** | Recibiendo votos | Sí | Sí |
| **Planificado** | El equipo lo hará | Sí | Sí |
| **En curso** | El equipo lo está haciendo | Sí | Sí |
| **Hecho** | Listo | Congelado | Sí |
| **Archivado** | No sigue adelante, con el motivo a la vista de todos | Congelado | No |

Solo el equipo cambia el estado. Cada cambio admite una **Nota para quien votó** (*"salió en la versión de marzo"*); archivar exige el **Motivo**. **Reabrir** devuelve un tema Hecho o Archivado a Abierto. Los votos siempre se quedan.

### ¿Ya existe algo parecido?

Al proponer, a partir de la tercera palabra del título aparecen hasta 5 temas del mismo tablero que comparten palabras con él, bajo **¿Ya existe algo parecido?**. Si uno de ellos es lo que quieres, **Votar este** le da tu voto en lugar de crear otro.

### Unir duplicados

Cuando dos temas piden lo mismo, el equipo usa **Unir a…** en el repetido y elige el original, que tiene que estar Abierto, Planificado o En curso, en el mismo tablero. El repetido se archiva como *"Duplicado de <título>"*, con el enlace; los votos pasan al original **sin contar dos veces** a quien votó los dos; los comentarios se quedan en el repetido. **Un tema unido no se reabre.**

### Comentarios

Quien abre el espacio comenta y responde (un nivel de respuesta), hasta 2000 caracteres. El autor del comentario y el equipo lo borran; borrar un comentario se lleva sus respuestas. Un tema archivado ya no recibe comentarios.

### Aprobación previa

Con **Aprobación previa** activada, los temas de los miembros solo aparecen en el tablero después de que el equipo los apruebe. Hasta entonces, el tema queda **Pendiente de aprobación**, visible solo para el autor (en **Mis temas**) y para el equipo, y no recibe votos ni comentarios. Si el autor edita el texto de un tema ya aprobado, vuelve a aprobación. Los temas del equipo entran directamente.

El equipo ve la barra **Gestionar tablero**, con cuántos temas están pendientes y el botón **Cola de aprobación**, que lista los pendientes con **Aprobar** y **Rechazar** (el rechazado queda visible solo para el autor y el equipo). Los pendientes también aparecen en la [moderación](/membros/moderacao).

### Lectura pública

En un espacio con visibilidad **Público**, el visitante sin sesión lo lee todo (el tablero, los temas, el recuento, los estados y los comentarios), menos quién votó. Votar, comentar o proponer abre *"Entra para votar lo que apoyas"* (o *"Entra para comentar"*, *"Entra para proponer un tema"*), con **Entrar** y **Crear cuenta**; después, la persona vuelve al tablero. En un espacio que no es público, solo lee quien abre el espacio.

### Límites

| Límite | Valor |
|---|---|
| Temas nuevos | 5 por persona al día (el equipo no tiene límite; los pendientes y los borrados cuentan) |
| Votos | 120 por persona por hora |
| Título | 140 caracteres |
| Descripción | 5000 caracteres |
| Fotos | Hasta 4 por tema (JPG, PNG o WebP) |
| Nota o motivo | 500 caracteres |

### Avisos por correo

| Quién lo recibe | Cuándo |
|---|---|
| El autor y quien votó | El tema pasa a **Planificado**, **En curso**, **Hecho** o **Archivado** (con la nota o el motivo), se **reabre** o se **une** a otro |
| El equipo | Se propone un tema nuevo |

El miembro **no** recibe un correo por cada tema nuevo. Los avisos también llegan a la campana. Solo los recibe quien **todavía tiene acceso al espacio** en el momento del aviso. Se desactiva en la categoría **Upvote: temas que apoyas**, en [Correos de esta comunidad](/notificacoes/emails-desta-comunidade), o con el enlace del pie.

## Paso a paso

### Crear un tablero

*Rol: propietario o administrador.*

1. En el menú, en **Añadir Espacio**, abre la pestaña **Comunidad** y elige **Upvote**.
2. Pon el nombre, la descripción, la visibilidad (**Público** deja leer a cualquiera) y el **Quién puede publicar**. Activa **Aprobación previa** si quieres aprobar cada tema.
3. Créalo. Después, **Configurar**, en la barra **Gestionar tablero**, activa y desactiva la aprobación previa.

### Proponer un tema

1. En el tablero, pulsa **Nuevo tema** (en el móvil, en el pie: *"¿Tienes una idea? Propónla."*).
2. Escribe el **Título** y revisa **¿Ya existe algo parecido?**: si un tema es lo que quieres, **Votar este**.
3. Escribe la **Descripción** y, si quieres, **Añadir fotos** (hasta 4).
4. Pulsa **Publicar tema**.

### Gestionar un tema

*Rol: propietario, administrador o moderador.*

Abre el tema. La barra **Gestionar tema** muestra los votos, el estado y las acciones:

- **Aprobar**: cuando el tema está pendiente de aprobación.
- **Editar**: título, descripción y fotos.
- **Cambiar estado**: elige el estado y, si quieres, la nota para quien votó. **Guardar estado** avisa al autor y a quien votó.
- **Unir a…**: elige el tema original y confirma.
- **Archivar**: con el motivo, obligatorio.
- **Reabrir**: de Hecho o Archivado a Abierto.
- **Quién votó**: la lista, con la fecha de entrada de cada persona.
- **Borrar**: el tema sale del tablero con los votos, los comentarios y las fotos. Si la idea todavía vale, archivar con un motivo guarda el historial.

## Ejemplos

**Tablero de sugerencias de una escuela online.** Espacio **Público** "Qué quieres aprender", **Quién puede publicar = Cualquiera**. Los alumnos proponen cursos; *"Excel avanzado"* llega a 80 votos, el equipo lo pasa a **Planificado** con la nota *"Lo grabamos en noviembre"*, y los 80 reciben el aviso.

**Mejoras de un coworking.** Espacio para miembros con **Aprobación previa**. Un residente propone *"Más enchufes en la sala 2"*; el equipo lo aprueba, recibe votos, pasa a **En curso** y luego a **Hecho**. Una segunda petición igual se une a la primera y le lleva los votos.

## Errores frecuentes y cómo resolverlos

| Situación | Qué hacer |
|---|---|
| No aparece **Nuevo tema** | El **Quién puede publicar** del espacio no incluye tu rol |
| No se puede votar | El tema está Hecho, Archivado o pendiente de aprobación; o no has entrado (visitante) |
| No se puede editar el propio tema | Otra persona ya lo votó; ahora solo lo edita el equipo |
| No se puede comentar | El tema está archivado o pendiente de aprobación |
| Límite de 5 temas al día | Espera a que pasen 24 horas desde el primer tema |
| No se puede reabrir | El tema se unió a otro: los votos ya están allí |
| Archivar no guarda | Indica el motivo, obligatorio |

## Preguntas frecuentes

**¿Los miembros saben qué he votado?**
No. Solo el equipo ve quién votó.

**¿Quien sale de la comunidad pierde el voto?**
No. Los votos siguen en el recuento; los avisos se paran, porque la persona ya no tiene acceso.

**¿Se puede votar sin cuenta?**
No. En un tablero público, el visitante lee; para votar, entra o crea la cuenta.

## Por el asistente

El asistente propone, vota y gestiona temas con las mismas reglas que quien lo conectó. Ver [Herramientas · Contenido](/mcp/ferramentas-conteudo#upvote).

- **Lectura:** `get_upvote_board`, `list_upvote_topics` (con ordenación y estado), `get_upvote_topic` y `find_similar_upvote_topics`.
- **Para quien abre el espacio:** `vote_upvote_topic`, `unvote_upvote_topic` y `create_upvote_comment`, sin confirmación; `create_upvote_topic` pide confirmación; `update_upvote_topic` y `delete_upvote_topic` (con confirmación), el autor hasta que otra persona vote.
- **Del equipo:** `set_upvote_topic_status` (incluye archivar), `reopen_upvote_topic` y `merge_upvote_topics`, todas con confirmación, mostrando el motivo y a cuántas personas se avisará; `merge_upvote_topics` no tiene vuelta atrás. `list_upvote_voters`, solo lectura.
- **Del propietario y del administrador:** `update_upvote_board`, que activa o desactiva la aprobación previa.

Pídelo así: *"Mira si ya existe un tema parecido a 'modo oscuro en la app' antes de crearlo; si existe, vótalo."* Ver la [receta](/mcp/receitas#91-mira-si-ya-existe-un-tema-parecido-antes-de-crearlo).

## En la API

Las rutas están en `/api/upvotes`, con `X-CommunityId`; la ruta no lleva la comunidad. Las lecturas no necesitan sesión en un espacio público.

| Ruta | Qué hace | Quién |
|---|---|---|
| `GET /api/upvotes/spaces/{spaceId}` | El tablero: si la persona puede proponer y gestionar, y los límites | Quien lee |
| `PUT /api/upvotes/spaces/{spaceId}` | Activa o desactiva `requireApproval` | Propietario y administrador |
| `GET` · `POST /api/upvotes/spaces/{spaceId}/topics` | Lista (`sort` = `top`, `new` o `trending`; `status`; `mine`; `voted`; `cursor`) · propone | Quien lee · quien puede publicar |
| `GET /api/upvotes/spaces/{spaceId}/similar?title=` | Hasta 5 temas parecidos | Quien lee |
| `GET` · `PATCH` · `DELETE /api/upvotes/topics/{id}` | Detalle · edita · borra | Quien lee · autor (hasta otro voto) o equipo |
| `PUT` · `DELETE /api/upvotes/topics/{id}/vote` | Vota · retira el voto | Quien abre el espacio |
| `GET /api/upvotes/topics/{id}/voters` | Quién votó | Equipo |
| `GET` · `POST /api/upvotes/topics/{id}/comments` · `DELETE /api/upvotes/comments/{id}` | Comentarios | Quien lee · quien abre el espacio · autor o equipo |
| `POST /api/upvotes/topics/{id}/status` · `…/reopen` · `…/merge` | Cambia el estado (`status`, `note`) · reabre · une (`targetId`) | Equipo |

Errores: `400` (archivar sin motivo, texto vacío o demasiado largo), `403` (sin permiso), `404` (tema de otro tablero o comunidad), `409` (votar en Hecho, Archivado o pendiente; comentar en archivado; reabrir un tema unido), `429` (5 temas al día, 120 votos por hora). La clave de API usa el módulo `upvotes` (ver [Autenticación](/api/autenticacao#el-alcance)). Ver [Upvotes](/api/referencia/upvotes).

## Relacionados

- [Votaciones](/espacos/enquetes)
- [Encuestas](/espacos/pesquisas)
- [Moderación](/membros/moderacao)
- [Módulos](/conceitos/modulos)
- [Correos de esta comunidad](/notificacoes/emails-desta-comunidade)
- [Herramientas · Contenido](/mcp/ferramentas-conteudo#upvote)