---

[I128-2811] Заявительский портал TaskPortal

---

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

---

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

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

Завершено: 07.09.2026 08:08

1. Цель

Нужно создать отдельный модуль TaskPortal для публичного и авторизованного пользовательского сценария заявителя. Заявитель должен создавать обращение, видеть свои задачи, читать публичные ответы, добавлять разрешенные комментарии и вложения, принимать результат или возвращать его на доработку без доступа к внутреннему рабочему месту сотрудников и без показа редактора he3.

1. Контекст

TaskPortal является portal shell и UX-слоем над Tasks, WorkflowView, WorkflowScreen, WorkflowFilter, Security, EventBus, Collaboration, FT и AbuseProtection. Он не является вторым модулем задач и не хранит канонические данные задачи, комментариев, файлов, workflow или прав.

Портал нужен для промышленного selfservice сценария: публичная или авторизованная форма обращения, личный список обращений, публичная карточка, безопасные публичные статусы, непрочитанные ответы, подтверждение контактов, приемка результата и повторное открытие по разрешенному workflowпереходу.

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

Нужно реализовать модуль TaskPortal с сущностями TaskPortalProfile, TaskPortalPage, TaskPortalSession, TaskPortalSubmitResult и TaskPortalUnreadMarker. Профиль портала должен задавать стартовую страницу, доступные блоки, navigation, fallback pages и привязку к опубликованным WorkflowView/WorkflowScreen.

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

Форма создания и формы действий должны строиться через публичный renderer WorkflowScreen из ws. Заявителю нельзя показывать he3. Длинные формы должны поддерживать черновик через WorkflowScreenDraft, безопасную загрузку файлов через TemporaryFiles и перенос вложений в FT после успешного сохранения.

Списки и карточки должны строиться через WorkflowView и WorkflowFilter. Портал не должен хранить собственную частную разметку списков и карточек, если это можно описать через общие workflow-представления. Списки заявителя должны показывать только доступные ему задачи и поддерживать фильтрацию по статусу, проекту, типу обращения, дате, непрочитанным ответам и требующим действия обращениям.

Доступ должен проверяться через Security с учетом пользователя или анонимного principal, host context, PublicationScheme, проекта, view/screen, задачи, токена публичной карточки и срока действия ссылки. Ошибка доступа не должна раскрывать существование закрытой задачи.

Для анонимного обращения нужно поддержать последующую привязку к учетной записи после подтверждения email или авторизации. Профиль заявителя должен учитывать учетную запись, подтвержденные контакты, организацию, предпочтительный канал связи и язык уведомлений. Исторические задачи не должны менять контактные данные задним числом без явного действия.

Комментарии заявителя, публичные ответы сотрудников, запросы уточнения и упоминания должны проходить через Collaboration. Вложения сообщений должны храниться через FT, а не внутри TaskPortal. Непрочитанные ответы и уведомления должны формироваться через EventBus и внутренние каналы доставки.

Нужно поддержать этап приемки результата заявителем. Если workflow проекта разрешает действие, заявитель должен видеть "Принять результат" и "Вернуть на доработку". Возврат должен требовать комментарий или настроенный экран причины. Автоматическое закрытие после ожидания приемки должно выполняться через Queue, если это включено проектом.

Если проект включает оценку качества обслуживания, портал должен показывать форму оценки после приемки или закрытия. Форма оценки не должна раскрывать внутреннюю историю, комментарии и участников задачи. Оценка должна учитывать право просмотра и запрет повторной оценки по настройке проекта.

Нужно реализовать Help и TestA для публичного и авторизованного пути заявителя: создание обращения, личный список, публичная карточка, комментарий, вложение, непрочитанный ответ, приемка результата, возврат на доработку, безопасная ошибка доступа, host-ограничение и replay protection.

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

TaskPortal владеет портальной оболочкой, заявительской навигацией, post-submit UX, публичной карточкой, личными списками заявителя, безопасным DTO портала, unread markers и UX приемки результата.

TaskPortal не владеет записью задачи, workflow-переходами, правами, публикацией страниц, renderer ws, фильтрами, хранением комментариев, файловым хранилищем, событиями, очередями, антиспамом и доставкой уведомлений. Эти функции остаются у Tasks, Workflow*, WorkflowScreen, WorkflowView, WorkflowFilter, Security, FT, Collaboration, EventBus, Queue, AbuseProtection и транспортных модулей.

TaskPortal не заменяет Cabinet. Cabinet может дать точку входа или ссылку на портал, но не становится владельцем страниц задач.

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

Заявитель может создать обращение через публичную или авторизованную форму без доступа к he3.

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

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

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

Заявитель может добавить комментарий, ссылку или вложение только через разрешенное workflowдействие и только после проверки прав и antiabuse policy.

Действия "Принять результат" и "Вернуть на доработку" выполняются как workflow-переходы и фиксируются в истории задачи.

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

Непрочитанные ответы отображаются в личном списке и карточке заявителя, а их расчет не требует прямого обхода внутренней модели EventBus или Collaboration.

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

TestA должен проверять публичный и авторизованный happy path, запрет he3, права просмотра, host visibility, безопасные ошибки доступа, черновик формы, загрузку вложения, replay/idempotency, комментарий, приемку результата, возврат на доработку и непрочитанные ответы.

Help должен содержать руководство заявителя, администратора и программиста: настройка профиля портала, публикация страниц, привязка WorkflowView/WorkflowScreen, права доступа, публичные ссылки, обработка ошибок, ограничения и диагностика.

-

Реализован первый кодовый срез Tasks Core.

Что сделано:

• добавлен новый модуль Tasks и ObjectDataTask поверх обычной ObjectDataRecord;
• зафиксирована структура записи TASK: ключ 7^A, проект 7^B, заголовок/описание, классификация, сроки, участники, этап/версия/поставка;
• добавлены индексы TASK* через 1288 и использование стандартных индексов Workflow-состояния;
• состояние Workflow хранится через 113 LINK, история пишется через стандартный Workflow.AppendRecordHistory в 907;
• добавлены типизированные связи с задачами и произвольными записями, безопасные ссылки на FT/URL;
• добавлены редакторские переменные, Help и TestA safe-read проверка.

Границы:

• Tasks не реализует Workflow, Security, FT, FieldConfiguration или UI рабочего места; эти контракты остаются у owner-модулей.

Проверки:

• php -l modules/Tasks/api.php;
• php -l modules/Tasks/__call/Variables.inc;
• php -l modules/Tasks/Tests/Module.inc;
• TestA RunTarget Tasks/module/Module: 6/6 passed;
• TestA structural Tasks/__call/Variables: passed;
• git diff --check: без ошибок.

-

Стековый PR поверх #1302 / I128-2800, потому что базовый контракт записи Tasks еще не в develop. После merge #1302 ветку нужно будет перебазировать или retarget на develop.

Что сделано:

• добавлен системный Workflow JSON проекта TASK: workflow, статусы, переходы, screen/filter/view schemes, стартовые представления;
• добавлена поставка стандартных WS/WSS/MNU-файлов экранов Tasks через SetupModuleConfigure;
• добавлены Workflow-команды Tasks.NormalizeRecord и Tasks.SetClosedFlag;
• добавлены pft128-форматы колонок и карточки для WorkflowView;
• обновлены Help и TestA-проверки модуля Tasks.

Проверки:

• php l по новым __call, Workflowкомандам, форматам и Tests/Module.inc;
• json_decode modules/Tasks/workflow/tasks.json;
• git diff --check;
• TestA Tasks/Module safe-read: 9/9.

-

Реализован кодовый срез I128-2803: рабочее место задач и внутренний API модуля Tasks.

Что изменено:

• добавлены тонкие страницы Tasks для списков, создания и карточки задачи: Show, list, my, created, new, done, all, create, card;
• добавлены __call-функции Tasks для рендера страниц, получения списка/карточки, обновления полей, применения перехода и массового перехода;
• списки и карточка строятся через WorkflowView/WorkflowFilter, формы через WorkflowScreen/ws/he3, переходы через Workflow;
• обновлены canonical URL в колонках задач и системный JSON проекта TASK;
• добавлены Helpматериалы и TestAпроверки рабочего места.

Границы:

• Tasks не реализует собственный workflow-engine, фильтры, права, файловое хранилище или событийную шину;
• логика остается доменной: task-specific страницы, DTO, тексты, маршруты и безопасные обертки внутреннего API.

Проверки:

• PHP lint новых и измененных php/inc/page/pft128 файлов;
• tasks.json успешно разбирается как JSON;
• HTTP smoke: Tasks/list, Tasks/my, Tasks/create, Tasks/card отдают 200 без PHP-ошибок и без сообщения об отсутствующем WorkflowProject;
• TestA Tasks safe-read: 10/10;
• TestA Tasks safe-read structural: 36/36;
• git diff --check без ошибок, только стандартные предупреждения LF -> CRLF.

-

Реализован кодовый срез I128-2804 для модуля Tasks.

Что изменено:

• расширена доменная модель ObjectDataTask: тип обращения, сервис, компонент, уровень влияния, чек-листы, участники, impact refs и типизированные связи через стандартный 113 LINK;
• добавлены API GetTaskDomainModel и ApplyTaskTemplate;
• расширены системные JSON definitions Tasks: справочники, шаблоны, фильтры, колонки и секции карточки;
• обновлены ws/wss/mnu definitions экранов WorkflowScreen для доменной классификации;
• добавлены форматы карточки/колонки и Help по доменной модели;
• расширен TestA Tasks на новые поля, индексы, 113 LINK и шаблоны.

Границы:

• Tasks владеет только task-specific моделью и post/config contract;
• Workflow, WorkflowFilter, WorkflowScreen/View, Security, FieldConfiguration, FT, Users/Organisations и FindDublet остаются внешними owner-модулями.

Проверки:

• PHP lint измененных файлов;
• JSON parse modules/Tasks/workflow/tasks.json;
• TestA Tasks safe-read explicit: 12/12;
• TestA Tasks safe-read structural: 40/40;
• SetupModuleConfigure Tasks: ok;
• HTTP smoke: ?id=Tasks/list&project=TASK, ?id=Tasks/list&project=TASK&page=list&type=incident&service=platform, ?id=Tasks/card&project=TASK&key=TASK-1 returned 200 без Fatal/Warning/Notice.

-

1. Что сделано

• Расширен ObjectDataTask полями SLA, пауз SLA, очереди, OLA-линий, таймеров, контрольных дат и результата ранжирования.

• Добавлены taskspecific __callфункции для объяснения SLA, расчета ранга и подготовки Queue-пересчета.

• Добавлены Workflow-команды Tasks: первый ответ, решение, пауза SLA, снятие паузы, взятие задачи из очереди, ручное повышение ранга.

• Системный проект Tasks расширен экраном SLA/очереди, фильтрами, колонками, секциями карточки и доменными справочниками SLA/OLA/queue/WIP/timer/ranking.

• Добавлены форматы представления, WS/WSS/MNU, Queue handler-ы и Help по SLA/очередям/ранжированию.

  1. Границы

Tasks хранит taskspecific правила, сохраненные результаты, поля, команды и payloadы. WorkCalendar, Queue runtime, EventBus, WorkflowFilter/View, Security и Observability остаются владельцами своих системных контрактов.

1. Проверки

• PHP lint измененных php/inc/pft128: OK, 24 файла.
• JSON parse modules/Tasks/workflow/tasks.json: OK.
• git diff --check: OK.
• Tasks::SetupModuleConfigure(): OK.
• TestA Tasks: total=13, passed=13, failed=0, skipped=0, blocked=0, warning=0.
• HTTP smoke: ?id=Tasks/List, My, New, Done, All, Create - HTTP 200 без PHP warning/fatal.

Target branch: feature/I128~~2804~~tasks~~domain~~entities-relations. Commit: 269dc31177bdb8222dc01291bfda43d3541e6dfd.

-

Задача: I128-2810

Что сделано:

• добавлен профиль миграции vref*to*task в системный JSON Tasks;
• добавлен DTO ObjectDataVirtualRefMigrationProfile и legacy-ссылки TASK в поле 17;
• добавлены API GetVirtualRefMigrationProfile, PlanVirtualRefMigration, ExecuteVirtualRefMigration;
• dryrun строит план без записи данных, ищет дубли по legacyмаркерам и возвращает blockers/warnings/counters;
• production cutover защищен условиями dryRun=false, confirm=cutover, sourceFrozen=true и повторной проверкой плана;
• при переносе создается TASK, сохраняются legacy markers, workflow-state 113, история 907 и snapshot вопроса/ответа;
• обновлены TestA и Help Tasks.

Границы:

• FT, Collaboration, FieldHistory, EventBus, Queue, Security, Workflow*, WorkflowScreen/View/Filter не реализуются внутри Tasks;
• вложения VirtualRef на этом срезе регистрируются как legacy attachment references до полноценного FT-переноса;
• статус источника читается через стандартный WorkflowProject/Workflow по проекту записи, без вызова доменной логики VirtualRef.

Проверки:

• PHP lint: OK;
• tasks.json JSON parse: OK;
• git diff --check: OK;
• Tasks::SetupModuleConfigure(): OK;
• TestA Tasks: total=56, passed=56;
• HTTP smoke Tasks/list, Tasks/my, Tasks/created, Tasks/new, Tasks/done, Tasks/all, Tasks/create: 200, без Fatal/Warning;
• live dry-run VirtualRef migration limit=5: ok=true, blocked=0.

-

Реализован первый кодовый срез TaskPortal для I128-2811.

Что сделано:

• добавлен отдельный модуль TaskPortal как portal shell/UX слой заявителя;
• добавлены системный профиль и страницы home/create/submit/my/list/card/result/acceptance;
• списки и карточка делегируются WorkflowView, форма создания использует публичный renderer WorkflowScreen и Workflow::CreateRecordFromScreen;
• добавлены DTO profile/page/session/unread/submit result и диагностический API ValidatePortalConfiguration;
• добавлены thin .page маршруты, Help и TestA.

Границы:

• TaskPortal не владеет записью TASK, workflowпереходами, правами, файлами, комментариями, событиями, antiabuse и menu publication;
• публичная карточка без авторизации пока не раскрывает запись и ждет resolver безопасных ссылок из зависимостей.

Проверки:

• PHP lint TaskPortal: OK
• task_portal.json parse: OK
• TestA TaskPortal saferead: total=29 passed=29 failed=0 blocked=0, runid i1282811taskportal20260904-160954
• HTTP smoke TaskPortal index/create/my/card/result: 200, без Fatal/Warning/Notice
• git diff --check: OK

Commit: bc92c2a694964333b2ed57891dd04e83b0f97981

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

1.1. 🔗 blocks: I128-2791

1.2. 🔗 blocks: I128-2793

1.3. 🔗 blocks: I128-2794

1.4. 🔗 blocks: I128-2795

1.5. 🔗 blocks: I128-2796

1.6. 🔗 blocks: I128-2797

1.7. 🔗 blocks: I128-2798

1.8. 🔗 blocks: I128-2799

1.9. 🔗 blocks: I128-2800

1.10. 🔗 blocks: I128-2801

1.11. 🔗 blocks: I128-2803

1.12. 🔗 blocks: I128-2804

1.13. 🔗 blocks: I128-2805

1.14. 🔗 blocks: I128-2806

1.15. 🔗 blocks: I128-2808

1.16. 🔗 blocks: I128-2809

1.17. 🔗 blocks: I128-2813

1.18. 🔗 blocks: I128-2814

1.19. 🔗 blocks: I128-2816

1.20. 🔗 blocks: I128-2827