202 lines
16 KiB
Typst
202 lines
16 KiB
Typst
#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 к демонстрации и развитию в рамках ВКР.
|