Flujo de trabajo de Discourse

:information_source: Resumen Un sistema de flujo de trabajo basado en temas para Discourse con pasos configurables, acciones, filtros de lista de flujo de trabajo y vista 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

¿Disfrutas de este plugin? Por favor, dale :star: en GitHub! :pray:

Resumen

discourse-workflow proporciona un marco de flujo de trabajo seguro para Temas. Cada flujo de trabajo se compone de pasos y opciones configurables, y los temas avanzan a través de esos pasos hasta su finalización.

Admite ramificación y bucle, vistas de descubrimiento de lista y Kanban, auditabilidad y comportamiento amigable con la automatización, al tiempo que se mantiene cerca de 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 principales de Discourse: Categorías, Grupos y permisos basados en categorías: solo puedes actuar si tienes permiso para hacerlo
  • Descubrimiento de flujo de trabajo en /workflow con filtros rápidos:
    • Mis Categorías
    • Vencido
    • Paso = X
  • Selector de vista de descubrimiento:
    • Lista
    • Kanban (mostrado solo para contexto de flujo de trabajo único y compatible con Kanban)
    • Gráfico (mostrado solo para contexto de flujo de trabajo único y usuarios con permiso para gráficos)
  • Panel de flujo de trabajo Kanban:
    • tarjetas de tema clicables
    • transiciones legales de arrastrar y soltar
    • transiciones por teclado (FlechaIzquierda / FlechaDerecha) cuando son legales
  • Banner de tema de flujo de trabajo:
    • flujo de trabajo y paso actuales
    • acciones de transición disponibles
    • enlace de visualización
  • Modelo de vencimiento con jerarquía:
    • configuración global: workflow_overdue_days_default
    • anulación de flujo de trabajo
    • anulación de paso
    • 0 deshabilita el vencimiento en ese ámbito
    • indicadores de vencimiento en la lista de flujo de trabajo y tarjetas Kanban
  • Gráfico de consumo de flujo de trabajo:
    • endpoint de gráfico + integración de interfaz de usuario
    • selector de rango de semanas (1–12)
    • ventanas de semana completa y series coloreadas por paso
  • Registro de auditoría de transición a través de pequeñas publicaciones de acción
  • Notificaciones de llegada para categorías seguidas (Seguir primera publicación)
  • Visualización del flujo de trabajo disponible desde las vistas de tema y descubrimiento
  • Integración con Data Explorer con consultas de flujo de trabajo predeterminadas:
    • estadísticas de consumo/aumento
    • registro de auditoría
  • Manejo de pasos asistido opcional por IA

Conceptos Introductorios

Carriles (Swim Lanes)

Cada carril del flujo de trabajo es una Categoría (o Subcategoría). A medida que un tema progresa, se mueve entre categorías de acuerdo con las transiciones configuradas.

Instancias de Flujo de Trabajo

  • Un único elemento de flujo de trabajo (por ejemplo, un ticket) es un Tema.
  • Se pueden agregar etiquetas para metadatos como la prioridad.
  • El movimiento de categoría está controlado por acciones de flujo de trabajo (a menos que el personal 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 de respuesta aún pueden comentar de forma normal.

Acciones a través de 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 (Dashboard)

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

Registro de Auditoría

Las transiciones se registran como pequeñas publicaciones de acción en el tema. Las consultas agrupadas de Data Explorer admiten la auditoría y los informes operativos.

Visualización

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

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

Principales Diferencias 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 de categoría pueden ejecutar transiciones de flujo de trabajo.

Primeros Pasos

  1. Habilita el plugin con workflow_enabled.
  2. Ve a Administrador → 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 Creación en las categorías de paso relevantes.
  5. Crea un tema en la categoría del primer paso.
  6. Transiciónalo usando los botones de acción del tema o las interacciones de Kanban.
  7. Usa /workflow para la gestión de la cola operativa.

Acciones de IA

La IA puede accionar 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 sola palabra de esas opciones

Problemas Conocidos

Este plugin todavía está evolucionando. Por favor, informa de 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:

3 Me gusta