---

[I128-2813] Расширить Users/Organisations для заявителей и resolver участников процессов

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.3 >> [I128-2813] Расширить Users/Organisations для заявителей и resolver участников процессов📄 Скачать в DOCX

---

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

Компоненты: ИРБИС 128. Модуль Organisations - Организации, ИРБИС 128. Модуль Users - Управление пользователями

Завершено: 08.09.2026 11:56

1. Цель

Нужно расширить Users/Organisations так, чтобы система могла единообразно определять заявителя, организацию, внешнего участника, сотрудника, подрядчика и делегированного представителя для задач и других workflow-процессов.

В системе должен появиться общий applicant resolver. Он должен возвращать стабильный контекст участника процесса без копирования справочников пользователей, организаций и контактов в модуль Tasks или TaskPortal.

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

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

• Реализовать resolver, который по входному контексту пользователя, публичного токена, контакта или организации возвращает безопасный applicant context.

• Поддержать связь заявителя с организацией и делегирование действия от имени организации, если это разрешено политикой.

• Поддержать проверку подтвержденных контактов: email, телефон или другой доступный канал. Неподтвержденный контакт не должен автоматически давать права на просмотр чужих обращений.

• Поддержать inactive/deleted/merged состояния пользователей, контактов и организаций. Resolver должен возвращать предсказуемый результат и диагностируемую причину отказа.

• Обеспечить API для модулей-потребителей: получить applicant context, проверить принадлежность к организации, проверить право действовать от имени организации, получить безопасное отображаемое имя.

• Исключить хранение task-specific ролей внутри Users/Organisations. Такие роли, как автор задачи, наблюдатель, исполнитель или заявитель конкретной задачи, остаются в Tasks и ссылаются на субъектов через общий resolver.

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

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

Users/Organisations владеет справочниками субъектов, их связями, контактами, состояниями и resolver.

Tasks хранит только роли внутри конкретной задачи и ссылки на субъектов.

TaskPortal строит пользовательский интерфейс и не реализует собственную модель контактов или организаций.

Security принимает окончательное решение о доступе к объектам и полям по переданному контексту.

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

• Модуль возвращает applicant context для авторизованного пользователя, внешнего контакта, организации и делегированного представителя.
• Задача может ссылаться на заявителя и организацию без копирования их справочных данных в запись задачи.
• Публичный портал не раскрывает данные задачи, если контакт не подтвержден или не имеет права действовать от имени организации.
• Неактивный, удаленный или объединенный субъект обрабатывается предсказуемо и попадает в диагностику.
• Resolver не содержит логики конкретного workflowпроекта и не знает бизнесправила Tasks.
• API, Help и TestA-сценарии покрывают основные успешные и отказные сценарии.

-

Реализован первый срез applicant resolver для связки Users/Organisations.

Что сделано:

• добавлены __call-функции Users для нормализации заявителя: авторизованный пользователь, внешний подтвержденный контакт, служебная роль;
• добавлены __call-функции Organisations для нормализации организации, контактных лиц и объяснимой проверки связи заявителя с организацией;
• новые функции не добавлены телами в api.php: там оставлены только PHPDoc @method-декларации по аналогии с Database;
• добавлены системные JSONописания resolverконтрактов;
• добавлены Help-страницы Users/ApplicantResolver и Organisations/ApplicantResolver;
• добавлены safe-read TestA проверки для Users и Organisations.

Границы ответственности:

• Users определяет заявителя и безопасное отображаемое имя;
• Organisations определяет организационный контекст и связь заявителя с организацией;
• Security остается владельцем финального решения доступа;
• Tasks/TaskPortal должны только потреблять готовый applicant context.

Проверки:

• php -l для всех новых и измененных PHP/inc файлов;
• JSON parse для modules/Users/system/applicantresolver.json и modules/Organisations/system/applicantresolver.json;
• TestA Users: safe-read, 6/6 passed;
• TestA Organisations: safe-read, 6/6 passed;
• targeted structural TestA для всех новых __call: passed;
• git diff --check: clean.

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

1.1. 🔗 blocks: I128-2804

1.2. 🔗 blocks: I128-2811

1.3. 🔗 blocks: I128-2817

1.4. 🔗 blocks: I128-2822

1.5. 🔗 blocks: I128-2827

1.6. 🔗 blocks: I128-2831

1.7. 🔗 blocks: I128-2839

1.8. 🔗 blocks: I128-2797