Administrador del proceso de flujo de trabajo ↔

:information_source: 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 y tableros Kanban.
:hammer_and_wrench: Enlace al repositorio https://github.com/merefield/discourse-workflow
:open_book: Guía de instalación Cómo instalar plugins en Discourse

¿Te gusta este plugin? ¡Por favor dale una :star: en GitHub! :pray:

Resumen

discourse-workflow proporciona un marco de trabajo seguro para temas. Cada flujo de trabajo está compuesto por pasos y opciones configurables, y los temas avanzan por esos pasos hasta su finalización.

Soporta ramificación y bucles, vistas de descubrimiento en lista y Kanban, auditabilidad y comportamiento amigable para la automatización, manteniéndose cercano a los permisos y patrones de interfaz de usuario principales de Discourse.

Características

  • Instancias de flujo de trabajo basadas en temas con Flujos de trabajo, Pasos y Opciones de paso definidos por el administrador
  • Construido sobre conceptos centrales de Discourse: Categorías, Grupos y permisos basados en categorías; solo puedes actuar si tienes permiso para hacerlo
  • Descubrimiento de flujos de trabajo en /workflow con filtros rápidos:
    • Mis categorías
    • Vencidos
    • Paso = X
  • Selector de vista de descubrimiento:
    • Lista
    • Kanban (mostrado solo para un contexto de flujo de trabajo único compatible con Kanban)
    • Gráfico (mostrado solo para contexto de flujo de trabajo único y usuarios con permiso para ver gráficos)
  • Tablero Kanban de flujo de trabajo:
    • tarjetas de temas clicables
    • transiciones de arrastrar y soltar válidas
    • transiciones con teclado (Flecha Izquierda / Flecha Derecha) cuando son válidas
  • 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: workflow_overdue_days_default
    • anulación a nivel de flujo de trabajo
    • anulación a nivel de paso
    • 0 desactiva los vencidos en ese ámbito
    • indicadores de vencidos en la lista de flujos de trabajo y tarjetas Kanban
  • Gráficos de quemado de flujo de trabajo:
    • punto final del gráfico + integración de interfaz de usuario
    • selector de rango de semanas (1–12)
    • ventanas de semanas completas y series coloreadas por paso
  • Registro de auditoría de transiciones mediante pequeños posts de acción
  • Notificaciones de llegada para categorías observadas (Observar primer 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

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

Instancias de flujo de trabajo

  • Un solo elemento de flujo de trabajo (por ejemplo, un ticket) es un Tema.
  • Se pueden agregar etiquetas para metadatos como prioridad.
  • El movimiento entre categorías está controlado por acciones de flujo de trabajo (a menos que haya una anulación del personal).

Actores

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

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 de destino.

Panel de control

Usa el filtro de navegación /workflow para ver los temas de flujo de trabajo a los que tienes acceso, luego filtra o cambia a Kanban para la 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 integradas de Data Explorer 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 categorías más allá del paso 1 de un flujo de trabajo.
  • 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 en la categoría pueden ejecutar transiciones de flujo de trabajo.

Para comenzar

  1. Habilita el plugin con workflow_enabled.
  2. Ve a Administración → Plugins → Discourse Workflow.
  3. Crea un Flujo de trabajo, guárdalo y luego agrega Pasos y Opciones de paso.
  4. Configura los permisos de categoría para que los actores del flujo de trabajo tengan permiso de Crear en las categorías de paso relevantes.
  5. Crea un tema en la primera categoría de paso.
  6. Transiciónalo usando los botones de acción del tema o interacciones en Kanban.
  7. Usa /workflow para la gestión de la cola operativa.

Acciones con IA

La IA puede ejecutar un paso cuando está configurada.

Requisitos:

  • workflow_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.

26 Me gusta

Recibe algo de amor.

4 Me gusta

Se han implementado un par de correcciones:

2 Me gusta

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.
2 Me gusta

algunos ajustes menores pero importantes.

1 me gusta

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)?
3 Me gusta

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, ¿tienes un backtrace de esto?

3 Me gusta

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

2 Me gusta

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.

3 Me gusta

@Thomas_Rother inténtalo:

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

2 Me gusta

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

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

1 me gusta

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

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

4 Me gusta

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

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

Espero tu PR :slight_smile:

1 me gusta

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:

etc.

3 Me gusta

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
1 me gusta

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.
5 Me gusta

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).
3 Me gusta

He realizado una gran mejora de rendimiento:

4 Me gusta