Product Roadmap
Una hoja de ruta pública donde la gente vota ideas y propone las suyas, con un registro de cambios de lo ya publicado.
Extensión
Product Roadmap
Una hoja de ruta pública donde la gente vota ideas y propone las suyas, con un registro de cambios de lo ya publicado.
Descripción
Una hoja de ruta pública para cualquier sitio EmDash. Los visitantes ven lo que usted está considerando, construyendo y ha publicado. Pueden votar y pueden enviar una idea que espera su aprobación.
Qué obtiene
- Un tablero con etapas que usted nombra. Empiece con Under review, Planned, In progress y Done. Añádalas, ocúltelas, renómbrelas o reordénelas.
- Votación. Un voto por persona y elemento. Haga clic de nuevo para retirarlo.
- Sugerencias con aprobación. Una idea se guarda como borrador. Usted la aprueba para ponerla en el tablero o la rechaza.
- Invitados o miembros. Usted elige quién puede votar y sugerir. Los invitados indican un nombre. Las ideas escritas siempre esperan revisión.
- Un registro de cambios. Una segunda colección con una página de lista y una página por versión.
- Comentarios. La página del elemento usa los comentarios propios de EmDash. Nada más que moderar.
- Fusión. Funda un duplicado en el elemento que conserva. Los votos se trasladan, uno por persona.
Cómo encaja todo
El plugin es el motor: rutas, almacenamiento y las pantallas de administración. Un plugin de EmDash no puede añadir páginas a su sitio, así que las páginas públicas se entregan como un kit de sitio que copia una sola vez. Véase Instalación.
El correo cada hora necesita un proveedor de correo. La tarjeta del panel sigue mostrando cuántas ideas esperan cuando el correo está desactivado.
Instalación
Antes de instalar
1. Su sitio necesita un ejecutor de sandbox. Los plugins del registro se ejecutan en un sandbox. Mientras el sitio no tenga uno, Admin, Plugins muestra «No plugins configured» y no hay Registry en el menú.
- Node: en su sitio, ejecute
npm install @emdash-cms/sandbox-workerd workerdy luego añadasandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",dentro deemdash()enastro.config.mjs. - Cloudflare: añada
import from "@emdash-cms/cloudflare";ysandboxRunner: sandbox(),. Necesita el plan Workers Paid, el enlaceworker_loadersllamadoLOADER(descomente en su configuración de Wrangler) y un bucket R2 comostorage: r2(...), o la instalación se detiene con «Storage error while installing plugin». Luego ejecutenpm run deploy.
Detenga el servidor de desarrollo y vuelva a iniciarlo. Registry aparece ahora en el menú de administración.
2. El plugin es el motor. Las páginas para visitantes provienen de su kit de sitio. Un plugin del registro no puede añadir páginas a su sitio. Hasta que copie el kit, sus direcciones (por ejemplo /roadmap/) muestran la página 404 de su sitio. Es lo esperado. La copia del kit que sigue requiere un solo comando.
3. Necesita Node 22.16 o posterior para el paso npx emdash seed.
Comprobado en EmDash 1.3.1 con la plantilla blog, en Node y en Cloudflare Workers (instalación desde el registro).
Instalar
-
Admin, Registry, busque Product Roadmap, Install y acepte los permisos.
-
Desde la carpeta raíz de su sitio:
kit="$(mktemp -d)" && git clone --depth 1 \ --branch v0.4.0 \ https://github.com/wbcomdesigns/emdash-roadmap \ "$kit/emdash-roadmap" && "$kit/emdash-roadmap/scripts/add-to-site.sh" . -
Nada que pegar. Reinicie el servidor de desarrollo.
-
Añada los enlaces que se muestran en Admin, Menus.
-
Abra Admin, Roadmap, Ideas.
Tras cada actualización, ejecute el paso 2 con la nueva etiqueta. Guía completa: https://github.com/wbcomdesigns/emdash-roadmap/blob/v0.4.0/docs/website/getting-started/install.md
Preguntas frecuentes
¿Por qué /roadmap/ da un 404 tras la instalación?
El plugin no puede crear páginas. Ejecute el comando del kit desde la pestaña Installation (o desde Admin, Roadmap, Ideas) con la etiqueta de la versión que instaló y luego reinicie el servidor de desarrollo.
El tablero dice que no se pudo cargar. Vuelva a copiar el kit desde la etiqueta de la versión que instaló. El kit y el plugin se publican juntos.
¿Pueden los invitados votar y sugerir ideas?
Sí, cuando Settings está en Anyone (predeterminado) y el host da a EmDash la dirección del visitante: Cloudflare, o trustedProxyHeaders en la configuración del sitio. En caso contrario, los invitados ven un enlace de inicio de sesión y Settings lo indica. Cada idea espera su aprobación.
Un invitado ve un 401 en la consola del navegador. Es lo esperado: la página comprueba primero los votos de un miembro con sesión iniciada. La página funciona bien.
¿Cómo muevo un elemento a otra etapa? En la pantalla de edición del elemento, use el panel Stage de la derecha.
¿Las ideas nuevas salen en vivo de inmediato? No. Una sugerencia se guarda como borrador. Apruébela en Ideas para ponerla en el tablero.
¿Qué pasa si renombro una etapa? El tablero usa el nuevo nombre. Los elementos permanecen en esa columna. No necesita editar cada elemento.
¿Funciona en modo oscuro? Sí. Los colores del kit siguen el tema de su sitio.
¿Envía correo electrónico? Un breve aviso por hora cuando hay ideas esperando, si el sitio tiene un proveedor de correo. El aviso no incluye texto de la idea ni enlace. La tarjeta del panel siempre muestra el recuento.
¿Hay una versión de pago? No. Todo lo que hay aquí es gratis.
Registro de cambios
0.4.0
Cada página, voto y pantalla de administración se mantiene ahora dentro del límite de Cloudflare de 10 solicitudes por llamada de plugin en un sitio de pruebas muy cargado. Cloudflare sigue marcado como no compatible hasta que se compruebe allí. Sin nuevos permisos.
- Novedad: cada elemento conserva un recuento acumulado de votos; los recuentos de la 0.3.0 se reconstruyen al cargar la página Ideas y cada hora.
- Mejora: la fusión, el borrado de votos de Roadmap y la limpieza horaria se ejecutan por pasos.
- Corrección: en Cloudflare, un voto de invitado se rechazaba con «not on the board».
- Corrección: el script del kit ya no afirma que los tipos de contenido se crearon en un sitio Cloudflare.
Vuelva a copiar el kit después de actualizar. Hasta entonces, un tablero filtrado por categoría muestra todos los elementos y Take back all my votes se detiene con un error tras 7.
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.4.0 \
https://github.com/wbcomdesigns/emdash-roadmap \
"$kit/emdash-roadmap" &&
"$kit/emdash-roadmap/scripts/add-to-site.sh" .
0.3.0
Nuevo permiso: Read retained content revision history, para que el panel Stage pueda ver y mover un elemento mientras tiene cambios sin publicar. Lo aprueba una vez al actualizar. Los invitados necesitan una dirección de visitante para votar. Vuelva a copiar el kit después de actualizar:
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.3.0 \
https://github.com/wbcomdesigns/emdash-roadmap \
"$kit/emdash-roadmap" &&
"$kit/emdash-roadmap/scripts/add-to-site.sh" .
- Novedad: tarjeta Set up visitor pages; scripts/add-to-site.sh copia todo el kit.
- Mejora: el panel Stage es el único lugar para establecer la etapa.
- Corrección: recuentos de Ideas, formulario anidado, alineación, modo oscuro.
- Seguridad: sin escrituras de invitados sin una dirección de visitante; un invitado por IPv4 o IPv6 /64; hashes borrados tras 30 días.
0.2.1
- Corrección: el archivo My votes ya no tiene el mismo nombre que el de WB Polls, de modo que ambos kits pueden convivir en un mismo sitio. Vuelva a copiar el kit después de actualizar.
Versiones anteriores: https://github.com/wbcomdesigns/emdash-roadmap/blob/main/CHANGELOG.md