---

[I128-2802] Пакет разработчика, Help и TestA для Tasks

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.3 >> [I128-2802] Пакет разработчика, Help и TestA для Tasks📄 Скачать в DOCX

---

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

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

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

1. Цель Подготовить пакет разработчика, Helpдокументацию, golden dataset и taskspecific TestA-сценарии, чтобы первый промышленный контур Tasks можно было проверять, сопровождать и расширять без знания внутренней реализации модуля.

2. Контекст Tasks должен быть не только пользовательским модулем, но и стабильным доменным контрактом для других модулей ИРБИС 128. Сторонний модуль должен уметь создать задачу из своей записи, передать контекст, открыть связанную карточку и использовать workflowдействия без прямого доступа к физическим полям TASK. TestA и Help являются системными механизмами, но taskspecific сценарии, fixtures, примеры и документация принадлежат модулю Tasks.

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

• Подготовить developer package Tasks: описание стабильного API, DTO, object references, task resolver, правил создания задачи из произвольной записи и открытия связанной карточки.

• Описать стандартный способ, которым прикладной модуль объявляет возможность создать задачу из своей записи: какие параметры передаются, как задается проект, тип задачи, тема, описание, связи, автор, контекст записи, host и представление.

• Зафиксировать, что прикладной модуль не должен работать напрямую с внутренними полями TASK, если задачу можно создать, прочитать или связать через API Tasks, Workflow* или object reference.

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

• Подготовить пример workflowcommand или postfunction модуля-владельца, который работает с задачей через стандартный контекст и не нарушает границы Workflow*.

• Подготовить task-specific TestA scenario package: создание задачи через публичную форму, создание через внутренний экран he3 при наличии такого сценария, списки и карточка через WorkflowView, переход без экрана, переход с экраном WorkflowScreen, запрет перехода без права, запись истории 907 и проверка скрытых секций.

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

• Golden dataset должен разворачиваться воспроизводимо при setup или отдельной административной команде, не содержать реальные персональные данные, секреты, рабочие токены и реальные адреса внешних систем.

• Подготовить expected manifest golden dataset: какие записи, связи, вложения, события, jobs, права, история 907 и диагностические результаты должны существовать после разворачивания и после прохождения сценариев.

• Подготовить сценарии повторного запуска и очистки golden dataset без ручной правки базы.

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

• Подготовить Help для администратора: системный проект, копирование проекта, настройка типов задач, экранов, фильтров, представлений, прав, provider-проверок, demo/golden dataset и восстановление после ошибок.

• Подготовить Help для разработчика: API Tasks, object references, task resolver, создание задачи из записи, workflowcommand, field pack, системные definitions, TestAсценарии, правила deprecation и список внутренних деталей, на которые нельзя опираться.

• Подготовить runbook эксплуатации: проверка установки, запуск HealthCheck, запуск TestA, типовые сбои, безопасная очистка demo/golden данных и сбор диагностического пакета.

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

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

• Tasks владеет taskspecific developer package, примерами интеграции, taskspecific Help, golden dataset и сценариями TestA для доменного контура задач.

• Tasks не реализует движок TestA, движок Help, общий HealthCheck, Workflow*, EventBus, Queue, FT, Security или внешний SDK.

• Публичная API-поверхность для внешних систем не вводится без отдельного решения и реального потребителя; в этой задаче фиксируется внутренний контракт модулей ИРБИС 128.

• Документация не должна использовать локальные абсолютные URL; системные ссылки должны быть относительными.

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

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

• Developer package явно отделяет стабильные контракты от внутренних деталей реализации.

• Golden dataset разворачивается, повторно запускается и очищается воспроизводимо.

• TestAсценарии Tasks проверяют создание, просмотр, workflowпереходы, права, историю 907, скрытые секции, вложения, списки, карточку и диагностический отчет.

• Expected manifest показывает расхождения между ожидаемым и фактическим состоянием набора данных понятным образом.

• Help покрывает пользователя, администратора и разработчика, а runbook позволяет эксплуатации проверить установку и собрать диагностический пакет.

• Известные ограничения первого контура описаны, имеют владельца и срок пересмотра.

  1. Проверки И Документация Нужно подготовить сами TestAсценарии и Helpматериалы как результат задачи. Проверки должны запускаться штатным механизмом TestA. Документация должна быть пригодна для review вместе с feature PR и не оставаться будущей необязательной работой.

-

Реализован первый кодовый срез 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.

-

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

Что сделано:

• добавлен машинно-читаемый developer package Tasks со стабильными API, object references и owner boundaries;
• добавлен helper Tasks.BuildTaskFromObjectReference для создания задачи из произвольной записи без прямой работы с физическими полями TASK;
• добавлены definitions golden dataset, validation и lifecycle plan установки/проверки/очистки;
• добавлены Help-страницы DeveloperPackage, IntegrationExample, GoldenDataset, TestA, Runbook, KnownLimitations;
• добавлены TestA scenario-targets DeveloperPackage и GoldenDataset.

Проверки:

• php l по новым __call и TestAсценариям;
• git diff --check;
• TestA RunSuite module=Tasks safe-read: 19/19;
• TestA DeveloperPackage: 5/5;
• TestA GoldenDataset: 5/5.

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

1.1. 🔗 blocks: I128-2810

1.2. 🔗 blocks: I128-2799

1.3. 🔗 blocks: I128-2800

1.4. 🔗 blocks: I128-2801

1.5. 🔗 blocks: I128-2826