Product Roadmap

Um roadmap público onde as pessoas votam em ideias e sugerem as suas, com um registo de alterações do que foi publicado.

Extensão

Product Roadmap

Um roadmap público onde as pessoas votam em ideias e sugerem as suas, com um registo de alterações do que foi publicado.

  • Categoria: roadmap
  • Estado: Disponível
  • Versão: 0.4.0
  • Preço: Desconhecido
  • Origem: Registro oficial de plugins
  • Instalação: Plugin sandbox do registro
  • Verificado: 2026-10-21

Descrição

Um roadmap público para qualquer site EmDash. Os visitantes veem o que está a considerar, a construir e o que já publicou. Podem votar e podem enviar uma ideia que aguarda a sua aprovação.

O que obtém

  • Um quadro com fases que você nomeia. Comece com Under review, Planned, In progress e Done. Adicione-as, oculte-as, renomeie-as ou reordene-as.
  • Votação. Um voto por pessoa por item. Clique de novo para o retirar.
  • Sugestões com aprovação. Uma ideia é guardada como rascunho. Você aprova-a para o quadro ou rejeita-a.
  • Convidados ou membros. Você escolhe quem pode votar e sugerir. Os convidados indicam um nome. As ideias escritas aguardam sempre revisão.
  • Um registo de alterações. Uma segunda coleção com uma página de lista e uma página por versão.
  • Comentários. A página do item usa os comentários próprios do EmDash. Nada mais para moderar.
  • Fusão. Funda um duplicado no item que mantém. Os votos passam para ele, um por pessoa.

Como tudo se encaixa

O plugin é o motor: rotas, armazenamento e os ecrãs de administração. Um plugin do EmDash não pode acrescentar páginas ao seu site, pelo que as páginas públicas seguem como um kit de site que copia uma só vez. Veja Instalação.

O e-mail de hora a hora precisa de um fornecedor de correio. O cartão do painel continua a mostrar quantas ideias estão à espera quando o correio está desativado.

Instalação

Antes de instalar

1. O seu site precisa de um executor de sandbox. Os plugins do registo correm numa sandbox. Enquanto o site não tiver um, Admin, Plugins mostra «No plugins configured» e não há Registry no menu.

  • Node: no seu site, execute npm install @emdash-cms/sandbox-workerd workerd e depois acrescente sandboxRunner: "@emdash-cms/sandbox-workerd/sandbox", dentro de emdash() em astro.config.mjs.
  • Cloudflare: acrescente import from "@emdash-cms/cloudflare"; e sandboxRunner: sandbox(),. Precisa do plano Workers Paid, da ligação worker_loaders chamada LOADER (descomente-a na sua configuração do Wrangler) e de um bucket R2 como storage: r2(...), ou a instalação pára com «Storage error while installing plugin». Depois execute npm run deploy.

Pare o servidor de desenvolvimento e volte a iniciá-lo. Registry aparece agora no menu de administração.

2. O plugin é o motor. As páginas dos visitantes vêm do seu kit de site. Um plugin do registo não pode acrescentar páginas ao seu site. Até copiar o kit, os seus endereços (por exemplo /roadmap/) mostram a página 404 do seu site. É o esperado. A cópia do kit abaixo demora um único comando.

3. Precisa do Node 22.16 ou posterior para o passo npx emdash seed.

Verificado no EmDash 1.3.1 com o modelo blog, em Node e no Cloudflare Workers (instalação a partir do registo).

Instalar

  1. Admin, Registry, pesquise Product Roadmap, Install e aceite as permissões.

  2. A partir da pasta raiz do seu site:

    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" .
  3. Nada para colar. Reinicie o servidor de desenvolvimento.

  4. Adicione as ligações apresentadas em Admin, Menus.

  5. Abra Admin, Roadmap, Ideas.

Após cada atualização, execute o passo 2 com a nova etiqueta. Guia completo: https://github.com/wbcomdesigns/emdash-roadmap/blob/v0.4.0/docs/website/getting-started/install.md

Perguntas frequentes

Porque é que /roadmap/ dá um 404 após a instalação? O plugin não pode criar páginas. Execute o comando do kit a partir do separador Installation (ou de Admin, Roadmap, Ideas) com a etiqueta da versão que instalou e depois reinicie o servidor de desenvolvimento.

O quadro diz que não foi possível carregá-lo. Volte a copiar o kit a partir da etiqueta da versão que instalou. O kit e o plugin são publicados em conjunto.

Os convidados podem votar e sugerir ideias? Sim, quando Settings está em Anyone (predefinição) e o anfitrião dá ao EmDash o endereço do visitante: Cloudflare, ou trustedProxyHeaders na configuração do site. Caso contrário, os convidados veem uma ligação de início de sessão e Settings di-lo. Cada ideia aguarda a sua aprovação.

Um convidado vê um 401 na consola do navegador. É o esperado: a página verifica primeiro os votos de um membro com sessão iniciada. A página está bem.

Como movo um item para outra fase? No ecrã de edição do item, use o painel Stage à direita.

As novas ideias ficam em direto de imediato? Não. Uma sugestão é guardada como rascunho. Aprove-a em Ideas para a pôr no quadro.

O que acontece se renomear uma fase? O quadro usa o novo nome. Os itens ficam nessa coluna. Não precisa de editar cada item.

Funciona no modo escuro? Sim. As cores do kit seguem o tema do seu site.

Envia e-mail? Um breve aviso por hora quando há ideias à espera, se o site tiver um fornecedor de correio. O aviso não inclui texto da ideia nem ligação. O cartão do painel mostra sempre a contagem.

Existe uma versão paga? Não. Tudo o que está aqui é gratuito.

Registo de alterações

0.4.0

Cada página, voto e ecrã de administração mantém-se agora dentro do limite do Cloudflare de 10 pedidos por chamada de plugin num site de teste muito carregado. O Cloudflare continua assinalado como não suportado até ser verificado aí. Sem novas permissões.

  • Novo: cada item guarda uma contagem acumulada de votos; as contagens da 0.3.0 são reconstruídas ao carregar a página Ideas e de hora a hora.
  • Melhoria: a fusão, o apagamento dos votos do Roadmap e a limpeza horária correm por passos.
  • Correção: no Cloudflare, um voto de convidado era recusado com «not on the board».
  • Correção: o script do kit já não afirma que os tipos de conteúdo foram criados num site Cloudflare.

Volte a copiar o kit depois de atualizar. Até lá, um quadro filtrado por categoria mostra todos os itens e Take back all my votes pára com um erro após 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

Nova permissão: Read retained content revision history, para que o painel Stage possa ver e mover um item enquanto tem alterações por publicar. Aprova-a uma vez ao atualizar. Os convidados precisam de um endereço de visitante para votar. Volte a copiar o kit depois de atualizar:

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" .
  • Novo: cartão Set up visitor pages; scripts/add-to-site.sh copia todo o kit.
  • Melhoria: o painel Stage é o único local para definir a fase.
  • Correção: contagens de Ideas, formulário aninhado, alinhamento, modo escuro.
  • Segurança: sem escritas de convidados sem um endereço de visitante; um convidado por IPv4 ou IPv6 /64; hashes apagados após 30 dias.

0.2.1

  • Correção: o ficheiro My votes já não tem o mesmo nome que o do WB Polls, pelo que ambos os kits podem coexistir num mesmo site. Volte a copiar o kit depois de atualizar.

Versões anteriores: https://github.com/wbcomdesigns/emdash-roadmap/blob/main/CHANGELOG.md