---

[I128-2800] Каноническая запись задачи TASK

---

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

---

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

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

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

1. Цель Создать каноническую recordbased модель задачи TASK для ИРБИС 128: стабильный тип записи, набор обязательных полей, правила генерации ключа, связи, workflowсостояние, история действий, базовые права и внутренний API доступа к данным задачи.

2. Контекст Модуль Tasks должен хранить задачу как обычную запись ИРБИС 128 и использовать общие системные механизмы, а не дублировать их внутри себя. Workflowсостояние хранится через стандартную LINKсвязь 113 с проектом workflow и текущим статусом. Человекочитаемая история действий пишется в стандартное поле 907. Права проверяются через Security. Описания полей должны быть связаны с общим реестром полей, но task-specific состав полей и их смысл принадлежат модулю Tasks.

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

• Ввести базовый тип записи задачи с системным типом TASK. Дополнительные task-like типы v920 допускаются только как расширяемость архитектуры, если конкретному проекту нужна другая структура данных.

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

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

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

• Хранить workflow-состояние задачи через LINK 113: запись должна ссылаться на проект workflow и текущий статус в этом проекте. Одна задача должна иметь возможность участвовать в нескольких workflow, если проект явно так настроен.

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

• Поддержать связи задачи с другими задачами и произвольными записями ИРБИС 128 через типизированные LINK-связи 113.

• Поддержать ссылки задачи на этап, версию и поставку через отдельные taskspecific записи TaskStage, TaskVersion и TaskDelivery. В первом контуре они нужны как управляемые записи с ключом, названием, проектом, датами, состоянием, ответственным, правами, историей и whereused, но без выделения отдельного механизма релизов.

• Поддержать ссылки на вложения и внешние URL как часть данных задачи, используя системное файловое хранилище и безопасные reference-объекты, а не частное хранение файлов внутри Tasks.

• Подготовить task field pack: стабильные ключи полей, русские названия, типы данных, назначение, участие в списках, карточке, формах, API, экспорте, поиске, истории и правах.

• Задать базовые permission keys модуля Tasks: просмотр, создание, изменение, назначение, выполнение действия, просмотр приватных данных и администрирование task-specific настроек. Реальная проверка выполняется через Security.

• Подготовить внутренние методы поиска задачи по ключу и безопасного получения карточки задачи по object reference.

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

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

• Tasks владеет доменной записью задачи, смыслом taskspecific полей, taskspecific ключами прав, связями задачи, stage/version/delivery-сущностями первого контура и внутренним API задачи.

• Tasks не реализует workflow engine, хранение системных workflow-конфигураций, Security engine, FieldConfiguration engine, FT storage, EventBus, Queue, HealthCheck или TestA framework.

• Tasks не должен читать и менять чужие runtime-структуры напрямую, если для этого есть общий API или object reference.

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

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

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

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

• Задача хранит workflow-состояние через LINK 113 и корректно возвращает текущее состояние для заданного проекта.

• Значимое действие над задачей добавляет понятную запись в поле 907.

• Связи с задачами, произвольными записями, этапом, версией, поставкой, вложениями и внешними ссылками доступны через единый контракт.

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

• Базовые permission keys описаны и применяются через Security без обходных проверок в UI или API.

• Task field pack достаточен для форм, списков, карточки, поиска, экспорта, истории и документации.

  1. Проверки И Документация Нужно подготовить TestA-сценарии для создания, чтения, изменения, поиска по ключу, проверки уникальности ключа, LINK 113, истории 907, связей, прав доступа и маскирования скрытых полей. В Help нужно описать модель записи TASK, обязательные поля, ключ, связи, историю, базовые права и правила использования внутреннего API Tasks.

-

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

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

1.1. 🔗 blocks: I128-2801

1.2. 🔗 blocks: I128-2802

1.3. 🔗 blocks: I128-2803

1.4. 🔗 blocks: I128-2804

1.5. 🔗 blocks: I128-2805

1.6. 🔗 blocks: I128-2810

1.7. 🔗 blocks: I128-2811

1.8. 🔗 blocks: I128-2838

1.9. 🔗 blocks: I128-2823

1.10. 🔗 blocks: I128-2790

1.11. 🔗 blocks: I128-2797

1.12. 🔗 blocks: I128-2825