Fluxo de trabalho do Discourse

:information_source: Resumo Um sistema de fluxo de trabalho para Tópicos que implementa um processo configurável de várias etapas
:hammer_and_wrench: Link do Repositório https://github.com/merefield/discourse-workflow
:open_book: Guia de Instalação Como instalar plugins no Discourse

Gostando deste plugin? Por favor, :star: no GitHub ! :pray:

Resumo

Um plugin que fornece uma estrutura de fluxo de trabalho segura para Tópicos que são passados por um conjunto personalizável de etapas até que o fluxo de trabalho seja concluído. Algumas ramificações e loops são suportados.

Use-o para um fluxo de trabalho de negócios que você tenha, como um processo de aprovação ou resposta a problemas.

Funcionalidades

Uma ferramenta de fluxo de trabalho para Discourse!

  • Fluxo de trabalho baseado em Tópicos
  • Utiliza a segurança existente da plataforma, Categorias, Usuários e Grupos.
  • Novas telas de Administrador para criar novos Fluxos de Trabalho, Etapas e Opções de Etapa.
  • Nova lista de Descoberta de Fluxo de Trabalho que lista todos os Tópicos de Fluxo de Trabalho aos quais você tem acesso
  • Banner de Tópico para Tópicos de Fluxo de Trabalho que informa:
    • fluxo de trabalho atual
    • etapa atual do fluxo de trabalho
    • Botões de Ação se você faz parte do grupo com acesso para selecionar uma Opção que determina como o Tópico progride através do fluxo de trabalho
    • link para uma visualização (veja acima).
  • Visualização do fluxo de trabalho que pode ser iniciada a partir de:
    • Banner do Tópico
    • Lista de Descoberta
  • Pequenas ações de postagem de Tópico para transições de Fluxo de Trabalho para mostrar a trilha de auditoria.
  • Notificações para quando Tópicos chegam a uma etapa (ou seja, Categoria) que você está Observando (Primeira Postagem)
  • Suporte ao Explorador de Dados
    • Relatório de Log de Auditoria
    • Contagens diárias de Instâncias de Fluxo de Trabalho/Etapas para que você possa criar gráficos de burndown/burnup.
  • IA pode ser aproveitada para executar automaticamente Etapas do Fluxo de Trabalho.

NB Esta é uma versão inicial e o conjunto de recursos provavelmente evoluirá. Estou aberto a interesse comercial para financiar novos recursos e integrações.

Conceitos introdutórios

Para alavancar a plataforma Discourse como está, o máximo possível, criei uma estrutura simples que usa muitos recursos existentes da plataforma.

Raia (Swim Lanes)

Cada raia de fluxo de trabalho é uma Categoria (ou Subcategoria).

À medida que uma instância de um fluxo de trabalho continua em sua jornada, ela se move entre Categorias em uma jornada personalizável, mas predefinida.

Instâncias de Fluxo de Trabalho

Uma única instância de um fluxo de trabalho (por exemplo, um ticket) é um Tópico. Você pode adicionar tags a um Tópico para destacar sua prioridade ou outros metadados. Você não pode alterar sua Categoria depois que ela iniciou sua jornada, a não ser tomando ações de fluxo de trabalho sobre o Tópico (a menos que você seja da equipe).

Atores

Qualquer Grupo que tenha acesso de criação de Tópicos a uma Categoria pode atuar sobre os tópicos dessa Categoria.

Aqueles que têm acesso de Resposta podem comentar no item do Fluxo de Trabalho, assim como fariam para um Tópico normal.

Você pode ocultar Tópicos dentro de uma Categoria de grupos específicos da maneira normal.

Ações via Opções

Estas são definidas para cada etapa ao configurar o Fluxo de Trabalho. Os Atores podem escolher realizar qualquer ação disponível, pois cada Opção é apresentada como um botão no Tópico.

As ações em um Tópico são capturadas em uma Pequena Ação de Postagem para ajudar os usuários a entender a jornada do Tópico.

Painel

Um novo filtro de Descoberta de Tópicos “Fluxos de Trabalho” na página inicial fornece uma lista de instâncias de Fluxo de Trabalho (tópicos especiais de fluxo de trabalho)

Você deve manter as Categorias de Fluxo de Trabalho e, idealmente, as tags distintas, para que você também possa usá-las para filtrar todas as instâncias de fluxo de trabalho que estão em um estágio particular, ou têm uma tag específica.

Trilha de auditoria

Cada vez que um Tópico transita para uma nova etapa, uma nota documentando isso é adicionada como uma Pequena Ação de Postagem no Tópico.

Uma consulta do Explorador de Dados incluída fornece um relatório básico de auditoria da jornada que uma instância de fluxo de trabalho realizou.

Como as consultas do Explorador de Dados podem ser expostas a usuários além do Administrador, você pode escolher a quem mostrá-las.

Gráficos de Burn-up/Burn-down

Há uma consulta do Explorador de Dados incluída que apresenta os estados do fluxo de trabalho por Fim de Expediente (COB) para que você possa exportar os dados para criar gráficos de burn-up/down em, por exemplo, Excel.

Visualização

Há um botão em cada Tópico de fluxo de trabalho que permite exibir uma visualização de onde o Tópico está em seu fluxo de trabalho.

Isso também é acessível a partir dos campos de fluxo de trabalho no Painel de Descoberta de Fluxo de Trabalho.

Principais diferenças de comportamento em relação ao padrão

  • você não pode criar um novo Tópico em uma Categoria que esteja além da primeira etapa de um fluxo de trabalho
  • você não pode alterar a Categoria de um Tópico que está dentro de um fluxo de trabalho (a menos que você seja da equipe).
  • apenas os “Criadores” de Categoria podem atuar sobre um Tópico em um Fluxo de Trabalho.

Primeiros Passos

O plugin de fluxo de trabalho não vem com um Fluxo de Trabalho, você precisa criar um.

As telas para criar um estão em Administrador → Plugins → Discourse Workflow.

Primeiro crie um novo Fluxo de Trabalho clicando no botão, salve-o, e então preencha-o com Etapas editando o fluxo de trabalho. Cada Etapa, uma vez criada, pode ser editada para adicionar Opções, retiradas de uma lista de Opções predefinidas.

Você pode alterar o rótulo de uma Opção em Administrador → Personalizar → Texto.

Eu popularei o sistema com uma boa variedade de Opções, mas se você quiser alterar o texto de cada uma, vá em frente.

Em cada Categoria de Fluxo de Trabalho, você deve garantir que seus “Atores” estejam configurados como tendo direitos de Criação. Todos os outros devem ter Resposta ou menos.

Seus “Atores” também podem querer Rastrear a Categoria pela qual são responsáveis, selecionando “Observar Primeira Postagem”. Então, quando um novo Tópico de Fluxo de Trabalho chegar, eles serão notificados com um link.

Dicas

  • Considere tornar todas as etapas do fluxo de trabalho para um fluxo de trabalho específico uma Subcategoria dentro de uma única Categoria. Embora isso não seja necessário, permitirá que você simplesmente filtre por essa Categoria usando o menu suspenso de Categoria existente no Discourse na lista de Descoberta para ver todas as instâncias de fluxo de trabalho para esse fluxo de trabalho específico.
  • Na nova lista de Descoberta de Fluxo de Trabalho, você pode clicar no Nome do Fluxo de Trabalho, Posição ou Etapa para visualizar onde essa instância está em seu caminho.
  • Use as ferramentas oficiais existentes para criar modelos estruturados para Tópicos usados no Fluxo de Trabalho:
  • Crie um link na Barra Lateral (ou em qualquer lugar) para criar um novo item de Fluxo de Trabalho e iniciar o fluxo de trabalho: Creating a link to start a new topic with pre-filled information

Ações de IA

Você pode alavancar a IA para lidar com uma etapa. Você precisa de uma chave OpenAI válida adicionada às configurações do Fluxo de Trabalho. Você deve habilitar a IA na etapa. Você também deve escrever um prompt que deve incluir {{options}} para que a IA saiba quais opções ela tem e {{topic}} para incluir o conteúdo.

Exemplo de prompt:

“suas opções são {{options}}. se o texto a seguir afirmar que é delicioso, por favor, aceite, caso contrário, rejeite. {{topic}} responda com uma palavra dessas opções”

Problemas Conhecidos:

Ainda está em fase experimental, então espere problemas, relate-os e eu os listarei aqui até que sejam resolvidos.

25 curtidas

Recebe um pouco de amor.

4 curtidas

Foram implementadas algumas correções:

2 curtidas

Proporciona uma visualização mais prática no celular:

  • MELHORAR: A Lista de Tópicos do Fluxo de Trabalho funciona bem no Desktop, mas no Celular é muito larga, então em vez de adicionar todas aquelas colunas no celular, adicione um selo de Fluxo de Trabalho ao Título e restrinja o conjunto completo de colunas ao Desktop.
2 curtidas

algumas pequenas, mas importantes, alterações.

1 curtida

Olá Robert,

Estou brincando com o plugin de fluxo de trabalho, sem IA. Este é um fluxo de trabalho simples destinado a ser usado como uma cadeia de suporte para um café Linux que ajuda as pessoas a migrar do Windows. Novos tópicos são criados por meio de e-mails RFC 6233 com subendereçamento e entram na primeira subcategoria (nível 1).

Dois problemas:

  1. Os IDs das etapas do fluxo de trabalho não são exclusivos. Tenho três etapas com o mesmo ID. ??
  2. Uma ação “start” no tópico de entrada cria “422 conteúdo não processável”. Talvez isso seja resultado de 1)
3 curtidas

Obrigado pela sua paciência e feedback. Agradeço o seu interesse no plugin.

Ele é um pouco experimental e, como pode ver, ainda não recebeu muito feedback, então haverá problemas iniciais.

Tentarei recriar seu fluxo de trabalho e tentar recriar o problema.

Enquanto isso, você pode tirar um print do fluxo de trabalho na tela de administração e compartilhá-lo?

@Thomas_Rother você tem um backtrace disso?

3 curtidas

Olá Robert,
sem problemas, estou ciente de que isso é experimental. Portanto, está instalado apenas em uma instância de teste auto-hospedada. Você pode se registrar lá e eu poderia lhe dar permissões de administrador:

https://forum2.netzwissen.de/login

2 curtidas

OK, como um passo a passo, veja como eu me saí:

  • Configurar Categoria de Tickets do Internet Cafe
  • Configurar todas as etapas como Subcategorias, resultando nisso:

Até agora, tudo bem.

Agora vamos criar as etapas:

OK, consigo ver pelo menos dois problemas! (Mas um deles provavelmente foi causado pelo outro)

Isso é estranho, pois eu tinha certeza de que isso estava funcionando antes. Estou dando uma olhada agora e, se tiver tempo, lançarei uma correção em breve.

3 curtidas

@Thomas_Rother experimente isso:

(Pode ser necessário excluir e recriar as etapas afetadas)

2 curtidas

Quais são os casos de uso mais comuns para este plugin e ele está funcionando com o Gemini flash 2.0?

Qualquer processo de negócio (dentro do razoável) com múltiplos passos e atores. Pode requerer extensão para integrações específicas.

Atualmente é apenas OpenAI, mas PRs são bem-vindos (usa Chat Completions, então não é uma quantidade enorme de trabalho).

1 curtida

Grandes Notícias: agora você pode obter as estatísticas para criar gráficos de burn-up/down:

  • Adiciona um trabalho diário para criar estatísticas de contagem de estado que você pode usar em gráficos de burndown/burnup.
  • Adiciona um trabalho que verifica a presença ou adiciona duas consultas úteis do Explorador de Dados
    • Log de auditoria para todas as transições
    • Contagens diárias de instâncias de fluxo de trabalho em cada etapa de seu fluxo de trabalho, facilitando gráficos de burndown/up (basta exportar os resultados).
    • Você pode dar a grupos específicos acesso a esses relatórios.

NB O Discourse Workflow agora é compatível apenas com testes aprovados por enquanto devido a mudanças na forma como as dependências de gem são tratadas como parte do agrupamento principal de plugins. Isso deve mudar quando a próxima versão estável for lançada.

4 curtidas

Estou tentando descobrir por que meu site ficou lento…

Aviso de descontinuação

[PLUGIN discourse-workflow] Aviso de descontinuação: O acesso a site.mobileView ou site.desktopView durante a fase de inicialização do site está obsoleto. Em atualizações futuras, o modo móvel será determinado pelo tamanho da janela de visualização e, como consequência, o uso desses valores durante a inicialização pode levar a erros e inconsistências quando a janela do navegador for redimensionada. Por favor, mova essas verificações para um componente, transformador ou callback de API que execute durante a renderização da página. [obsoleto desde Discourse 3.5.0.beta9-dev] [id de descontinuação: discourse.static-viewport-initialization] [info: Designing for Different Devices (Viewport Size, Touch/Hover, etc.)] deprecated.js:62:13

Duvido muito que isso esteja causando lentidão no seu site!! :laughing: - é um aviso de depreciação.

aguardando seu PR :slight_smile:

1 curtida

Bem, não deveria ser devido ao Discourse Workflow, pois corrigi várias questões N+1, inclusive na Lista de Tópicos e na Visualização:

etc.

2 curtidas