Files
Wallenc/Report/appendices/appendix-b.typ

82 lines
5.2 KiB
Typst
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#import "../includes/common.typ": pz-fig
== Обзор программного продукта Wallenc
Wallenc мобильное приложение для Android: `VaultsManager` объединяет vault (один локальный и удалённые по OAuth), внутри каждого vault пользователь управляет storage с файлами и клиентским шифрованием. Продукт не использует собственный сервер; взаимодействие с облаком выполняется через API внешних провайдеров после OAuth.
== Техническое задание
Полный текст технического задания на разрабатываемое ПО (производственная практика, ООО НМФ «Нейротех»):
#import "tz-pdf.typ": pz-embed-tz-pdf
#pz-embed-tz-pdf()
== Программа и методика испытаний
Испытания проводятся на устройстве или эмуляторе Android. Матрица сценариев табл. @tbl-testplan. Критерий приёмки: отсутствие блокирующих дефектов по сценариям T-1T-6.
== Отчёт о результатах испытаний
Результаты приведены в табл. @tbl-testres (глава 5). Модульные тесты криптографии пройдены.
== Руководство пользователя
=== Установка
Установите APK сборки debug/release, полученной от разработчика, или соберите проект из репозитория GitLab ЮФУ. Разрешите доступ к файловой системе при запросе системы.
=== Первый запуск и storage в локальном vault
1. Откройте приложение Wallenc.
2. На экране «локальные vault» (список storage в единственном LocalVault) нажмите «+» для создания storage.
3. Укажите имя storage и подтвердите создание.
#pz-fig("fig_05_local_vaults.jpg", [Экран списка storage (локальный vault)], "fig-05-rp")
=== Шифрование storage
1. Выберите storage в списке.
2. Выберите действие «Включить шифрование».
3. Введите пароль (мастер-ключ) и подтвердите. *Важно:* без пароля восстановление невозможно.
#pz-fig("fig_06_encrypt_dialog.jpg", [Диалог включения шифрования], "fig-06-rp")
=== Открытие и закрытие зашифрованного storage
1. Для зашифрованного storage выберите «Открыть».
2. Введите пароль. При успехе содержимое storage доступно для просмотра (`IUnlockManager`).
3. Используйте «Закрыть» для блокировки storage.
#pz-fig("fig_07_open_close_dialog.jpg", [Диалог открытия зашифрованного storage], "fig-07-rp")
=== Переименование и удаление
Долгое нажатие или меню storage «Переименовать» / «Удалить» (рис. @fig-08-rp). Подтвердите действие в диалоге.
#pz-fig("fig_08_rename_delete_dialog.jpg", [Меню storage: переименование и удаление], "fig-08-rp")
=== Удалённые vault и Яндекс
1. Перейдите на экран удалённых vault (рис. @fig-09-rp).
2. Нажмите «+» и в диалоге выберите провайдера «Яндекс» (рис. @fig-10-rp).
3. Пройдите OAuth в браузере или встроенном окне (последовательность рис. @fig-20, гл. 1).
4. После успеха аккаунт отображается в списке удалённых vault.
#pz-fig("fig_09_remote_vaults.jpg", [Экран удалённых vault: подключённый аккаунт], "fig-09-rp")
#pz-fig("fig_10_yandex_oauth.jpg", [Диалог «Добавить хранилище»: выбор провайдера Яндекс], "fig-10-rp")
=== Секреты и 2FA внутри storage
1. Откройте storage (после создания или из списка).
2. На экране storage перейдите в разделы «Секреты» и «2FA».
#pz-fig("fig_33_storage_secrets_2fa.jpg", [Экран storage: секреты и 2FA], "fig-33-rp")
3. В разделе 2FA добавьте TOTP-токен; на экране отображается сгенерированный код.
#pz-fig("fig_34_2fa_single_token.jpg", [Экран 2FA с одним токеном], "fig-34-rp")
=== Фоновые задачи
На экране задач отображаются операции шифрования и синхронизации (рис. @fig-12, гл. 5). Уведомления информируют о прогрессе и завершении (рис. @fig-13, гл. 5).