#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 + выборочный ручной], [Отсутствие блокирующих дефектов],
) <tbl-test-levels>

=== Матрица тестовых сценариев

Матрица связывает требования (гл. 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)],
) <tbl-testplan>

=== Критерии начала и окончания

*Начало:* собраны модули `: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` каждого модуля],
) <tbl-test-env>

== Модульные тесты (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],
) <tbl-encryptor>

Прогон `./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],
) <tbl-androidtest>

Запуск: `./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],
) <tbl-testres>

#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], [Полная синхронизация с облаком — в разработке], [Открыт],
) <tbl-defects>

=== Связь тестов с требованиями

#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], [Очередь и экран задач],
) <tbl-trace>

=== Рекомендации по сопровождению тестов

При изменении криптомодуля обязателен прогон `: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 к демонстрации и развитию в рамках ВКР.
