---

[I128-2809] Сохраненные и материализованные фильтры WorkflowFilter

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.3 >> [I128-2809] Сохраненные и материализованные фильтры WorkflowFilter📄 Скачать в DOCX

---

Тип	Версия	Статус	Приоритет	Исполнитель
⚙️ Новые возможности	2026.3	🔘 Завершено	Средний	Ilya Mikhaylenko

Компоненты: Нет

Завершено: 08.09.2026 13:50

1. Цель

Нужно выделить WorkflowFilter как самостоятельный универсальный механизм сохраненных, проектных, общих, личных и материализованных фильтров workflowзаписей. Фильтр должен быть единым источником выборки для WorkflowView, dashboardсчетчиков, подписок, досок, календарей, портальных списков и внутренних очередей.

1. Контекст

Задачи Tasks и заявительский портал TaskPortal требуют списков активных задач, личных обращений, задач на приемку, FAQ/knowledge views, просроченных задач, очередей команды и других выборок. Эти выборки не должны реализовываться отдельными SQL/PFT/pageфрагментами в каждом модуле. Логика фильтрации должна быть общей, rightsaware и пригодной для materialized slices.

WorkflowFilter является частью семейства Workflow, но его scope достаточно самостоятелен: определение фильтра, исполнение, параметры, права, materialized slices, counters, subscriptions, whereused и impact analysis. Поэтому его нужно вести отдельной Jiraзадачей, а не прятать внутри общей задачи WorkflowScreen/WorkflowView.

1. Что Нужно Сделать

Нужно реализовать запись WorkflowFilter с ключом, названием, описанием, областью видимости, project/workflow binding, типом записи, параметрами, правами и признаком системности.

Фильтр должен описывать query по workflow-состоянию, типу записи, проекту, полям, участникам, датам, статусам API, правам и безопасным параметрам URL или формы. Фильтр должен возвращать только записи, доступные текущему пользователю.

Нужно реализовать общий API исполнения фильтра, пригодный для WorkflowView list/card, dashboard-счетчиков, подписок, WorkflowBoard, WorkflowCalendar, TaskPortal и внутренних очередей Tasks.

Нужно поддержать системные, проектные, общие и личные фильтры. Личный фильтр не должен становиться source of truth для проектного view. Персональные preference, избранное, порядок, фильтр по умолчанию и последние параметры должны храниться в ProfileManager, а не внутри WorkflowFilter.

Нужно реализовать materialized slices для тяжелых фильтров. Slice должен хранить версию фильтра, время пересчета, trace id, diagnostic state и признак устаревания. Пересчет тяжелых slices должен выполняться через Queue, а invalidation может запускаться через EventBus.

Нужно реализовать preview результата для администратора с учетом прав тестового пользователя, where-used по views, boards, calendars, subscriptions, menu и dashboards, а также impact analysis при изменении или удалении фильтра.

Нужно реализовать policy подписки на фильтр. WorkflowFilter определяет возможность подписки и исполняет выборку, EventBus отвечает за доставку, Queue за расписание, ProfileManager за пользовательскую привязку подписки.

1. Границы Ответственности

WorkflowFilter владеет определением фильтра, исполнением выборки, safe parameters, materialized slices, counters, where-used, impact analysis и policy подписки.

WorkflowFilter не рисует страницы, не хранит пользовательские preference, не доставляет уведомления, не планирует фоновые задания и не содержит taskspecific бизнеслогику. Эти части остаются у WorkflowView, ProfileManager, EventBus, Queue и доменных модулей.

1. Критерии Приемки

Можно создать системный фильтр и выполнить его через общий API с учетом прав текущего пользователя.

WorkflowView может использовать WorkflowFilter для списка и карточки без собственного частного механизма выборки.

Тяжелый фильтр может иметь materialized slice, пересчет через Queue и понятное состояние freshness.

Preview администратора показывает результат с учетом прав тестового пользователя и объясняет ограничения выборки.

Удаление или изменение фильтра показывает where-used и блокируется, если фильтр используется опубликованным view, board, calendar или subscription.

Личные preference фильтра хранятся вне WorkflowFilter и не расширяют права пользователя.

1. Проверки И Документация

TestA должен проверять системный фильтр, проектный фильтр, личный фильтр, права, safe URL parameters, materialized slice, invalidation, where-used, запрет удаления используемого фильтра и интеграцию с WorkflowView.

Help должен описывать настройку фильтров, параметры, права, materialized slices, preview, where-used, подписки и диагностику производительности.

-

Задача I128-2809.

Что сделано:

• расширен ObjectDataWorkflowFilter: описание, область видимости, версия, материализация, TTL, разрешение подписок;
• добавлен ObjectDataWorkflowFilterSlice для материализованных срезов фильтра;
• добавлен runtime API WorkflowFilter: безопасная нормализация HTTPпараметров, BuildFilterSrc, Explain/Count/Execute/Preview, freshness, whereused, impact/delete contract;
• фильтр статусов строится по стандартным индексам состояния Workflow в поле 113: WFSTATEOWNERSTATUS / WFSTATESIDSTATUS;
• системный импорт Workflow и импорт проекта из JSON пробрасывают новые поля фильтров;
• системный VREF JSON дополнен метаданными фильтров и типами request filters;
• обновлены русские подсказки редактора, Help и TestA для WorkflowFilter.

Границы:

• WorkflowFilter не берет на себя доставку событий, фоновые задания и пользовательские предпочтения;
• EventBus остается владельцем инвалидации и доставки;
• Queue остается владельцем фонового пересчета;
• ProfileManager остается владельцем пользовательских подписок;
• Security остается владельцем прав доступа.

Проверки:

• php -l по измененным PHP/inc файлам;
• JSON parse modules/VirtualRef/workflow/vref.json;
• git diff --check;
• TestA WorkflowFilter saferead: 4/4 passed, runid 20260904110954fdaf6e9b;
• TestA WorkflowFilter structural: 6/6 passed, runid 20260904110955-f703765c.

1. Связанные задачи

1.1. 🔗 blocks: I128-2810

1.2. 🔗 blocks: I128-2811

1.3. 🔗 blocks: I128-2814

1.4. 🔗 blocks: I128-2821

1.5. 🔗 blocks: I128-2822

1.6. 🔗 blocks: I128-2840

1.7. 🔗 blocks: I128-2790

1.8. 🔗 blocks: I128-2791

1.9. 🔗 blocks: I128-2793

1.10. 🔗 blocks: I128-2794

1.11. 🔗 blocks: I128-2795

1.12. 🔗 blocks: I128-2797

1.13. 🔗 blocks: I128-2798

1.14. 🔗 blocks: I128-2799