---

[I128-2799] Подготовить TestA-контракты системных JSON и end-to-end сценариев

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.3 >> [I128-2799] Подготовить TestA-контракты системных JSON и end-to-end сценариев📄 Скачать в DOCX

---

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

Компоненты: ИРБИС 128. Модуль Help - Помощь, ИРБИС 128. Модуль TestA - Тестовый модуль

Завершено: 08.09.2026 13:39

1. Цель Подготовить системные TestAконтракты для проверки system JSON definitions, межмодульных contract tests, golden datasets и endto-end сценариев первого промышленного контура ИРБИС 128.

2. Контекст TestA является основным механизмом тестирования в системе. Для новых промышленных модулей нельзя вводить частные CLIобходы и несвязанные сценарии. Каждый модульвладелец должен поставлять свои сценарии, fixtures, expected results и golden datasets в едином формате, а TestA должен уметь запускать и проверять их согласованно.

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

• Зафиксировать формат TestA scenario package: module owner, system value, scenario key, русское название, цель, входные данные, setup, действия, expected state, cleanup, dependencies и expected artifacts.

• Зафиксировать формат fixtures: тестовые пользователи, роли, проекты, записи, workflowконфигурация, файлы, events, queue jobs, rights schemes и healthcheck results должны создаваться воспроизводимо и изолированно.

• Зафиксировать expected outcomes: состояние записи, поля, LINK 113, история 907, events, queue jobs, files, security decisions, health-check results, logs/trace evidence и пользовательские сообщения.

• Поддержать проверку system JSON definitions для Workflow*, Tasks, EventBus, Queue, Security, FT, HealthCheck и других системных поставок.

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

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

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

• Поддержать CI gate через штатный запуск TestA и стабильный result contract, без отдельного нового CLI, если он не соответствует существующему механизму TestA.

• Сформировать evidence/reporting: краткий итог, failed checks, expected/actual diff, trace id, ссылки на test artifacts и безопасный diagnostic output.

• Согласовать Help: администратор должен понимать, как запустить проверки, а разработчик - как добавить сценарий и fixture.

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

• TestA владеет каркасом, форматом сценариев, запуском, отчетом и contract testing conventions.

• Модули-владельцы владеют своими fixtures, expected results и доменными сценариями.

• TestA не должен становиться доменным модулем Tasks или Workflow* и не должен знать внутреннюю бизнес-логику за пределами ожидаемого результата сценария.

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

• Новый модуль может поставить scenario package, который запускается штатным TestA без доработки ядра для каждого сценария.

• System JSON definitions проверяются до публикации или rollout.

• Endtoend сценарий первого промышленного контура проходит цепочку Workflow* -> Tasks -> EventBus -> Queue -> FT -> Security -> HealthCheck.

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

• Отчет TestA пригоден для CI и для ручной проверки разработчиком: видно, что сломалось, где expected/actual diff и какой trace id связан с ошибкой.

• Help содержит инструкции для запуска, добавления сценариев и интерпретации типовых ошибок.

  1. Проверки И Документация В рамках задачи нужно подготовить сами contract tests для формата scenario package, fixtures, expected outcomes, system JSON validation, e2e первого контура, cleanup и reporting. Документация Help должна быть частью результата, а не последующей отдельной доработкой.

-

Реализован первый промышленный срез развития TestA как общесистемного тестового каркаса.

Что входит:

• нормализованный testInfo/manifest для явных тестов: ownerModule, systemValue, levels, requires, dependencies, frCoverage, tags, fixtures, datasets, expectedArtifacts;
• включение testInfo в результаты проверок и опционально в JSON inventory через includeTestInfo=1;
• фильтрация GetInventory по module/type/name;
• environmentProfile и contractVersion=TestA/1.0 в отчете запуска;
• статус unstable в result model и summary;
• совместимая трактовка старых строковых requires: только строки, похожие на имя модуля, проверяются как runtime module dependency;
• scenario ManifestContract и расширенная самопроверка TestA;
• обновление Help по формату GetInfo()/manifest.

Границы:

• TestA не содержит доменную логику Tasks, Workflow*, EventBus, Queue, FT, Security или HealthCheck;
• модуливладельцы попрежнему поставляют свои сценарии, fixtures, datasets и expected results.

Проверки:

• php -l для измененных PHP/INC/page файлов TestA;
• git diff --check;
• TestA HTTP module=TestA: total=8, passed=8, failed=0;
• TestA HTTP full safe-read testedOnly: total=100, passed=100, failed=0, blocked=0;
• JSON inventory includeTestInfo=1 для TestA:scenario:ManifestContract возвращает ownerModule=TestA и contractVersion=TestA/1.0.

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

1.1. 🔗 blocks: I128-2801

1.2. 🔗 blocks: I128-2802

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-2798