---

[I128-2673] Инфраструктура модульного тестирования системы на базе TestA

---

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

---

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

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

Завершено: 09.07.2026 15:12

Требуется спроектировать и реализовать встроенную инфраструктуру модульного и интеграционного тестирования системы на базе модуля TestA.

Цель: перед открытием PR иметь возможность запускать проверку модулей, __callметодов, Actions, Pages и пользовательских сценариев, получать единый отчет в интерфейсе и JSONрезультат для автоматизаций.

Предлагаемая архитектура:

• TestA выступает централизованным runner/reporting модулем.
• Для модулей добавляется изолированная папка Tests с тестами для модуля в целом, __call, Actions, Pages и сценариев.
• Все тесты возвращают единый структурированный результат: id, target, level, status, duration, message, details, error, artifacts.
• Поддерживаются уровни проверок: saferead, requiresauth, writes, queue, external, destructive, manual.
• Запуск длительных проверок выполняется через Queue с прогрессом и сохранением результатов.
• Должен быть интерфейс TestA для запуска suite/module/target и просмотра проваленных проверок.
• Должен быть JSON API для запуска и получения отчета, пригодный для PR-автоматизаций.
• Настройки тестовых окружений, учетных записей, тестовых БД, провайдеров и разрешенных уровней проверок должны настраиваться через АРМ Администратор.

Критерии приемки:

• Есть базовый контракт TestA_TestCase и единый формат результата.
• TestA умеет строить inventory доступных тестов и целей проверки.
• Есть запуск отдельного target, модуля и набора проверок.
• Есть очередь выполнения и страница отчета с фильтром failed/blocked/skipped.
• Есть JSON-методы получения результата.
• Реализованы первые демонстрационные тесты минимум для самого TestA и одного прикладного модуля.
• Пишущие и destructive проверки не запускаются без явного разрешения и тестовой БД.

-

I128-2673 добавляет встроенную инфраструктуру модульного и интеграционного тестирования на базе модуля TestA для ветки develop. PR включает runner/reporting слой, UI и JSON actions для запуска и чтения отчетов, настройки уровней/провайдеров и первые демонстрационные проверки для Queue, включая пишущий сценарий на изолированной очереди.

Куда смотреть:

• Сценарий в системе: ?id=TestA/Dashboard > панель TestA -> выбрать модуль/тип/имя, уровни проверок и способ запуска -> Запустить; результат открывается через ?id=TestA/Report&runid=<runid>, JSONинвентарь доступен по ?id=WIrbis&action=TestA/GetInventoryJson. Chrome: подтверждено на ?id=TestA/Dashboard, ?id=WIrbis&action=TestA/GetInventoryJson и ?id=TestA/Report&runid=20260708203833~~d5a3c43c; отчет показал Всего: 98, успешно: 98, ошибки: 0, заблокировано: 0, пропущено: 0. Было: не было единой панели запуска TestA, реестра целей, страниц отчета и JSONконтракта для PRавтоматизаций. Стало: reviewer видит счетчики целей, форму запуска, последние отчеты, страницу отчета и JSON~~инвентарь.
• Настройки для сценария: для базового readonly сценария отдельная настройка не требуется; уровни по умолчанию `saferead, разрешенные уровниsaferead,requiresauth,writes,queue, матрица провайдеровDPIrbis64Native,DPIrbis64Direct. Пишущие Queue-проверки запускаются только при выборе уровнейwrites,queueи работают через изолированныйTestA/QueueSandbox`, а не через рабочую очередь.
• Help: обновлена справка ?id=Help/Show&m=TestA/Testing; Chrome readback подтвердил разделы про размещение тестов, уровни, провайдеры, панель ?id=TestA/Dashboard, JSON-инвентарь, запуск suite и чтение отчета.
• Для PRветки: ветка `feature/I1282673содержит текущийorigin/develop(eff35a470401b4d33c07d666b7e4fd16a74f015e) и отправлена вorigin/feature/I128-2673`; зависимостей от других PR нет.

Изменения по файлам:

modules/TestA/api.php

• Расширен модуль TestA: добавлены настройки уровней проверок, разрешенных web-запусков, read/write БД и матрицы провайдеров.
• Добавлены справочники человекочитаемых уровней и провайдеров, фабрика runner и имена checkbox-настроек для АРМ Администратор.

modules/TestA/include/Runner.php

• Новый файл. Центральный runner строит inventory модулей, __call, actions, pages и сценариев, нормализует уровни/провайдеры, запускает suite/module/target и сохраняет JSON-отчеты.
• Структура: TestA_Runner, нормализация options, сканирование целей, явные и структурные проверки, summary/report persistence.
• Логика работы: получает параметры запуска, фильтрует цели по модулю/типу/уровням, вызывает тестовые классы или structural checks, пишет отчет в DataPath/TestA/Reports.

modules/TestA/include/TestCase.php

• Новый файл. Добавляет базовый контракт TestA*TestCase и контекст TestA*Context.
• Структура результата унифицирована: id, title, target, level, status, durationMs, message, details, error, artifacts.
• Добавлены helpers Ok, Failed, Skipped, Blocked, Warning и Check* для нескольких проверок одной цели.

modules/TestA/include/ActionHelper.php

• Новый файл. Общий helper JSON actions TestA.
• Готовит Content~~Type, читает параметры запуска из action/request, нормализует target/options и возвращает JSON~~ответы без дублирования кода в actions.

modules/TestA/Pages/Dashboard.page

• Новый UI панели TestA: счетчики целей, форма выбора модуля/типа/имени, checkboxуровни, structural mode, запуск через очередь и ссылка на JSONинвентарь.
• Добавлен список последних отчетов с переходом на страницу результата.

modules/TestA/Pages/Report.page

• Новый UI отчета TestA по runid.
• Показывает summary и таблицу проблемных результатов failed/blocked/warning, а также ссылку на JSON отчета.

modules/TestA/Actions/GetInventoryJson.inc

• Новый action. Возвращает JSON-инвентарь целей TestA с текущими счетчиками и options.

modules/TestA/Actions/GetReportJson.inc

• Новый action. Возвращает сохраненный JSON-отчет по runid или ошибку, если отчет не найден.

modules/TestA/Actions/ListReportsJson.inc

• Новый action. Возвращает список последних отчетов TestA.

modules/TestA/Actions/RunSuite.inc

• Новый action. Запускает suite синхронно или ставит запуск в Queue через TestA/RunSuiteWorker.

modules/TestA/Actions/RunSuiteWorker.inc

• Новый action. Выполняет отложенный запуск suite из очереди и сохраняет отчет.

modules/TestA/Actions/RunTarget.inc

• Новый action. Запускает одну цель TestA по target/options и возвращает результат JSON.

modules/TestA/__call/AdminModuleVariablesInit.inc

• Новый файл. Описывает настройки TestA для АРМ Администратор: уровни по умолчанию, разрешенные уровни, unsafe web-runs, aliases БД и матрицу провайдеров.

modules/TestA/__call/GetInventory.inc

• Новый wrapper *_call. Возвращает inventory через TestA*Runner.

modules/TestA/__call/GetRunReport.inc

• Новый wrapper __call. Загружает отчет по runid.

modules/TestA/__call/ListRunReports.inc

• Новый wrapper __call. Возвращает список сохраненных отчетов.

modules/TestA/__call/RunModule.inc

• Новый wrapper __call. Запускает проверки одного модуля.

modules/TestA/__call/RunSuite.inc

• Новый wrapper __call. Запускает набор проверок с переданными options.

modules/TestA/__call/RunTarget.inc

• Новый wrapper __call. Запускает отдельную цель.

modules/TestA/Tests/Module.inc

• Новый тест самого модуля TestA. Проверяет построение inventory, наличие уровней, нормализацию options и матрицу провайдеров.

modules/TestA/Tests/Actions/GetInventoryJson.inc

• Новый тест action. Проверяет JSON-контракт inventory и наличие счетчиков/целей.

modules/TestA/Tests/__call/GetInventory.inc

• Новый тест __call. Проверяет, что inventory возвращается как массив с целями и счетчиками.

modules/TestA/Help/Purpose.md

• Обновлено назначение TestA с учетом runner/reporting инфраструктуры.

modules/TestA/Help/Root.md

• Обновлена корневая страница справки TestA и навигация к разделу тестового runner.

modules/TestA/Help/Testing.md

• Новый файл. Справка по размещению тестов, нескольким проверкам одной цели, уровням, провайдерам, UI панели и JSON actions.

modules/Queue/Tests/Module.inc

• Новый тест модуля Queue. Проверяет наличие базовой БД очереди и доступность основных API/настроек.

modules/Queue/Tests/QueueTestSupport.php

• Новый общий support для Queue tests.
• Структура: helpers для QueueInfo.db, JSON-декодирования, изолированной очереди, вставки строк, подмены request/session/cache и уборки sandbox.
• Логика работы: пишущие проверки временно переключают DataPath/LockPath в TestA/QueueSandbox, создают отдельную SQLite-базу, восстанавливают состояние и удаляют sandbox после теста.

modules/Queue/Tests/Scenarios/WriteQueueLifecycle.inc

• Новый сценарий writes,queue. Проверяет полный жизненный цикл изолированной очереди: append, dedup, batch, выбор задачи, progress, reset/state/pause/multy, очистку done/error/timeout, monitor/vacuum/process/kill/empty.

modules/Queue/Tests/Actions/AppendTaskAndMonitor.inc

• Новый тест action. Проверяет постановку задачи и monitor-ответ Queue.

modules/Queue/Tests/Actions/ChangeOnlyHighState.inc

• Новый тест action. Проверяет переключение режима обработки только приоритетных задач.

modules/Queue/Tests/Actions/ChangePause.inc

• Новый тест action. Проверяет включение общей паузы очереди.

modules/Queue/Tests/Actions/ChangePauseState.inc

• Новый тест action. Проверяет изменение состояния паузы очереди.

modules/Queue/Tests/Actions/ChangeUnPause.inc

• Новый тест action. Проверяет снятие общей паузы очереди.

modules/Queue/Tests/Actions/EmptyQueue.inc

• Новый тест action. Проверяет очистку изолированной очереди.

modules/Queue/Tests/Actions/GetState.inc

• Новый тест action. Проверяет JSONсостояние очереди, счетчики и flags pause/onlyhigh.

modules/Queue/Tests/Actions/GetTaskInfo.inc

• Новый тест action. Проверяет чтение карточки задачи по идентификатору.

modules/Queue/Tests/Actions/KillAllStuck.inc

• Новый тест action. Проверяет сброс зависших потоков очереди.

modules/Queue/Tests/Actions/KillThread.inc

• Новый тест action. Проверяет удаление состояния отдельного потока.

modules/Queue/Tests/Actions/PauseTask.inc

• Новый тест action. Проверяет перевод задачи в состояние паузы.

modules/Queue/Tests/Actions/ProcessDispatcher.inc

• Новый тест action. Проверяет запуск dispatcher-обработки очереди.

modules/Queue/Tests/Actions/ProcessThread.inc

• Новый тест action. Проверяет обработку рабочего потока очереди.

modules/Queue/Tests/Actions/QueueMonitor.inc

• Новый тест action. Проверяет постановку сервисной задачи monitor/vacuum.

modules/Queue/Tests/Actions/RemoveTask.inc

• Новый тест action. Проверяет удаление задачи из изолированной очереди.

modules/Queue/Tests/Actions/ResetTask.inc

• Новый тест action. Проверяет сброс состояния и прогресса задачи.

modules/Queue/Tests/Actions/RetrieveRemoteResult.inc

• Новый тест action. Проверяет чтение сохраненного результата удаленной задачи.

modules/Queue/Tests/Actions/SetMulty.inc

• Новый тест action. Проверяет массовое изменение задач по списку/фильтрам.

modules/Queue/Tests/Actions/SetProgress.inc

• Новый тест action. Проверяет запись и чтение прогресса задачи.

modules/Queue/Tests/Actions/SetState.inc

• Новый тест action. Проверяет установку состояния задачи.

modules/Queue/Tests/Actions/Vacuum.inc

• Новый тест action. Проверяет обслуживание SQLite-базы очереди.

modules/Queue/Tests/Pages/InfoQueue.inc

• Новый тест страницы. Проверяет загрузку страницы состояния очереди.

modules/Queue/Tests/__call/AdminModuleVariablesInit.inc

• Новый тест __call. Проверяет регистрацию административных настроек Queue.

modules/Queue/Tests/__call/Append.inc

• Новый тест __call. Проверяет добавление задачи в изолированную очередь.

modules/Queue/Tests/__call/AppendBatch.inc

• Новый тест __call. Проверяет пакетную постановку задач.

modules/Queue/Tests/__call/AppendMonitors.inc

• Новый тест __call. Проверяет постановку monitor-задач.

modules/Queue/Tests/__call/CheckPause.inc

• Новый тест __call. Проверяет чтение глобального pause-состояния.

modules/Queue/Tests/__call/ClearDonedTasks.inc

• Новый тест __call. Проверяет очистку завершенных задач с истекшим сроком хранения.

modules/Queue/Tests/__call/ClearErroredTasks.inc

• Новый тест __call. Проверяет обработку ошибочных задач и retry/fatal ветки.

modules/Queue/Tests/__call/ClearTimeoutedTasks.inc

• Новый тест __call. Проверяет перевод зависших задач в ошибку.

modules/Queue/Tests/__call/GetActionCount.inc

• Новый тест __call. Проверяет подсчет задач по action.

modules/Queue/Tests/__call/GetDbQ.inc

• Новый тест __call. Проверяет открытие SQLite-базы очереди и схему таблицы.

modules/Queue/Tests/__call/GetProgress.inc

• Новый тест __call. Проверяет чтение progress/progressmsg.

modules/Queue/Tests/__call/GetRecordBlock.inc

• Новый тест __call. Проверяет получение блока записей очереди.

modules/Queue/Tests/__call/GetRecordCount.inc

• Новый тест __call. Проверяет подсчет записей очереди.

modules/Queue/Tests/__call/GetRecordValue.inc

• Новый тест __call. Проверяет чтение отдельного значения записи очереди.

modules/Queue/Tests/__call/GetSingleRow.inc

• Новый тест __call. Проверяет чтение одной строки SQLite.

modules/Queue/Tests/__call/GetTaskForStart.inc

• Новый тест __call. Проверяет выбор следующей задачи для запуска с учетом приоритета.

modules/Queue/Tests/__call/GetTaskInfoElm.inc

• Новый тест __call. Проверяет форматирование поля карточки задачи.

modules/Queue/Tests/__call/MonitorSubTasksProgress.inc

• Новый тест __call. Проверяет агрегацию прогресса подзадач.

modules/Queue/Tests/__call/SetMonitorLogFile.inc

• Новый тест __call. Проверяет привязку файла журнала monitor-задачи.

modules/Queue/Tests/__call/SetPauseState.inc

• Новый тест __call. Проверяет запись pause/only-high состояний.

modules/Queue/Tests/__call/SetProgress.inc

• Новый тест __call. Проверяет обновление progress/progressmsg.

modules/Queue/Tests/__call/SetTaskInfoElm.inc

• Новый тест __call. Проверяет запись элемента информации задачи.

modules/Queue/Tests/__call/SqlBatch.inc

• Новый тест __call. Проверяет пакетное выполнение SQL на базе очереди.

modules/Queue/Tests/__call/SqlExec.inc

• Новый тест __call. Проверяет выполнение SQL-команды.

modules/Queue/Tests/__call/SqlInsert.inc

• Новый тест __call. Проверяет insert и возвращаемый идентификатор.

modules/Queue/Tests/__call/StartProcessBackground.inc

• Новый тест __call. Проверяет запуск фонового процесса очереди.

modules/Queue/Tests/__call/StartThread.inc

• Новый тест __call. Проверяет старт рабочего потока очереди.