Gestor de procesos ↔

[merefield (Robert)]

	Resumen	Un plugin de gestión de procesos para Discourse que mueve el trabajo a través de pasos configurables con acciones, filtros de lista, gráficos, vistas de carriles de natación y tableros Kanban.
	Enlace al repositorio	https://github.com/merefield/discourse-process-manager
	Guía de instalación	Cómo instalar plugins en Discourse

¿Te gusta este plugin? Por favor en GitHub!

Resumen

Process Manager proporciona un marco seguro de gestión de procesos para Discourse. Cada proceso consta de pasos y opciones configurables, y los temas avanzan a través de esos pasos hasta su finalización.

Un proceso puede representar un flujo de trabajo, un flujo de aprobación, una cola de soporte, un pipeline de revisión u otro trabajo por etapas.

Soporta ramificación y bucles, vistas de descubrimiento en lista y Kanban, registros de auditoría, gráficos y comportamientos compatibles con la automatización, manteniéndose cercano a los permisos y patrones de interfaz de usuario principales de Discourse.

Esto mantiene la configuración y el ajuste simples, y asegura que solo las personas adecuadas puedan actuar sobre un elemento de trabajo en cualquier momento.

Usar temas como elementos de trabajo proporciona a cada proceso una base flexible y nativa de Discourse: cada elemento puede tener un título, descripción detallada, archivos adjuntos, discusión, notificaciones, etiquetas y un historial completo desde el principio.

Características

• Flujos de trabajo de gestión de procesos usando temas de Discourse como elementos de trabajo

• Flujos de trabajo, pasos y opciones de paso definidos por el administrador

• Editor visual de flujos de trabajo para organizar pasos, carriles de natación y conectores de transición

• 

• Basado en conceptos principales de Discourse: categorías, grupos, etiquetas, notificaciones y permisos basados en categorías

• Los permisos de acción se mantienen cercanos al comportamiento de Discourse: los usuarios solo pueden actuar donde ya tienen los permisos de categoría correctos

• Descubrimiento de procesos en /processes con filtros rápidos:

  • Mis categorías
  • Vencidos
  • Paso = X

• Selector de vista de descubrimiento:

  • Lista

  • Kanban, mostrado solo para un único contexto de flujo de trabajo compatible con Kanban

  • Gráfico, mostrado solo para un contexto de proceso único y usuarios con permiso para gráficos

    

  • Gráfico, mostrado solo para un contexto de flujo de trabajo único y usuarios con permiso para gráficos

    

• Tablero de flujo de trabajo Kanban:

  • Tarjetas de tema clicables
  • Transiciones de arrastrar y soltar legales
  • Transiciones con teclado usando ArrowLeft / ArrowRight donde sea legal

• Banner de tema de flujo de trabajo:

  • Flujo de trabajo y paso actuales
  • Acciones de transición disponibles
  • Enlace de visualización

• Modelo de vencidos con jerarquía:

  • Configuración global: process_manager_overdue_days_default
  • Anulación del proceso
  • Anulación del paso
  • 0 desactiva los vencidos en ese ámbito
  • Indicadores de vencidos en la lista de procesos y tarjetas de Kanban

• Gráficos de quemado de flujo de trabajo:

  • Punto final de gráfico e integración de interfaz de usuario
  • Selector de rango de semanas de 1 a 12 semanas
  • Ventanas de semana completa y series coloreadas por paso

• Registro de auditoría de transición a través de pequeños posts de acción

• Notificaciones de llegada para categorías vigiladas usando Watch First Post

• Visualización de flujo de trabajo disponible desde el tema y las vistas de descubrimiento

  

• Integración con Data Explorer con consultas de flujo de trabajo predeterminadas:

  • estadísticas de quemado/ascenso
  • registro de auditoría

• Manejo de pasos asistido por IA opcional

Conceptos introductorios

Carriles de natación

Cada carril de flujo de trabajo es una categoría (o preferiblemente una subcategoría, ver más abajo). A medida que avanza un tema, se mueve entre categorías según las transiciones configuradas.

Elementos de proceso

• Un solo elemento de proceso (por ejemplo, un ticket) es un tema.
• Se pueden agregar etiquetas para metadatos como prioridad.
• El movimiento de categoría está controlado por acciones de flujo de trabajo (a menos que el personal lo anule).

Actores

Los usuarios que pueden crear temas en una categoría de paso pueden actuar sobre los elementos del flujo de trabajo en ese paso. Los usuarios con acceso a responder aún pueden comentar como de costumbre.

Acciones mediante opciones

Las opciones de paso definen las acciones disponibles en cada paso. Cada opción se muestra como un botón de acción de tema y puede mover el tema a un paso objetivo.

Panel de control

Usa el filtro de navegación /workflow para ver los temas del flujo de trabajo a los que tienes acceso, luego filtra o cambia a Kanban para una gestión de flujo estilo tablero.

Registro de auditoría

Las transiciones se registran como pequeños posts de acción en el tema. Las consultas de Data Explorer agrupadas soportan auditoría y reportes operativos.

Visualización

La visualización del flujo de trabajo está disponible desde:

• enlaces del banner del tema
• campos de flujo de trabajo en la lista de descubrimiento

Diferencias principales con Discourse estándar

• No puedes crear un nuevo tema directamente en las categorías de flujo de trabajo más allá del paso 1.
• No puedes cambiar manualmente la categoría de un tema de flujo de trabajo a menos que seas personal.
• Solo los usuarios con derechos de creación de categoría pueden ejecutar transiciones de flujo de trabajo.

Para empezar:

1. Habilita el plugin con process_manager_enabled.
2. Ve a Admin -> Plugins -> Process Manager.
3. Crea un proceso, guárdalo, luego agrega pasos y opciones de paso.
4. Configura los permisos de categoría para que los actores del proceso tengan permiso de creación de temas en las categorías de paso relevantes.
5. Crea un tema en la primera categoría de paso.
6. Transítalo usando los botones de acción del tema o las interacciones de Kanban.
7. Usa /processes para la gestión de colas operativas.

Acciones de IA:

La IA puede ejecutar un paso usando la integración directa de OpenAI de Process Manager. Esto no depende de Discourse AI.

Requisitos:

• process_manager_openai_api_key válido
• IA habilitada en el paso
• el prompt incluye tanto {{options}} como {{topic}}

Ejemplo de prompt:

tus opciones son {{options}}. si el siguiente texto indica que es delicioso, por favor acepta, de lo contrario rechaza. {{topic}} responde con una palabra de esas opciones

Problemas conocidos

Este plugin aún está en evolución. Por favor, reporta problemas e ideas de mejora en el repositorio o en este tema de Meta.

[merefield (Robert)]

Recibe algo de amor.

IMPROVE: make visualisation responsive and work on mobile

[merefield (Robert)]

Se han implementado un par de correcciones:

FIX: AI job error

COMPATIBILITY: fix issue when navigating to workflow admin

[merefield (Robert)]

IMPROVE: add workflow topic title link, restrict additional workflow list columns to desktop

Proporciona una vista más práctica en dispositivos móviles:

• MEJORAR: La lista de temas de flujo de trabajo funciona muy bien en el escritorio, pero en dispositivos móviles es demasiado ancha, por lo que en lugar de agregar todas esas columnas en dispositivos móviles, agregue una insignia de flujo de trabajo al título y restrinja el conjunto completo de columnas al escritorio.

[merefield (Robert)]

FIX: mobile display, localisation

algunos ajustes menores pero importantes.

[Thomas_Rother (Thommie Rother)]

Hola Robert:
Estoy jugando con el plugin de flujo de trabajo, sin IA. Este es un flujo de trabajo simple destinado a ser utilizado como una cadena de soporte para un café Linux que ayuda a las personas a migrar desde Windows. Se crean nuevos temas a través de correos electrónicos RFC 6233 con subdirecciones y entran en la primera subcategoría (nivel 1).

Dos problemas:

1. Las ID de los pasos del flujo de trabajo no son únicas. Tengo tres pasos con la misma ID. ??
2. Una acción de “inicio” en el tema entrante crea “422 contenido no procesable”. ¿Quizás eso es resultado de 1)?

[merefield (Robert)]

Gracias por tu paciencia y tus comentarios. Aprecio tu interés en el plugin.

Es un poco experimental y, como puedes ver, aún no ha recibido muchos comentarios, por lo que es inevitable que haya problemas iniciales.

Intentaré recrear tu flujo de trabajo e intentar recrear el problema.

Mientras tanto, ¿puedes hacer una captura de pantalla del flujo de trabajo en la pantalla de administración y compartirla?

@Thomas_Rother

Una acción de “inicio” en el tema entrante crea “422 contenido no procesable”. ¿Quizás eso es resultado de 1)?

@Thomas_Rother, ¿tienes un backtrace de esto?

[Thomas_Rother (Thommie Rother)]

Hola Robert:
No te preocupes, soy consciente de que esto es experimental. Por lo tanto, solo está instalado en una instancia de prueba autoalojada. Puedes registrarte allí y podría darte permisos de administrador:

https://forum2.netzwissen.de/login

[merefield (Robert)]

OK, a modo de resumen, así es como lo hice:

• Configurar la categoría de Tareas del Café Internet
• Configurar todos los pasos como Subcategorías, lo que resulta en esto:

Hasta ahora todo bien.

Ahora creemos los pasos:

OK, ¡puedo ver al menos dos problemas! (Pero es probable que uno de ellos sea la causa del otro)

Eso es extraño, ya que estaba seguro de que esto funcionaba antes. Lo estoy revisando ahora y, si tengo tiempo, lanzaré una solución en breve.

[merefield (Robert)]

@Thomas_Rother inténtalo:

FIX: position was being incorrectly allocated to new step

(Es posible que tengas que eliminar y recrear los pasos afectados)

[Olle11]

¿Cuáles son los casos de uso más comunes para este plugin y si está funcionando con Gemini flash 2.0?

[merefield (Robert)]

Cualquier proceso de negocio (dentro de lo razonable) con múltiples pasos y actores. Puede requerir extensión para integraciones específicas.

Actualmente solo funciona con OpenAI, pero las PR son bienvenidas (usa Chat Completions, así que no requiere una gran cantidad de trabajo).

[merefield (Robert)]

Grandes noticias: ahora puedes obtener las estadísticas para crear gráficos de burn-up/down:

FEATURE: Add daily workflow stats

• Añade un trabajo diario para crear estadísticas de recuento de estados que puedes usar en gráficos de burndown/burnup.
• Añade un trabajo que verifica la presencia o añade dos consultas útiles de Data Explorer
  • Registro de auditoría para todas las transiciones
  • Recuentos diarios de instancias de flujo de trabajo en cada paso de su flujo de trabajo, facilitando los gráficos de burndown/up (simplemente exporta los resultados).
  • Puedes dar acceso específico a grupos a estos informes.

NB Discourse Workflow ahora solo es compatible con tests-passed por el momento debido a cambios en la forma en que se manejan las dependencias de gem como parte de la agrupación principal de plugins. Esto debería cambiar una vez que se realice la próxima versión estable.

[hellekin]

Estoy tratando de averiguar por qué mi sitio se volvió lento…

Advertencia de obsolescencia

[PLUGIN discourse-workflow] Aviso de obsolescencia: El acceso a site.mobileView o site.desktopView durante la fase de inicialización del sitio está obsoleto. En futuras actualizaciones, el modo móvil se determinará por el tamaño de la ventana gráfica y, como consecuencia, el uso de estos valores durante la inicialización puede provocar errores e inconsistencias al cambiar el tamaño de la ventana del navegador. Mueva estas comprobaciones a un componente, transformador o devolución de llamada de API que se ejecute durante la representación de la página. [obsoleto desde Discourse 3.5.0.beta9-dev] [id de obsolescencia: discourse.static-viewport-initialization] [info: Designing for Different Devices (Viewport Size, Touch/Hover, etc.)] deprecated.js:62:13

[merefield (Robert)]

@hellekin

mi sitio se volvió lento…

¡Dudo mucho que esto esté causando que tu sitio se vuelva lento! - es una advertencia de depreciación.

Espero tu PR

[merefield (Robert)]

@hellekin

mi sitio se volvió lento…

Bueno, no debería ser por Discourse Workflow, ya que he cerrado varios problemas de N+1, incluidos los de la Lista de Temas y la Visualización:

IMPROVE: performance

etc.

[merefield (Robert)]

Gran actualización con varias características nuevas, incluyendo

• Nuevos filtros de lista de temas específicos del flujo de trabajo
• Marcado de “Vencido”
• Metainformación más rica del flujo de trabajo de temas

FEATURE: filters, overdue & indicators, richer UX, admin fixes, more specs (#15)

[merefield (Robert)]

Actualización enorme:

Nueva vista Kanban:

• Se añadió un modo Kanban completo a /workflow con un interruptor Lista/Kanban, que solo se muestra cuando hay un único flujo de trabajo compatible con Kanban en el ámbito.
  • Se introdujo una validación explícita de compatibilidad con Kanban (incluido el mapeo determinista de un solo borde) y se mostró el estado de compatibilidad en la administración del flujo de trabajo.
• Se hicieron que los elementos del flujo de trabajo fueran accionables desde Kanban: arrastrar y soltar entre pasos legales, mover pasos con las teclas de flecha y hacer clic para abrir temas.
• Se mejoró la fiabilidad para actualizaciones concurrentes: las transiciones obsoletas ahora devuelven 409, muestran un mensaje de estado obsoleto claro y activan la actualización para resincronizar el estado de la interfaz de usuario.
• Usabilidad y claridad del tablero: etiquetas Kanban opcionales a nivel de flujo de trabajo, soporte para indicadores de vencimiento en las tarjetas y estilo de carril que incluye bordes de columna con color de categoría.

FEATURE: Kanban view for compatible workflows (#16)

[merefield (Robert)]

Otra gran actualización: gráfico de avance/retroceso (burn-up/burn-down) en línea (como una buena alternativa a la consulta de Explorador de Datos incluida existente)

• Se añadió una nueva vista de Gráfico de flujo de trabajo en descubrimiento con un selector de vista compartido (Lista / Kanban / Gráfico) y control de período (1–12 semanas).
  • Se implementó la API de datos de avance/retroceso en /discourse-workflow/charts.json más la integración de la ruta /workflow/charts.
  • El acceso al gráfico está permitido por separado: administradores y workflow_charts_allowed_groups; el Gráfico se oculta a los usuarios no autorizados.
  • La carga útil del gráfico se ajustó solo al contexto del flujo de trabajo seleccionado (selected_workflow_id, selected_workflow_name, series), eliminando la superficie de catálogo de flujo de trabajo no utilizada.
  • Se añadió cobertura de solicitud/sistema y endurecimiento de la experiencia de usuario (UX): ventanas de semana completa, etiquetas de eje seguras para fechas locales, etiquetado accesible del selector de vista y comprobaciones de regresión de representación/estado del gráfico.

La función de gráficos debería ser compatible con todos los flujos de trabajo:

• El Gráfico no requiere compatibilidad con Kanban, por lo que funciona para flujos de trabajo que no son compatibles con Kanban.
  • El Gráfico solo aparece cuando la lista de flujo de trabajo actual está limitada a exactamente un flujo de trabajo.
  • El usuario debe tener permiso para ver el gráfico (administrador o estar en workflow_charts_allowed_groups).
  • Si es compatible con Kanban, el menú desplegable muestra Lista/Kanban/Gráfico.
  • Si no es compatible con Kanban, el menú desplegable aún puede mostrar Lista/Gráfico (cuando se cumplen las dos condiciones anteriores).

FEATURE: online workflow burndown/up chart (#18)

[merefield (Robert)]

He realizado una gran mejora de rendimiento:

IMPROVE: Performance pass (#19)