Flujo de trabajo de Discourse

:information_source: Resumen Un sistema de flujo de trabajo para Temas que implementa un proceso configurable de múltiples etapas
: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

Un plugin que proporciona un marco de flujo de trabajo seguro para Temas que se pasan por un conjunto personalizable de pasos hasta que el flujo de trabajo se completa. Se admiten algunas ramificaciones y bucles.

Úselo para un flujo de trabajo empresarial que tenga, como un proceso de aprobación o respuesta a incidencias.

Características

¡Una herramienta de flujo de trabajo para Discourse!

  • Flujo de trabajo basado en temas
  • Aprovecha la seguridad existente de la plataforma, Categorías, Usuarios y Grupos.
  • Nuevas pantallas de administración para crear Nuevos Flujos de Trabajo, Pasos y Opciones de Paso.
  • Nueva lista de Descubrimiento de Flujos de Trabajo que enumera todos los Temas de Flujo de Trabajo a los que tiene acceso
  • Encabezado de Tema para Temas de Flujo de Trabajo que le indica:
    • flujo de trabajo actual
    • paso actual del flujo de trabajo
    • Botones de Acción si usted es parte del grupo con acceso para seleccionar una Opción que determina cómo el Tema progresa a través del flujo de trabajo
    • enlace a una visualización (ver arriba).
  • Visualización del flujo de trabajo que se puede iniciar desde:
    • Encabezado del Tema
    • Lista de Descubrimiento
  • Pequeñas acciones de publicación de temas para transiciones de flujo de trabajo para mostrar el rastro de auditoría.
  • Notificaciones para cuando los Temas llegan a un paso (es decir, Categoría) que usted está Observando (Primera Publicación)
  • Soporte de Data Explorer
    • Informe de Registro de Auditoría
    • Recuentos diarios de Instancias de Flujo de Trabajo/Paso para que pueda crear gráficos de quemado/quema.
  • La IA puede ser utilizada para accionar automáticamente los Pasos del Flujo de Trabajo.

NB Esta es una versión en etapa temprana y el conjunto de características probablemente evolucionará. Estoy abierto a intereses comerciales para financiar nuevas características e integraciones.

Conceptos introductorios

Para aprovechar la plataforma Discourse tal como está tanto como sea posible, he creado un marco simple que utiliza muchas de las características existentes de la plataforma.

Carriles (Swim Lanes)

Cada carril del flujo de trabajo es una Categoría (o Subcategoría).

A medida que una instancia de un flujo de trabajo continúa su viaje, se mueve entre Categorías en un viaje personalizable pero predefinido.

Instancias de Flujo de Trabajo

Una sola instancia de un flujo de trabajo (por ejemplo, un ticket) es un Tema. Puede agregar etiquetas a un Tema para resaltar su prioridad u otros metadatos. No puede modificar su Categoría una vez que ha comenzado su viaje, excepto tomando acciones de flujo de trabajo sobre el Tema (a menos que sea personal).

Actores

Cualquier Grupo que tenga acceso de creación de Temas a una Categoría puede actuar sobre los temas en esa Categoría.

Aquellos que tienen acceso de Respuesta pueden comentar el elemento del Flujo de Trabajo tal como lo harían para un Tema normal.

Puede ocultar Temas dentro de una Categoría de grupos específicos de la manera habitual.

Acciones a través de Opciones

Estas se definen para cada paso al configurar el Flujo de Trabajo. Los Actores pueden elegir tomar cualquier acción disponible, ya que cada Opción se presenta como un botón en el Tema.

Las acciones sobre un Tema se capturan en una Publicación de Acción Pequeña para ayudar a los usuarios a comprender el viaje del Tema.

Panel de Control

Un nuevo filtro de Descubrimiento de Temas “Flujos de Trabajo” en la página de inicio proporciona una lista de instancias de Flujo de Trabajo (temas de flujo de trabajo especiales)

Debería mantener las Categorías de Flujo de Trabajo y, idealmente, las etiquetas distintas, por lo que también puede usarlas para filtrar todas las instancias de flujo de trabajo que se encuentran en una etapa particular, o que tienen una etiqueta específica.

Rastro de auditoría

Cada vez que un Tema pasa a un nuevo paso, se agrega una nota que documenta eso como una Publicación de Acción Pequeña en el Tema.

Una consulta de Data Explorer incluida proporciona un informe de auditoría básico del viaje que ha realizado una instancia de flujo de trabajo.

Debido a que las consultas de Data Explorer se pueden exponer a usuarios más allá de los Administradores, puede elegir a quién mostrárselas.

Gráficos de Quemado/Quema

Hay una consulta de Data Explorer incluida que presenta los estados del flujo de trabajo al final del día para que pueda exportar los datos para crear gráficos de quemado/quema en, por ejemplo, Excel.

Visualización

Hay un botón en cada Tema de flujo de trabajo que le permite mostrar una visualización de dónde se encuentra el Tema en su flujo de trabajo.

Esto también es accesible desde los campos del flujo de trabajo en el Panel de Descubrimiento de Flujos de Trabajo.

Principales diferencias de comportamiento con el stock

  • No puede crear un nuevo Tema en una Categoría que esté más allá del primer paso de un flujo de trabajo
  • No puede cambiar la Categoría de un Tema que está dentro de un flujo de trabajo (a menos que sea personal).
  • Solo los “Creadores” de Categoría pueden actuar sobre un Tema en un Flujo de Trabajo.

Cómo empezar

El plugin de flujo de trabajo no viene con un Flujo de Trabajo, tiene que crear uno.

Las pantallas para crear uno se encuentran en Administración → Plugins → Discourse Workflow.

Primero cree un nuevo Flujo de Trabajo presionando el botón, guárdelo, luego complete los Pasos editando el flujo de trabajo. Cada Paso, una vez creado, se puede Editar para agregar Opciones, tomadas de una lista de Opciones predefinidas.

Puede cambiar la etiqueta de una Opción en Administración → Personalizar → Texto.

He sembrado el sistema con una buena variedad de Opciones, pero si desea cambiar el texto de cada una, adelante.

En cada Categoría de Flujo de Trabajo, debe asegurarse de que sus “Actores” estén configurados como con derechos de Creación. Todos los demás deben tener Respuesta o menos.

Sus “Actores” también pueden desear Rastrear la Categoría de la que son responsables seleccionando “Observar Primera Publicación”. Luego, cuando llegue un nuevo Tema de Flujo de Trabajo, se les notificará con un enlace.

Consejos

  • Considere hacer que todos los pasos del flujo de trabajo para un flujo de trabajo en particular sean una Subcategoría dentro de una sola Categoría. Si bien esto no es necesario, le permitirá filtrar simplemente por esa Categoría utilizando el menú desplegable de Categoría existente de Discourse en la lista de Descubrimiento para ver todas las instancias de flujo de trabajo para ese flujo de trabajo específico.
  • En la nueva lista de Descubrimiento de Flujos de Trabajo, puede hacer clic en el Nombre del Flujo de Trabajo, la Posición o el Paso para visualizar dónde se encuentra esa instancia en su camino.
  • Utilice las herramientas oficiales existentes para crear plantillas estructuradas para Temas utilizados en Flujo de Trabajo:
  • Cree un enlace en la Barra Lateral (o en cualquier lugar) para crear un nuevo elemento de Flujo de Trabajo e iniciar el flujo de trabajo: Creating a link to start a new topic with pre-filled information

Acciones de IA

Puede aprovechar la IA para manejar un paso. Necesita una clave válida de OpenAI agregada a la configuración del Flujo de Trabajo. Debe habilitar la IA en el paso. También debe escribir un prompt que debe incluir {{options}} para que la IA sepa qué opciones tiene y {{topic}} para incluir el contenido.

Ejemplo de prompt:

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

Problemas Conocidos:

Todavía está en fase experimental, así que espere problemas, repórtelos y los enumeraré aquí hasta que se aborden.

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

2 Me gusta