Черновик ПЗ

Report/includes/ch05.typ

@@ -0,0 +1,201 @@
+#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 к демонстрации и развитию в рамках ВКР.