Gerenciador de Processos ↔

:information_source: Resumo Um plugin de gerenciamento de processos para Discourse que move o trabalho através de etapas configuráveis com ações, filtros de lista, gráficos, visualizações em faixas (swim-lane) e quadros Kanban.
:hammer_and_wrench: Link do Repositório https://github.com/merefield/discourse-process-manager
:open_book: Guia de Instalação Como instalar plugins no Discourse

Gostou deste plugin? Por favor, dê uma :star: no GitHub! :pray:

Resumo

O Process Manager oferece uma estrutura segura de gerenciamento de processos para o Discourse. Cada processo é composto por etapas e opções configuráveis, e os tópicos avançam por essas etapas até a conclusão.

Um processo pode representar um fluxo de trabalho, fluxo de aprovação, fila de suporte, pipeline de revisão ou outro trabalho em etapas.

Ele suporta ramificação e loops, visualizações de descoberta em lista e Kanban, trilhas de auditoria, gráficos e comportamentos amigáveis à automação, mantendo-se próximo das permissões e padrões de interface do usuário (UI) principais do Discourse.

Isso mantém a configuração simples e garante que apenas as pessoas certas possam agir sobre um item de trabalho a qualquer momento.

Usar tópicos como itens de trabalho dá a cada processo uma base flexível e nativa do Discourse: cada item pode ter um título, descrição detalhada, anexos, discussão, notificações, tags e um histórico completo prontamente disponíveis.

Recursos

  • Fluxos de gerenciamento de processos usando tópicos do Discourse como itens de trabalho

  • Fluxos de trabalho, etapas e opções de etapa definidos por administradores

  • Editor visual de fluxo de trabalho para organizar etapas, faixas (swim lanes) e conectores de transição

  • Baseado em conceitos principais do Discourse: categorias, grupos, tags, notificações e permissões baseadas em categoria

  • As permissões de ação permanecem próximas ao comportamento do Discourse: os usuários só podem agir onde já possuem a permissão da categoria correta

  • Descoberta de processos em /processes com filtros rápidos:

    • Minhas categorias
    • Atrasados
    • Etapa = X
  • Seletor de visualização de descoberta:

    • Lista

    • Kanban, mostrado apenas para um único contexto de fluxo de trabalho compatível com Kanban

    • Gráfico, mostrado apenas para um contexto de processo único e usuários com permissão para gráficos

    • Gráfico, mostrado apenas para um contexto de fluxo de trabalho único e usuários com permissão para gráficos

  • Quadro de fluxo de trabalho Kanban:

    • Cartões de tópicos clicáveis
    • Transições de arrastar e soltar legais
    • Transições de teclado com ArrowLeft / ArrowRight onde permitido
  • Banner de tópico de 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: process_manager_overdue_days_default
    • Substituição do processo
    • Substituição da etapa
    • 0 desativa o atraso naquele escopo
    • Indicadores de atraso na lista de processos e nos cartões Kanban
  • Gráficos de burn-down de fluxo de trabalho:

    • Endpoint de gráfico e integração de UI
    • Seletor de intervalo de semanas de 1 a 12 semanas
    • 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 assistidas usando „Watch First Post“

  • Visualização de fluxo de trabalho disponível a partir de tópicos e visualizações de descoberta

  • Integração com Data Explorer com consultas de fluxo de trabalho padrão:

    • estatísticas de burn-down/burn-up
    • log de auditoria
  • Processamento de etapa assistido por IA opcional

Conceitos Introdutórios

Faixas (Swim Lanes)

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

Itens de Processo

  • Um único item de processo (por exemplo, um ticket) é um Tópico.
  • Tags podem ser adicionadas para metadados, como prioridade.
  • O movimento entre categorias é controlado por ações de fluxo de trabalho (a menos que haja substituição por equipe).

Atores

Usuários que podem criar tópicos em uma categoria de etapa podem agir sobre itens de 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

Use o filtro de navegação /workflow para ver os tópicos de fluxo de trabalho aos quais você tem acesso, depois filtre ou alterne 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 do Data Explorer agrupadas suportam auditoria e relatórios operacionais.

Visualização

A visualização de 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 em Relação ao Discourse Padrão

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

Começando:

  1. Ative o plugin com process_manager_enabled.
  2. Vá para Admin -> Plugins -> Process Manager.
  3. Crie um processo, salve-o e, em seguida, adicione etapas e opções de etapa.
  4. Configure as permissões de categoria para que os atores do processo tenham permissão de criação de tópico nas categorias de etapa relevantes.
  5. Crie um tópico na primeira categoria de etapa.
  6. Transicione-o usando botões de ação de tópico ou interações Kanban.
  7. Use /processes para gerenciamento de fila operacional.

Ações de IA:

A IA pode executar uma etapa usando a integração direta do OpenAI do Process Manager. Isso não depende do Discourse AI.

Requisitos:

  • process_manager_openai_api_key válido
  • IA ativada na etapa
  • o prompt inclui {{options}} e {{topic}}

Exemplo de prompt:

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

Problemas Conhecidos

Este plugin ainda está em evolução. Por favor, reporte problemas e ideias de melhoria 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.
5 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).
3 curtidas

Realizei uma grande otimização de desempenho:

4 curtidas