#import "common.typ": pz-fig, pz-table = Тестирование программного обеспечения Тестирование Wallenc организовано по уровням: модульные автоматические тесты (JUnit, каталог `src/test` каждого Gradle-модуля), инструментальные тесты (`src/androidTest`, эмулятор/устройство), ручные функциональные и UI-прогоны. Программа и методика испытаний дублируются в приложении Б; в настоящей главе приведены цели, план, полный реестр unit-тестов, отчёт о прогоне и иллюстрации. == План тестирования === Цели и задачи испытаний Основная цель — подтвердить корректность криптографического ядра, доменной логики синхронизации и сценариев UI до передачи сборки на приёмку практики. Задачи плана: + верифицировать `Encryptor` и проверку ключа для всех носителей (строка, байты, поток); + проверить маппинг исключений в пользовательские коды ошибок (`domain`, `domain-vault`, `ui`); + убедиться в согласованности движка синхронизации (`StorageSyncEngine`, журнал, блокировки); + проверить оркестратор фоновых задач (`task-runtime`); + выполнить smoke-тесты навигации, deep link и 2FA/TOTP; + зафиксировать результаты ручных сценариев vault, OAuth и экрана задач. === Объект и уровни тестирования #pz-table( [Объекты и уровни тестирования Wallenc], 4, table.header([Уровень], [Объект], [Инструмент], [Критерий успеха]), [Unit], [Классы domain, usecases, ui, task-runtime, domain-vault], [JUnit 4, JVM], [Все тесты модуля зелёные], [Инструм.], [Room, Compose UI, OAuth], [AndroidJUnit, эмулятор], [Нет падений на целевом API], [Ручной], [Сборка app, пользовательские цепочки], [Чек-лист], [Сценарии T-1…T-12 пройдены], [Регресс.], [Синхронизация, шифрование], [Повтор unit + выборочный ручной], [Отсутствие блокирующих дефектов], ) === Матрица тестовых сценариев Матрица связывает требования (гл. 1) с видами испытаний. Столбец «Автоматизация» указывает, покрыт ли сценарий unit-тестом. #pz-table( [Матрица тестовых сценариев], 5, table.header([ID], [Сценарий], [Тип], [Авто], [Ожидаемый результат]), [T-1], [Проверка ключа шифрования], [Unit], [Да], [`Encryptor.checkKey` true/false], [T-2], [Шифрование/дешифрование строки и байтов], [Unit], [Да], [Симметрия данных, ошибка при неверном ключе], [T-3], [Потоковое шифрование файла], [Unit], [Да], [Массив после decrypt равен исходному], [T-4], [Синхронизация группы хранилищ], [Unit], [Да], [Копирование, удаление, trash, блокировки], [T-5], [2FA TOTP генерация], [Unit], [Да], [Совпадение с эталоном Java OTP], [T-6], [Маппинг ошибок сети/диска], [Unit], [Да], [Типизированные `WallencException`], [T-7], [CRUD локального vault], [Ручной], [Нет], [Список обновлён (рис. 5)], [T-8], [Включение шифрования vault], [Ручной], [Нет], [Диалог, статус «зашифровано» (рис. 6)], [T-9], [Открытие/закрытие vault], [Ручной], [Нет], [Доступ к содержимому только с ключом (рис. 7)], [T-10], [OAuth Яндекс], [Ручной / IT], [Частично], [Токен в Room (рис. 10)], [T-11], [Экран задач и уведомления], [Ручной], [Частично], [Прогресс и завершение (рис. 12–13)], [T-12], [Compose: секреты и 2FA экраны], [IT], [Да], [Отображение без падений (рис. 30)], ) === Критерии начала и окончания *Начало:* собраны модули `:domain`, `:usecases`, `:ui`, `:domain-vault`, `:task-runtime`, `:app`; на CI/рабочей станции выполняется `./gradlew test`; для инструментальных тестов доступен эмулятор API 26+. *Окончание:* 68 unit-тестов в `src/test` завершились успешно; инструментальные тесты модуля `:ui` (Compose) и `:infrastructure-android` (Room) пройдены на эмуляторе; ручной чек-лист T-7…T-12 подписан в отчёте о практике; критические дефекты (P1) отсутствуют. === Среда и инструменты #pz-table( [Тестовая среда], 2, table.header([Параметр], [Значение]), [ОС разработки], [GNU/Linux, Android Studio Narwhal], [JDK], [OpenJDK 17 / 21 (Gradle toolchain)], [Сборка], [`./gradlew test`, `./gradlew connectedDebugAndroidTest`], [Устройство], [Эмулятор Pixel 6 API 34; физическое устройство для OAuth], [Отчёт JVM], [HTML/XML в `build/reports/tests/test` каждого модуля], ) == Модульные тесты (JUnit) В проекте реализовано *68* автоматических unit-тестов в пяти модулях (`:domain` — 12, `:domain-vault` — 10, `:usecases` — 25, `:ui` — 15, `:task-runtime` — 6). Тесты не требуют Android Runtime (кроме androidTest) и выполняются на JVM при сборке. Сводная таблица всех методов приведена ниже; по модулям — в подразделах. #include "ch05-tests-generated.typ" === Модуль :domain — криптография и ошибки Класс `EncryptorTest` покрывает восемь сценариев AES: проверка ключа, шифрование строк, байтовых массивов (512 байт) и потоков (1500 байт) с верным и неверным ключом. Класс `WallencExceptionMappingTest` проверяет преобразование `FileNotFoundException`, `IOException` и прочих исключений в типизированные ошибки API. #pz-table( [Покрытие EncryptorTest], 3, table.header([Метод], [Проверяемое поведение], [Статус]), [test correct key…], [`checkKey` возвращает true для сгенерированного `StorageEncryptionInfo`], [OK], [test incorrect key…], [`checkKey` false при другом `EncryptKey`], [OK], [test string encryption…], [Симметрия encrypt/decrypt строки], [OK], [test string encryption wrong key], [Исключение при decrypt], [OK], [test bytes encryption…], [Шифротекст ≠ plaintext, decrypt восстанавливает], [OK], [test bytes encryption wrong key], [Исключение при неверном ключе], [OK], [test stream encryption…], [Поток 1500 байт, `readAllBytes` совпадает], [OK], [test stream encryption wrong key], [Исключение на decryptStream], [OK], ) Прогон `./gradlew :domain:test` — на рис. @fig-27. #include "ch05-encryptor.typ" #pz-fig("fig_27_gradle_domain_test.png", [Отчёт Gradle: модуль :domain, задача test], "fig-27") === Модуль :usecases — синхронизация, 2FA, секреты Наибольшая плотность тестов: `StorageSyncEngineTest` (12 методов) моделирует группы синхронизации, копирование и удаление файлов, soft-delete (trash), cooperative cancellation и освобождение блокировок. `StorageSyncJournalMergeTest` и `StorageSyncEncryptionCompatTest` проверяют журнал и совместимость зашифрованных хранилищ. `TwoFaTotpTest` сверяет TOTP с эталоном Java OTP. `StorageDomainUseCasesTest` — CRUD текстовых секретов и 2FA в доменной модели. #include "ch05-sync-tests.typ" #pz-fig("fig_28_gradle_usecases_test.png", [Отчёт Gradle: модуль :usecases], "fig-28") === Модуль :domain-vault — Yandex Disk и vault `YandexDiskRepositoryTest` использует мок HTTP: разбор `diskInfo`, пустой список при 404, `AuthException` при 401. `VaultThrowableMappingTest` — шесть веток сетевых и файловых ошибок. `StorageSyncJournalBufferTest` — устойчивость буфера журнала при сбое записи. === Модуль :ui — навигация, уведомления, OTP Тесты не поднимают полный Compose, а проверяют чистые функции: `WallencDeepLinksTest`, `OtpAuthUriParserTest`, `TaskProgressLabelsTest`, `WallencUserNotificationMappingTest`, `StorageNavigationRoutesSmokeTest`, `TaskPipelineViewModelTest` (постановка тестовой задачи в очередь). #pz-fig("fig_29_gradle_ui_test.png", [Отчёт Gradle: модуль :ui], "fig-29") === Модуль :task-runtime `TaskOrchestratorTest` проверяет жизненный цикл задачи: enqueue, progress, fail, cancel, cancelAll, логирование. == Инструментальные тесты (androidTest) Тесты на устройстве/эмуляторе дополняют unit-уровень. #pz-table( [Инструментальные тесты androidTest], 4, table.header([Модуль], [Класс], [Назначение], [Методов]), [:ui], [TwoFaTokensScreenContentTest], [Compose: экран 2FA токенов], [2], [:ui], [TextSecretsScreenContentTest], [Compose: текстовые секреты], [2], [:infra], [YandexAccountRepositoryTest], [Room in-memory: аккаунт Яндекс], [3], [:app], [YandexDiskLiveIntegrationTest], [Живой API (при наличии токена)], [3], [:app], [ExportYandexTestCredentialsTest], [Экспорт тестовых учётных данных], [1], ) Запуск: `./gradlew connectedDebugAndroidTest`. Сводный результат — рис. @fig-31. #pz-fig("fig_31_gradle_connected_test.png", [Gradle connectedDebugAndroidTest (фрагмент)], "fig-31") == Ручное и UI-тестирование Ручные прогоны выполнялись по чек-листу T-7…T-12 на эмуляторе и физическом устройстве. Для каждого шага фиксировались: предусловие, действие, ожидаемый и фактический результат. #pz-table( [Протокол ручного тестирования], 5, table.header([ID], [Шаг], [Статус], [Фактический результат], [Иллюстрация]), [T-7], [Создать локальный vault], [OK], [Vault в списке], [рис. 5], [T-8], [Включить шифрование], [OK], [Статус encrypted], [рис. 6], [T-9], [Открыть/закрыть vault], [OK], [Контент доступен только открытому], [рис. 7], [T-10], [OAuth Яндекс], [OK], [Запись в `DbYandexAccount`], [рис. 10], [T-11], [Фоновая задача шифрования], [OK], [Прогресс на экране задач], [рис. 12], [T-12], [Уведомление о завершении], [OK], [Notification отображён], [рис. 13], ) #pz-fig("fig_32_manual_test_checklist.png", [Заполненный чек-лист ручного UI-тестирования], "fig-32") == Отчёт о результатах тестирования По итогам автоматического прогона `./gradlew test` все 68 unit-тестов завершились со статусом *PASSED*. Регрессия по криптографии и синхронизации не выявила отклонений. Инструментальные тесты `:ui` подтвердили отрисовку экранов секретов и 2FA; тесты Room — персистентность учётной записи Яндекс. #pz-fig("fig_30_gradle_test_summary.png", [Сводка Gradle test по всем модулям], "fig-30") Выявленные замечания низкого приоритета (не блокируют приёмку): часть интеграционных тестов `:app` требует сетевого токена и вынесена в отдельный профиль CI; placeholder-скриншоты в отчёте заменяются актуальными снимками Android Studio перед защитой. #pz-table( [Классификация дефектов по итогам практики], 4, table.header([ID], [Приоритет], [Описание], [Статус]), [D-1], [P3], [Дублирование подписи листинга в приложении А (оформление)], [Исправлено], [D-2], [P3], [Перенос строк в широких таблицах ПЗ], [Исправлено], [D-3], [P2], [Полная синхронизация с облаком — в разработке], [Открыт], ) === Связь тестов с требованиями #pz-table( [Трассировка требований → тесты], 3, table.header([ФР], [Тесты], [Комментарий]), [ФР-1], [T-7, StorageDomainUseCasesTest], [Локальный vault и CRUD секретов], [ФР-2], [EncryptorTest, T-8, T-9], [Полное покрытие AES], [ФР-3], [TextSecretsScreenContentTest], [UI + domain], [ФР-4], [YandexDiskRepositoryTest, T-10], [HTTP-мок и ручной OAuth], [ФР-5], [StorageSyncEngineTest], [12 сценариев синхронизации], [ФР-6], [TaskOrchestratorTest, T-11], [Очередь и экран задач], ) === Рекомендации по сопровождению тестов При изменении криптомодуля обязателен прогон `:domain:test`. При правках синхронизации — `:usecases:test`. Перед релизом — полный `./gradlew test` и выборочный `connectedDebugAndroidTest`. Регрессионный чек-лист T-7…T-12 выполняется после изменений в Compose-экранах vault. Скрипт `Report/scripts/gen_test_tables.py` обновляет реестр тестов в ПЗ при добавлении новых `@Test`. == Вывод План тестирования выполнен: автоматизированное покрытие охватывает криптографию, синхронизацию, задачи, парсинг OTP и обработку ошибок; ручные сценарии подтвердили пригодность UI для vault и OAuth. Совокупность испытаний обосновывает готовность прототипа Wallenc к демонстрации и развитию в рамках ВКР.