Fluxo de Trabalho do Discourse

:information_source: Resumo Um sistema de fluxo de trabalho baseado em tópicos para o Discourse com etapas configuráveis, ações, filtros de lista de fluxo de trabalho e visualização Kanban
: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, dê uma :star: no GitHub! :pray:

Resumo

discourse-workflow fornece uma estrutura de fluxo de trabalho segura para Tópicos. Cada fluxo de trabalho é composto por etapas e opções configuráveis, e os tópicos passam por essas etapas até a conclusão.

Ele suporta ramificação e loop, visualizações de descoberta de lista e Kanban, auditabilidade e comportamento amigável à automação, mantendo-se próximo às permissões e padrões de interface do usuário principais do Discourse.

Funcionalidades

  • Instâncias de fluxo de trabalho baseadas em tópicos com Fluxos de Trabalho, Etapas e Opções de Etapa definidos pelo administrador
  • Construído sobre conceitos principais do Discourse: Categorias, Grupos e permissões baseadas em categorias - você só pode agir se tiver permissão para fazê-lo
  • Descoberta de fluxo de trabalho em /workflow com filtros rápidos:
    • Minhas Categorias
    • Atrasado
    • Etapa = X
  • Seletor de visualização de descoberta:
    • Lista
    • Kanban (mostrado apenas para contexto de fluxo de trabalho único e compatível com Kanban)
    • Gráfico (mostrado apenas para contexto de fluxo de trabalho único e usuários com permissão para gráfico)
  • Painel de fluxo de trabalho Kanban:
    • cartões de tópico clicáveis
    • transições de arrastar/soltar legais
    • transições por teclado (SetaEsquerda / SetaDireita) quando legal
  • Banner de tópico do fluxo de trabalho:
    • fluxo de trabalho e etapa atuais
    • ações de transição disponíveis
    • link de visualização
  • Modelo de Atraso com hierarquia:
    • configuração global: workflow_overdue_days_default
    • substituição de fluxo de trabalho
    • substituição de etapa
    • 0 desativa o atraso nesse escopo
    • indicadores de atraso na lista de fluxo de trabalho e nos cartões Kanban
  • Gráfico de burn-down do fluxo de trabalho:
    • endpoint de gráfico + integração de UI
    • seletor de intervalo de semanas (1–12)
    • janelas de semana completa e séries coloridas por etapa
  • Trilha de auditoria de transição via pequenos posts de ação
  • Notificações de chegada para categorias observadas (Observar Primeiro Post)
  • Visualização de fluxo de trabalho disponível nas visualizações de tópico e descoberta
  • Integração com o Data Explorer com consultas de fluxo de trabalho padrão:
    • estatísticas de burn-down/burn-up
    • log de auditoria
  • Manipulação de etapa opcional assistida por IA

Conceitos Introdutórios

Pistas (Swim Lanes)

Cada pista de fluxo de trabalho é uma Categoria (ou Subcategoria). À medida que um tópico progride, ele se move entre as categorias de acordo com as transições configuradas.

Instâncias de Fluxo de Trabalho

  • Um único item de fluxo de trabalho (por exemplo, um ticket) é um Tópico.
  • Tags podem ser adicionadas para metadados, como prioridade.
  • O movimento da categoria é controlado por ações de fluxo de trabalho (a menos que a equipe substitua).

Atores

Usuários que podem criar tópicos na categoria de uma etapa podem agir sobre os itens do fluxo de trabalho nessa etapa. Usuários com acesso de resposta ainda podem comentar normalmente.

Ações via Opções

As Opções de Etapa definem as ações disponíveis em cada etapa. Cada opção é exibida como um botão de ação de tópico e pode mover o tópico para uma etapa de destino.

Painel de Controle (Dashboard)

Use o filtro de navegação /workflow para ver os tópicos de fluxo de trabalho aos quais você pode acessar, em seguida, filtre ou mude para Kanban para gerenciamento de fluxo no estilo de quadro.

Trilha de Auditoria

As transições são registradas como pequenos posts de ação no tópico. Consultas agrupadas do Data Explorer suportam auditoria e relatórios operacionais.

Visualização

A visualização do fluxo de trabalho está disponível a partir de:

  • links no banner do tópico
  • campos de fluxo de trabalho na lista de descoberta

Principais Diferenças do Discourse Padrão

  • Você não pode criar um novo tópico diretamente em categorias além da etapa 1 de um fluxo de trabalho.
  • Você não pode alterar manualmente a categoria de um tópico de fluxo de trabalho, a menos que seja da equipe.
  • Apenas usuários com direitos de criação de categoria podem executar transições de fluxo de trabalho.

Primeiros Passos

  1. Habilite o plugin com workflow_enabled.
  2. Vá para Admin → Plugins → Discourse Workflow.
  3. Crie um Fluxo de Trabalho, salve-o e, em seguida, adicione Etapas e Opções de Etapa.
  4. Configure as permissões de categoria para que os atores do fluxo de trabalho tenham Criação nas categorias de etapa relevantes.
  5. Crie um tópico na categoria da primeira etapa.
  6. Transicione-o usando botões de ação de tópico ou interações Kanban.
  7. Use /workflow para gerenciamento de fila operacional.

Ações de IA

A IA pode executar uma etapa quando configurada.

Requisitos:

  • workflow_openai_api_key válido
  • IA habilitada na etapa
  • O prompt inclui tanto {{options}} quanto {{topic}}

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

Este plugin ainda está evoluindo. Por favor, relate problemas e ideias de aprimoramento no repositório ou neste tópico do Meta.

26 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.

3 curtidas

Grande atualização com vários novos recursos, incluindo

  • Novos filtros de lista de tópicos específicos do fluxo de trabalho
  • Sinalização de “Atrasado”
  • Metainformação de fluxo de trabalho de Tópico mais rica
1 curtida

Atualização enorme:

Nova visualização Kanban:

  • Adicionado um modo Kanban completo em /workflow com um alternador Lista/Kanban, exibido apenas quando um único fluxo de trabalho compatível com Kanban está no escopo.
    • Introduzida validação explícita de compatibilidade com Kanban (incluindo mapeamento determinístico de aresta única) e exibição do status de compatibilidade na administração do fluxo de trabalho.
  • Tornados os itens do fluxo de trabalho acionáveis a partir do Kanban: arrastar e soltar entre etapas legais, movimentação de etapas com teclas de seta e clique para abrir tópicos.
  • Melhorada a confiabilidade para atualizações concorrentes: transições obsoletas agora retornam 409, mostram uma mensagem clara de estado obsoleto e acionam a atualização para ressincronizar o estado da interface do usuário.
  • Usabilidade e clareza do quadro: tags Kanban opcionais no nível do fluxo de trabalho, suporte a indicador de atraso nos cartões e estilização de faixas, incluindo bordas de coluna coloridas por categoria.
4 curtidas

Mais uma grande atualização - gráfico de burn-up/down online (como uma boa alternativa à consulta Data Explorer incluída existente)

  • Adicionada uma nova visualização de Gráfico de fluxo de trabalho (workflow) na descoberta com um seletor de visualização compartilhado (Lista / Kanban / Gráfico) e controle de período (1–12 semanas).
    • Implementada API de dados de burn-down em /discourse-workflow/charts.json mais integração de rota /workflow/charts.
    • O acesso ao Gráfico é permitido separadamente: administradores e workflow_charts_allowed_groups; o Gráfico é ocultado de usuários não autorizados.
    • A carga útil do Gráfico foi otimizada apenas para o contexto de fluxo de trabalho selecionado (selected_workflow_id, selected_workflow_name, series), removendo a superfície de catálogo de fluxo de trabalho não utilizada.
    • Cobertura de solicitação/sistema adicionada e endurecimento da experiência do usuário (UX): janelas de semana completa, rótulos de eixo seguros para datas locais, rotulagem acessível do seletor de visualização e verificações de regressão de renderização/estado do gráfico.

O recurso de Gráfico deve ser compatível com todos os fluxos de trabalho:

  • O Gráfico não requer compatibilidade com Kanban, portanto, funciona para fluxos de trabalho que não são compatíveis com Kanban.
    • O Gráfico aparece somente quando a lista de fluxo de trabalho atual está restrita a exatamente um fluxo de trabalho.
    • O usuário deve ter permissão para o gráfico (admin ou nos grupos workflow_charts_allowed_groups).
    • Se for compatível com Kanban, o menu suspenso mostrará Lista/Kanban/Gráfico.
    • Se não for compatível com Kanban, o menu suspenso ainda pode mostrar Lista/Gráfico (quando as duas condições acima forem atendidas).
2 curtidas