---

[I128-2791] Расширить WorkflowScreen/WorkflowView для публичных ws-форм и представлений

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.3 >> [I128-2791] Расширить WorkflowScreen/WorkflowView для публичных ws-форм и представлений📄 Скачать в DOCX

---

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

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

Завершено: 08.09.2026 12:29

1. Цель Расширить WorkflowScreen и WorkflowView так, чтобы они могли строить публичные и внутренние формы, списки и карточки объектов workflow-проекта по конфигурации, без показа обычному пользователю редактора he3 и без частной верстки в предметных модулях.

2. Контекст Пользовательские сценарии вроде создания обращения, просмотра списка своих объектов, просмотра карточки и выполнения действия должны настраиваться на уровне WorkflowScreen/WorkflowView. Предметный модуль задает тексты, тип записи, маршрутизацию и доменные post-functions, но базовый renderer, draft, apply, безопасность и маршруты должны быть общими.

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

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

• Реализовать публичный renderer ws, который показывает обычную HTML-форму, а не he3. Renderer должен поддерживать ограниченный и безопасный набор методов ввода, достаточный для пользовательских форм.

• Расширить семантику методов ввода 128001 и 128002: настройки таких полей должны задаваться в DopInf в JSON, чтобы форма могла штатно сохраняться без предварительного заполнения техническими форматами.

• Реализовать WorkflowScreenDraft: временное состояние формы, связанное с версией экрана, пользователем или публичной сессией, вложениями и сроком жизни.

• Реализовать штатный apply данных формы в запись через общий workflow/apply-контракт и стандартное сохранение записи, без частного маппинга полей внутри предметного модуля.

• Поддержать загрузку файлов через TemporaryFiles с последующим переносом в постоянное хранилище FT после успешного сохранения.

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

• Поддержать варианты WorkflowView для desktop, tablet, mobile, print и embed так, чтобы вариант не расширял права пользователя и не дублировал независимую логику.

• Поддержать страницы списка и страницы карточки объекта workflow-проекта, которые могут заменить частные страницы ShowWorker, ShowMyWorker, ShowDone, FAQ и аналогичные страницы предметных модулей.

• Реализовать понятные ошибки для недоступной формы, устаревшей версии draft, нарушения прав, отсутствующего маршрута, ошибки вложения и ошибки сохранения.

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

• WorkflowScreen/WorkflowView не должны содержать предметную логику Tasks, VirtualRef или конкретного типа записи.

• Renderer не должен исполнять произвольный HTML, JavaScript, серверные команды или небезопасные методы ввода из ws.

• Проверка прав на форму, view, поле, действие и вложение должна выполняться через Security.

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

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

• Публичный пользователь может заполнить форму, созданную из ws, не видя he3.

• Внутренний пользователь может открыть форму действия workflow, заполнить поля, прикрепить файлы и выполнить переход штатным механизмом.

• Изменение версии ws не ломает уже открытый draft: система либо применяет совместимое сохранение, либо показывает понятную ошибку.

• Список объектов строится из WorkflowView с колонками, фильтром, сортировкой, пагинацией и действиями без частной разметки предметного модуля.

• Страница карточки объекта строится по конфигурации и показывает доступные workflow-действия с учетом прав.

• Mobile/print/embed варианты не раскрывают скрытые поля и не дают дополнительных действий.

  1. Проверки И Документация Нужно подготовить TestA-сценарии для render/apply/draft, public form, internal action screen, upload staging, устаревшей версии формы, прав на поля, маршрутов view, пагинации и вариантов отображения. В Help должны быть описаны настройка экранов, представлений, публичных форм, маршрутов и безопасных методов ввода.

-

Срез по I128-2791.

Что сделано:

• WorkflowScreen получил публичные настройки screen: scope, version, publicEnabled, publicSupportedWidgets, draftTtl.
• Добавлен ObjectDataWorkflowScreenDraft с payload, TTL и диагностическими 1288-индексами.
• RenderPublicForm и ApplyPublicFormToRecord используют общий ValidatePublicFormSchema и ограниченный whitelist input methods.
• WorkflowView получил description, canonicalRoute и variants для desktop/tablet/mobile/print/embed без расширения прав.
• Добавлен универсальный page wrapper WorkflowView/ShowCreate; ShowList/ShowRecord приведены к TestA structural contract.
• System JSON import/sync поддерживает новые поля screen/view; системный VirtualRef VREF askscreen разрешен как публичная createформа.
• Help обновлен для WorkflowScreen и WorkflowView.

Границы среза:

• Полный storage pipeline TemporaryFiles > FT остается внешним контрактом I1282796; текущий apply использует штатные storage-binding правила he3 для полей 128001/128002.
• WorkflowFilter/materialized filters остаются в I128-2809.

Проверки:

• git diff --check: ok.
• php -l по измененным api.php, __call, page и TestA файлам: ok.
• TestA WorkflowScreen saferead: 202609041040112728cb63, total=3, passed=3.
• TestA WorkflowScreen structural: 20260904103822-3f6b7783, total=7, passed=7.
• TestA WorkflowView saferead: 2026090410380746db85e1, total=1, passed=1.
• TestA WorkflowView structural: 20260904103822-ba9e3231, total=6, passed=6.

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

1.1. 🔗 blocks: I128-2801

1.2. 🔗 blocks: I128-2803

1.3. 🔗 blocks: I128-2809

1.4. 🔗 blocks: I128-2810

1.5. 🔗 blocks: I128-2811

1.6. 🔗 blocks: I128-2814

1.7. 🔗 blocks: I128-2816

1.8. 🔗 blocks: I128-2821

1.9. 🔗 blocks: I128-2822

1.10. 🔗 blocks: I128-2825

1.11. 🔗 blocks: I128-2826

1.12. 🔗 blocks: I128-2839

1.13. 🔗 blocks: I128-2840

1.14. 🔗 blocks: I128-2790

1.15. 🔗 blocks: I128-2797