Менеджер процессов ↔

:information_source: Краткое описание Плагин управления процессами для Discourse, который перемещает работу через настраиваемые этапы с помощью действий, фильтров списков, диаграмм, видов с плавательными дорожками и досок Канбан.
:hammer_and_wrench: Ссылка на репозиторий https://github.com/merefield/discourse-process-manager
:open_book: Руководство по установке Как установить плагины в Discourse

Вам нравится этот плагин? Пожалуйста, поставьте ему :star: на GitHub! :pray:

Краткое описание

Process Manager предоставляет безопасную среду для управления процессами в Discourse. Каждый процесс состоит из настраиваемых этапов и опций, и темы перемещаются через эти этапы до завершения.

Процесс может представлять рабочий поток, поток согласования, очередь поддержки, конвейер проверки или другую поэтапную работу.

Он поддерживает ветвление и циклы, виды обнаружения в виде списка и Канбан, журналы аудита, диаграммы и поведение, удобное для автоматизации, оставаясь при этом близким к основным правам доступа и паттернам интерфейса Discourse.

Это упрощает настройку и конфигурацию, а также гарантирует, что только нужные люди могут действовать с элементом работы в любой момент времени.

Использование тем в качестве элементов работы придает каждому процессу гибкую, нативную основу Discourse: каждый элемент может иметь заголовок, подробное описание, вложения, обсуждение, уведомления, теги и полную историю из коробки.

Возможности

  • Рабочие процессы управления процессами с использованием тем Discourse в качестве элементов работы

  • Определенные администраторами рабочие процессы, этапы и опции этапов

  • Визуальный редактор рабочих процессов для размещения этапов, плавательных дорожек и соединителей переходов

  • Построен на основе основных концепций Discourse: категории, группы, теги, уведомления и права доступа на основе категорий

  • Права доступа к действиям остаются близкими к поведению Discourse: пользователи могут действовать только там, где у них уже есть права на соответствующую категорию

  • Обнаружение процессов по адресу /processes с быстрыми фильтрами:

    • Мои категории
    • Просроченные
    • Этап = X
  • Выбор вида обнаружения:

    • Список

    • Канбан, отображается только для одного контекста рабочего процесса, совместимого с Канбан

    • Диаграмма, отображается только для контекста одного процесса и пользователей, имеющих право на просмотр диаграмм

    • Диаграмма, отображается только для контекста одного рабочего процесса и пользователей, имеющих право на просмотр диаграмм

  • Доска рабочего процесса Канбан:

    • Кликабельные карточки тем
    • Легальные переходы перетаскиванием
    • Переходы с клавиатуры с помощью ArrowLeft / ArrowRight, где это разрешено
  • Баннер темы рабочего процесса:

    • Текущий рабочий процесс и этап
    • Доступные действия перехода
    • Ссылка на визуализацию
  • Модель просроченных задач с иерархией:

    • Глобальная настройка: process_manager_overdue_days_default
    • Переопределение процесса
    • Переопределение этапа
    • 0 отключает просрочку в данной области
    • Индикаторы просрочки в списке процессов и карточках Канбан
  • Построение диаграмм сгорания рабочего процесса:

    • Точка подключения диаграммы и интеграция с интерфейсом
    • Выбор диапазона недель от 1 до 12 недель
    • Окна полных недель и серии, окрашенные по этапам
  • Журнал аудита переходов через небольшие посты с действиями

  • Уведомления о прибытии для отслеживаемых категорий с использованием «Watch First Post»

  • Визуализация рабочего процесса доступна из темы и видов обнаружения

  • Интеграция с Data Explorer с запросами по умолчанию для рабочих процессов:

    • Статистика сгорания/нарастания
    • Журнал аудита
  • Опциональная обработка этапов с помощью ИИ

Вводные понятия

Плавательные дорожки

Каждая дорожка рабочего процесса представляет собой категорию (или, предпочтительно, подкатегорию, см. ниже). По мере продвижения темы она перемещается между категориями в соответствии с настроенными переходами.

Элементы процесса

  • Один элемент процесса (например, заявка) — это тема.
  • Теги могут быть добавлены для метаданных, таких как приоритет.
  • Перемещение по категориям контролируется действиями рабочего процесса (если только сотрудники не вмешаются).

Участники

Пользователи, которые могут создавать темы в категории этапа, могут действовать над элементами рабочего процесса на этом этапе. Пользователи с правами на ответ всё ещё могут комментировать как обычно.

Действия через опции

Опции этапа определяют доступные действия на каждом этапе. Каждая опция отображается как кнопка действия темы и может переместить тему на целевой этап.

Панель управления

Используйте фильтр навигации /workflow, чтобы увидеть темы рабочего процесса, к которым у вас есть доступ, затем отфильтруйте или переключитесь на Канбан для управления потоком в стиле доски.

Журнал аудита

Переходы регистрируются в виде небольших постов с действиями в теме. Связанные запросы Data Explorer поддерживают аудит и операционную отчётность.

Визуализация

Визуализация рабочего процесса доступна из:

  • Ссылок на баннере темы
  • Полей рабочего процесса в списке обнаружения

Основные отличия от стандартного Discourse

  • Вы не можете создать новую тему напрямую в категориях рабочего процесса, выходящих за рамки первого этапа.
  • Вы не можете вручную изменить категорию для темы рабочего процесса, если вы не сотрудник.
  • Только пользователи с правами на создание в категории могут выполнять переходы рабочего процесса.

Начало работы:

  1. Включите плагин с помощью process_manager_enabled.
  2. Перейдите в Администрирование -> Плагины -> Process Manager.
  3. Создайте процесс, сохраните его, затем добавьте этапы и опции этапов.
  4. Настройте права доступа к категориям так, чтобы участники процесса имели право на создание тем в соответствующих категориях этапов.
  5. Создайте тему в категории первого этапа.
  6. Выполните переход с помощью кнопок действий темы или взаимодействий на доске Канбан.
  7. Используйте /processes для управления операционной очередью.

Действия ИИ:

ИИ может выполнять действия на этапе с помощью прямой интеграции Process Manager с OpenAI. Это не зависит от Discourse AI.

Требования:

  • Действующий ключ process_manager_openai_api_key
  • ИИ включён на этапе
  • Промпт включает как {{options}}, так и {{topic}}

Пример промпта:

ваши варианты: {{options}}. если следующий текст утверждает, что это вкусно, пожалуйста, примите, иначе отклоните. {{topic}} ответьте одним словом из этих вариантов

Известные проблемы

Этот плагин всё ещё развивается. Пожалуйста, сообщайте об ошибках и идеях по улучшению в репозитории или в этой теме Meta.

26 лайков

Получает немного внимания.

4 лайка

Развёрнуто несколько исправлений:

2 лайка

Делает просмотр более удобным на мобильных устройствах:

  • УЛУЧШЕНИЕ: Список тем рабочего процесса отлично работает на настольных компьютерах, но на мобильных устройствах он слишком широкий. Поэтому вместо добавления всех этих столбцов на мобильных устройствах добавьте значок рабочего процесса к заголовку и ограничьте полный набор столбцов только для настольных компьютеров.
2 лайка

Несколько небольших, но важных изменений.

1 лайк

Привет, Роберт,

Я тестирую плагин рабочих процессов без использования ИИ. Это простой рабочий процесс, предназначенный для использования в качестве цепочки поддержки в Linux-кафе, которое помогает людям мигрировать с Windows. Новые темы создаются через письма RFC 6233 с использованием подадресации и поступают в первую подкатегорию (уровень 1).

Две проблемы:

  1. ID шагов рабочего процесса не уникальны. У меня три шага с одинаковым ID. ??
  2. Действие «start» для входящей темы вызывает ошибку «422 не обрабатываемое содержимое». Возможно, это следствие проблемы №1.
3 лайка

Спасибо за ваше терпение и обратную связь. Я ценю ваш интерес к плагину.

Он ещё немного экспериментальный и, как вы видите, пока получил мало отзывов, поэтому неизбежны некоторые первоначальные проблемы.

Я постараюсь воссоздать ваш рабочий процесс и попытаться воспроизвести проблему.

Тем временем, не могли бы вы сделать скриншот рабочего процесса на экране администратора и поделиться им?

@Thomas_Rother, есть ли у вас трассировка стека для этого?

3 лайка

Привет, Роберт,
без проблем, я понимаю, что это экспериментальная версия. Поэтому она установлена только на тестовом экземпляре с собственным хостингом. Вы можете зарегистрироваться там, и я могу предоставить вам права администратора:

https://forum2.netzwissen.de/login

2 лайка

Хорошо, вот пошаговое руководство того, как у меня получилось:

  • Создал категорию «Билеты в интернет-кафе»
  • Создал все шаги как подкатегории, в результате чего получилось следующее:

Пока всё хорошо.

Теперь давайте создадим шаги:

Хорошо, я вижу как минимум две проблемы! (Хотя одна из них, вероятно, вызвана другой)

Это странно, ведь я был уверен, что это работало ранее. Я сейчас проверю, и если у меня будет время, я скоро выпущу исправление.

3 лайка

@Thomas_Rother, попробуй это:

(Возможно, вам придется удалить и воссоздать затронутые этапы)

2 лайка

Какие наиболее распространённые сценарии использования этого плагина и работает ли он с Gemini Flash 2.0?

Любой бизнес-процесс (в разумных пределах) с несколькими этапами и участниками. Может потребоваться расширение для конкретных интеграций.

В настоящее время поддерживается только OpenAI, но приветствуются pull-запросы (используются Chat Completions, поэтому объем работы невелик).

1 лайк

Отличные новости: теперь вы можете получить статистику для построения диаграмм сгорания (burn-up/down):

  • Добавлена ежедневная задача для создания статистики количества состояний, которую можно использовать в диаграммах сгорания.
  • Добавлена задача, которая проверяет наличие или создаёт два полезных запроса для Data Explorer:
    • Журнал аудита всех переходов.
    • Ежедневные подсчёты экземпляров рабочего процесса на каждом этапе их потока, что упрощает построение диаграмм сгорания (просто экспортируйте результаты).
    • Вы можете предоставить доступ к этим отчётам определённым группам.

Примечание: в настоящее время плагин Discourse Workflow совместим только с состоянием tests-passed из-за изменений в управлении зависимостями gem в рамках крупного обновления упаковки плагинов. Это должно измениться после выпуска следующей стабильной версии.

4 лайка

Я пытаюсь понять, почему мой сайт стал работать медленно…

Предупреждение об устаревании

[PLUGIN discourse-workflow] Уведомление об устаревании: Доступ к site.mobileView или site.desktopView на этапе инициализации сайта устарел. В будущих обновлениях мобильный режим будет определяться размером области просмотра, и, как следствие, использование этих значений при инициализации может привести к ошибкам и несогласованности при изменении размера окна браузера. Пожалуйста, перенесите эти проверки в компонент, трансформер или коллback API, который выполняется во время рендеринга страницы. [устарело с версии Discourse 3.5.0.beta9-dev] [id устаревания: discourse.static-viewport-initialization] [инфо: Designing for Different Devices (Viewport Size, Touch/Hover, etc.)] deprecated.js:62:13

Я очень сомневаюсь, что это вызывает замедление работы вашего сайта!! :laughing: — это предупреждение об устаревании.

С нетерпением жду ваш PR :slight_smile:

1 лайк

Что ж, это больше не должно быть связано с Discourse Workflow, так как я закрыл несколько проблем N+1, в том числе в списке тем и визуализации:

и т.д.

3 лайка

Крупное обновление с несколькими новыми функциями, включая:

  • Новые фильтры списков тем, специфичные для рабочих процессов
  • Флажок «Просрочено»
  • Более подробная метаинформация о рабочем процессе темы
1 лайк

Огромное обновление:

Новый вид Канбан:

  • Добавлен полноценный режим Канбан в /workflow с переключателем Список/Канбан, который отображается только когда в фокусе находится один рабочий процесс, совместимый с Канбан.
    • Внедрена явная валидация совместимости с Канбан (включая детерминированное отображение одной связи) и отображение статуса совместимости в администрировании рабочего процесса.
  • Элементы рабочего процесса теперь можно управлять прямо из Канбан: перетаскивание между юридическими шагами, перемещение шагов с помощью клавиш со стрелками и переход по клику для открытия тем.
  • Повышена надежность при одновременных обновлениях: устаревшие переходы теперь возвращают ошибку 409, отображается четкое сообщение о устаревшем состоянии и инициируется обновление для синхронизации состояния интерфейса.
  • Улучшена удобство использования и понятность доски: опциональные теги Канбан на уровне рабочего процесса, поддержка индикаторов просроченных задач на карточках и стилизация колонок, включая цветные границы колонок по категориям.
5 лайков

Ещё одно крупное обновление: график сгорания задач (burn-up/burn-down) онлайн (в качестве удобной альтернативы существующему встроенному запросу Data Explorer)

  • Добавлен новый вид «График» в разделе Discovery с селектором общего вида (Список / Канбан / График) и управлением периодом (1–12 недель).
    • Реализован API для данных графика сгорания по адресу /discourse-workflow/charts.json, а также интеграция маршрута /workflow/charts.
    • Доступ к графикам регулируется отдельно: администраторы и группы, разрешённые для workflow_charts; графики скрыты от неавторизованных пользователей.
    • Полезная нагрузка графика была ограничена только выбранным контекстом рабочего процесса (selected_workflow_id, selected_workflow_name, series), что исключило неиспользуемый каталог рабочих процессов.
    • Добавлено покрытие запросами/системой и усиление UX: окна полной недели, безопасные для локальной даты метки осей, доступные подписи селектора видов и проверки регрессии рендеринга/состояния графика.

Функция построения графиков должна быть совместима со всеми рабочими процессами:

  • График не требует совместимости с Канбаном, поэтому работает для рабочих процессов, несовместимых с Канбаном.
    • График отображается только тогда, когда текущий список рабочих процессов ограничен ровно одним рабочим процессом.
    • Пользователь должен иметь разрешение на просмотр графиков (администратор или вход в группу workflow_charts_allowed_groups).
    • Если Канбан совместим, в выпадающем списке отображаются варианты Список/Канбан/График.
    • Если Канбан не совместим, в выпадающем списке всё ещё могут отображаться варианты Список/График (при соблюдении двух вышеуказанных условий).
3 лайка

Я выполнил крупную оптимизацию производительности:

4 лайка