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

91 lines
5.7 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.
== Техническое задание (выдержка)
*Наименование:* мобильное приложение для защищённого хранения пользовательских данных (Wallenc).
*Основание для разработки:* производственная практика, задание ООО НМФ «Нейротех», направление 09.03.04.
*Назначение:* обеспечение конфиденциального хранения пользовательских данных на недоверенных хранилищах.
*Требования к функциям:* см. табл. @tbl-req (глава 1).
*Требования к надёжности:* устойчивость к прерыванию операций шифрования; восстановление метаданных из Room.
*Стадии разработки:* аналитический этап; реализация ядра; тестирование; оформление документации.
*Порядок контроля:* модульные и ручные испытания по программе (ниже).
== Программа и методика испытаний
Испытания проводятся на устройстве или эмуляторе 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")
=== Открытие и закрытие зашифрованного vault
1. Для зашифрованного vault выберите «Открыть».
2. Введите пароль. При успехе содержимое доступно для просмотра.
3. Используйте «Закрыть» для блокировки.
#pz-fig("fig_07_open_close_dialog.jpg", [Диалог открытия и закрытия], "fig-07-rp")
=== Переименование и удаление
Долгое нажатие или меню vault «Переименовать» / «Удалить». Подтвердите действие в диалоге.
#pz-fig("fig_08_rename_delete_dialog.jpg", [Диалог переименования и удаления], "fig-08-rp")
=== Удалённые vault и Яндекс
1. Перейдите на экран удалённых vault.
2. Нажмите «+» выберите авторизацию Яндекс.
3. Пройдите OAuth в браузере/встроенном окне.
4. После успеха добавьте удалённое хранилище.
#pz-fig("fig_09_remote_vaults.jpg", [Экран удалённых vault], "fig-09-rp")
#pz-fig("fig_10_yandex_oauth.jpg", [OAuth Яндекс], "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")
=== Фоновые задачи
На экране задач отображаются операции шифрования и синхронизации. Уведомления информируют о завершении (см. рис. 12 и 13 в гл. 5).