---

[I128-2798] Реализовать HealthCheck для workflow-проектов и задач

---

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

---

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

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

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

1. Цель Реализовать системный модуль HealthCheck для проверки конфигурации, runtime-готовности и publication gate системных и предметных модулей ИРБИС 128.

2. Контекст HealthCheck должен стать единым местом запуска и просмотра проверок готовности. Содержательные проверки поставляют модули-владельцы: Workflow*, Tasks, EventBus, Queue, FT, Security, FieldConfiguration и другие. HealthCheck управляет registry, запуском, агрегацией, хранением результатов, уровнем критичности, publication gate и безопасной диагностикой.

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

• Ввести provider registry: модуль регистрирует проверки через system JSON definitions и __call/HealthCheck-функции, не требуя жесткой зависимости в ядре HealthCheck.

• Ввести модель HealthCheckRun: инициатор, режим запуска, scope, target object, started/finished, trace id, status, summary и ссылка на результаты.

• Ввести модель HealthCheckResult: provider, check key, severity, entity reference, message, details, remediation, safe payload, timestamps и статус актуальности.

• Поддержать уровни blocker, warning и info. Blocker должен уметь останавливать публикацию конфигурации или rollout, если проверка относится к обязательному gate.

• Реализовать publication gate для workflowпроектов, системных JSON definitions, публичных форм, views, rights schemes и runtimeинтеграций.

• Реализовать запуск вручную, из setup/update/import, из публикации конфигурации, из TestA, из CI и через Queue для тяжелых проверок.

• Реализовать result retention: хранение последних результатов, история запусков, очистка старых результатов, сравнение current/previous.

• Реализовать безопасный diagnostic export в JSON, пригодный для CI, TestA evidence и передачи разработчику.

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

• Поддержать autofix только как отдельную безопасную providerоперацию с dry-run, правами и audit. Обычный check не должен менять данные.

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

• HealthCheck не должен знать доменную структуру Tasks, Workflow*, EventBus, Queue, FT или Security.

• HealthCheck не должен сам исправлять данные в ходе проверки.

• Модуль-владелец отвечает за смысл конкретной проверки и remediation, HealthCheck отвечает за запуск, aggregation, gate и вывод.

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

• Модуль может зарегистрировать новую проверку без изменения ядра HealthCheck.

• Администратор видит единый отчет с группировкой по severity, владельцу, сущности и remediation.

• Publication gate блокирует публикацию при обязательных blocker-ах и не может быть ослаблен обычной настройкой.

• Результаты доступны для TestA/CI в стабильном JSON-формате.

• Тяжелая проверка может запускаться через Queue и сохраняет trace id.

• Диагностика не раскрывает секреты, скрытые поля и персональные данные сверх прав пользователя.

  1. Проверки И Документация Нужно подготовить TestAсценарии для provider registry, успешной проверки, blocker gate, warning/info, result retention, JSON export, прав просмотра, Queue execution и интеграции с системными definitions. В Help должны быть описаны запуск проверок, чтение отчета, разработка providerов и типовые remediation.

-

Реализован первый независимый срез системного модуля HealthCheck для I128-2798.

Что сделано:

• добавлен модуль modules/HealthCheck с DTO HealthCheckContext, HealthCheckResult, HealthCheckProviderRun и HealthCheckRun;
• добавлен runtime registry provider-ов HealthCheck;
• добавлена загрузка декларативных provider definitions из JSON modules//healthcheck/*.json;
• selfprovider HealthCheck поставляется через JSON и выполняется стандартной __callфункцией HealthCheck/Self;
• добавлен синхронный запуск проверок, агрегация blocker/warning/info и provider failure;
• добавлена оценка publication gate: blocker запрещает публикацию, warning требует подтверждения, info не блокирует;
• добавлено техническое хранение JSON-отчетов в DataPath/HealthCheck/Reports с retention cleanup;
• добавлены __callметоды, TestAпроверка и Help-документация.

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

• HealthCheck не содержит доменную логику Tasks, Workflow, EventBus, Queue, FT или Security;
• модуливладельцы будут поставлять собственные HealthCheck providerы и отвечать за смысл своих проверок;
• Queue, Security, TraceContext, TestA и Help остаются внешними контрактами, а не частью доменной логики HealthCheck.

Проверено:

• php l для всех PHP/INCфайлов modules/HealthCheck;
• JSON selfproviderа проверен через ConvertFrom-Json;
• git diff --check;
• TestA: http://irbis128.local/?id=WIrbis&action=TestA/RunSuite&module=HealthCheck&testedOnly=0&structural=1&levels=safe~~read&runid=I128~~2798~~healthcheck~~contract~~json~~1;
• результат TestA: total=16, passed=16, failed=0, skipped=0, blocked=0, warning=0.

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

1.1. 🔗 blocks: I128-2799

1.2. 🔗 blocks: I128-2801

1.3. 🔗 blocks: I128-2806

1.4. 🔗 blocks: I128-2807

1.5. 🔗 blocks: I128-2808

1.6. 🔗 blocks: I128-2809

1.7. 🔗 blocks: I128-2810

1.8. 🔗 blocks: I128-2811

1.9. 🔗 blocks: I128-2814

1.10. 🔗 blocks: I128-2816

1.11. 🔗 blocks: I128-2817

1.12. 🔗 blocks: I128-2818

1.13. 🔗 blocks: I128-2820

1.14. 🔗 blocks: I128-2821

1.15. 🔗 blocks: I128-2822

1.16. 🔗 blocks: I128-2824

1.17. 🔗 blocks: I128-2825

1.18. 🔗 blocks: I128-2826

1.19. 🔗 blocks: I128-2827

1.20. 🔗 blocks: I128-2828

1.21. 🔗 blocks: I128-2829

1.22. 🔗 blocks: I128-2830

1.23. 🔗 blocks: I128-2831

1.24. 🔗 blocks: I128-2832

1.25. 🔗 blocks: I128-2833

1.26. 🔗 blocks: I128-2834

1.27. 🔗 blocks: I128-2835

1.28. 🔗 blocks: I128-2836

1.29. 🔗 blocks: I128-2837

1.30. 🔗 blocks: I128-2838

1.31. 🔗 blocks: I128-2839

1.32. 🔗 blocks: I128-2840

1.33. 🔗 blocks: I128-2793

1.34. 🔗 blocks: I128-2797