Отключен счётчик страниц на аннотациях

Report/prediploma-practice/README.md

@@ -0,0 +1,11 @@
+# Преддипломная практика — задание и дневник
+
+Материалы для переноса в отчёт (.docx).
+
+| Файл | Назначение |
+|------|------------|
+| `zadanie.csv`, `dnevnik.csv`, `analiz.csv` | Импорт в Word: *Вставка → Таблица → Текст в таблицу* (разделитель — запятая, UTF-8) |
+| `zadanie.typ`, `dnevnik.typ`, `analiz.typ` | Исходники PDF (раздел IV — анализ работ) |
+| `out/*.pdf` | После `bash build.sh` |
+
+Сроки: **07.05.2026 – 04.06.2026**, ООО НМФ «Нейротех», проект Wallenc.

Report/prediploma-practice/analiz.csv

@@ -0,0 +1,16 @@
+№ п/п,Выполненные мероприятия в соответствии с заданием на практику,Анализ проведённой работы
+1,Актуализация постановки задачи ВКР,"Уточнены цели преддипломной практики с опорой на уже реализованное ядро Wallenc: приоритет отдан доведению синхронизации storage, групп хранилищ, 2FA и текстовых секретов до демонстрационного уровня. Сформирован перечень доработок, согласованный с темой ВКР и результатами производственной практики, что исключило повторение начального аналитического цикла и сфокусировало сроки на инженерной и отчётной составляющих."
+2,Реструктуризация модулей Gradle,"Выделение domain-storage и перенос логики localVault упростили границы ответственности между слоями: доменные контракты storage отделены от vault-навигации. Реструктуризация выполнена до внедрения крупных функций sync и секретов, поэтому последующие изменения локализовались в целевых модулях без каскадных правок по всему репозиторию."
+3,Интеграция с Яндекс.Диск,"Развит REST-клиента, репозитория и сценариев удалённого vault довело OAuth-контур до устойчивой эксплуатации: учтены сетевые сбои на экране vault, сужена инвалидация кэша Disk API, добавлен учёт запросов. Пользователь получает рабочий поток подключения аккаунта и операций с удалённым storage без передачи ключей шифрования провайдеру, что соответствует исходной модели угроз Wallenc."
+4,Синхронизация storage,"Реализован StorageSyncEngine с журналом изменений по путям, группами DbStorageSyncGroup в Room и фоновым исполнением через очередь задач. Отработаны блокировки sync, cooperative-отмена, foreground-задача и заголовки уведомлений; исправлены ошибки журнала при DELETE/TRASH. Синхронизация переведена из проектного статуса в проверяемый пользовательский сценарий с отображением прогресса на экране задач."
+5,Секреты и TOTP 2FA,"Добавлены маршруты и экраны текстовых секретов и 2FA; генерация TOTP вынесена в фоновые задачи вместе с прочими длительными операциями. Замена зависимости mlkit на свободную библиотеку и доработка UI прогресса 2FA повысили воспроизводимость сценария на устройстве. Функции второго этапа практики интегрированы в общую модель «storage → содержимое» без отдельного backend."
+6,Доработка UI/UX,"Унифицированы индикаторы занятости storage и подписи прогресса задач; улучшены карточки vault и обработка ошибок сети. Deep links и открытие экрана задач из уведомления сократили путь пользователя к статусу синхронизации. Иконка приложения и переключение языка завершили визуальную и локализационную подготовку к демонстрации на защите."
+7,Шифрование и метаданные storage,"Исправлены сценарии шифрования и метаданных для Yandex vault и первого открытия storage; добавлена опция сохранения пароля при включении шифрования. Запрет включения зашифрованных storage в несовместимые группы sync снижает риск рассогласования состояния. Доменная логика Encryptor и ManageStoragesEncryptionUseCase согласована с фактическим поведением UI."
+8,Тестирование,"Расширен набор unit-тестов (в том числе после рефакторинга sync и DI); выполнены ручные прогоны T-7…T-12 на эмуляторе. Подтверждены создание storage, шифрование, OAuth Яндекс, фоновые задачи и уведомления. Результаты зафиксированы для включения в раздел тестирования пояснительной записки и отчёта по практике."
+9,Стабилизация сборки,"Устранена значительная часть предупреждений компилятора и deprecated API; упорядочены Hilt-модули. Оптимизированы debounce-sync, pipeline задач и обработка отсутствия journal/lock при синхронизации. Сборка assembleDebug и прогон тестов стали регулярной процедурой контроля качества перед оформлением отчётности."
+10,Актуализация технического задания,"ТЗ приведено в соответствие с реализованным функционалом (sync, 2FA, секреты, очередь задач) и структурой по ГОСТ 7.32–2017. Зафиксированы критерии приёмки и границы доработок, что обеспечило согласованность между кодом, пояснительной запиской и заданием на практику."
+11,Оформление пояснительной записки ВКР,"Подготовлены разделы обзора аналогов, архитектуры, проектирования UI, реализации и тестирования с опорой на фактическую кодовую базу. Текст ПЗ согласован с иерархией vault → storage → файлы и терминологией проекта. Объём работ отражает завершение цикла «разработка – проверка – описание», а не только документирование без изменений в приложении."
+12,Иллюстрации и приложения ПЗ,"Подготовлены скриншоты ключевых экранов, схемы архитектуры и потоков, листинги модулей для приложений ПЗ. Подписи рисунков приведены в соответствие с содержанием (в т.ч. OAuth, sync, 2FA). Иллюстрации привязаны к перекрёстным ссылкам в тексте глав 1, 3 и 5."
+13,Руководство пользователя и демонстрация,"Составлено руководство пользователя (приложение Б): пошаговые сценарии локального и удалённого vault, шифрования, секретов, 2FA и фоновых задач. Подготовлена актуальная сборка APK и сценарий показа для защиты ВКР с акцентом на zero-knowledge и синхронизацию без утечки ключей."
+14,Отчёт по практике и дневник,"Ведён дневник практики с привязкой записей к фактическим этапам разработки (11–19.05) и оформлению отчётности (20–24.05). Итоговый отчёт объединяет задание, дневник, анализ работ и ссылки на артефакты Wallenc; зафиксированы сроки и соответствие заданию на преддипломную практику."
+15,Подготовка к защите практики,"Систематизированы результаты для представления руководителю от организации и университета: демонстрация приложения, ПЗ, отчёт. Выявленные на финальной проверке дефекты sync/Yandex устранены или отражены как направления развития. Практика завершена в установленный срок с полным комплектом отчётных материалов."

Report/prediploma-practice/analiz.typ

@@ -0,0 +1,58 @@
+#import "preamble.typ": *
+
+#practice_title[IV. Анализ проведённой работы в период прохождения практики обучающимся]
+
+#table(
+  columns: (1cm, 3.6cm, 1fr),
+  align: (center, left, left),
+  table.header(
+    [№ п/п],
+    [Выполненные мероприятия в соответствии с заданием на практику],
+    [Анализ проведённой работы],
+  ),
+  [1],
+  [Актуализация постановки задачи ВКР],
+  [Уточнены цели преддипломной практики с опорой на уже реализованное ядро Wallenc: приоритет отдан доведению синхронизации storage, групп хранилищ, 2FA и текстовых секретов до демонстрационного уровня. Сформирован перечень доработок, согласованный с темой ВКР и результатами производственной практики, что исключило повторение начального аналитического цикла и сфокусировало сроки на инженерной и отчётной составляющих.],
+  [2],
+  [Реструктуризация модулей Gradle],
+  [Выделение `domain-storage` и перенос логики localVault упростили границы ответственности между слоями: доменные контракты storage отделены от vault-навигации. Реструктуризация выполнена до внедрения крупных функций sync и секретов, поэтому последующие изменения локализовались в целевых модулях без каскадных правок по всему репозиторию.],
+  [3],
+  [Интеграция с Яндекс.Диск],
+  [Развит REST-клиента, репозитория и сценариев удалённого vault довело OAuth-контур до устойчивой эксплуатации: учтены сетевые сбои на экране vault, сужена инвалидация кэша Disk API, добавлен учёт запросов. Пользователь получает рабочий поток подключения аккаунта и операций с удалённым storage без передачи ключей шифрования провайдеру, что соответствует исходной модели угроз Wallenc.],
+  [4],
+  [Синхронизация storage],
+  [Реализован `StorageSyncEngine` с журналом изменений по путям, группами `DbStorageSyncGroup` в Room и фоновым исполнением через очередь задач. Отработаны блокировки sync, cooperative-отмена, foreground-задача и заголовки уведомлений; исправлены ошибки журнала при DELETE/TRASH. Синхронизация переведена из проектного статуса в проверяемый пользовательский сценарий с отображением прогресса на экране задач.],
+  [5],
+  [Секреты и TOTP 2FA],
+  [Добавлены маршруты и экраны текстовых секретов и 2FA; генерация TOTP вынесена в фоновые задачи вместе с прочими длительными операциями. Замена зависимости mlkit на свободную библиотеку и доработка UI прогресса 2FA повысили воспроизводимость сценария на устройстве. Функции второго этапа практики интегрированы в общую модель «storage → содержимое» без отдельного backend.],
+  [6],
+  [Доработка UI/UX],
+  [Унифицированы индикаторы занятости storage и подписи прогресса задач; улучшены карточки vault и обработка ошибок сети. Deep links и открытие экрана задач из уведомления сократили путь пользователя к статусу синхронизации. Иконка приложения и переключение языка завершили визуальную и локализационную подготовку к демонстрации на защите.],
+  [7],
+  [Шифрование и метаданные storage],
+  [Исправлены сценарии шифрования и метаданных для Yandex vault и первого открытия storage; добавлена опция сохранения пароля при включении шифрования. Запрет включения зашифрованных storage в несовместимые группы sync снижает риск рассогласования состояния. Доменная логика `Encryptor` и `ManageStoragesEncryptionUseCase` согласована с фактическим поведением UI.],
+  [8],
+  [Тестирование],
+  [Расширен набор unit-тестов (в том числе после рефакторинга sync и DI); выполнены ручные прогоны T-7…T-12 на эмуляторе. Подтверждены создание storage, шифрование, OAuth Яндекс, фоновые задачи и уведомления. Результаты зафиксированы для включения в раздел тестирования пояснительной записки и отчёта по практике.],
+  [9],
+  [Стабилизация сборки],
+  [Устранена значительная часть предупреждений компилятора и deprecated API; упорядочены Hilt-модули. Оптимизированы debounce-sync, pipeline задач и обработка отсутствия journal/lock при синхронизации. Сборка `assembleDebug` и прогон тестов стали регулярной процедурой контроля качества перед оформлением отчётности.],
+  [10],
+  [Актуализация технического задания],
+  [ТЗ приведено в соответствие с реализованным функционалом (sync, 2FA, секреты, очередь задач) и структурой по ГОСТ 7.32–2017. Зафиксированы критерии приёмки и границы доработок, что обеспечило согласованность между кодом, пояснительной запиской и заданием на практику.],
+  [11],
+  [Оформление пояснительной записки ВКР],
+  [Подготовлены разделы обзора аналогов, архитектуры, проектирования UI, реализации и тестирования с опорой на фактическую кодовую базу. Текст ПЗ согласован с иерархией vault → storage → файлы и терминологией проекта. Объём работ отражает завершение цикла «разработка – проверка – описание», а не только документирование без изменений в приложении.],
+  [12],
+  [Иллюстрации и приложения ПЗ],
+  [Подготовлены скриншоты ключевых экранов, схемы архитектуры и потоков, листинги модулей для приложений ПЗ. Подписи рисунков приведены в соответствие с содержанием (в т.ч. OAuth, sync, 2FA). Иллюстрации привязаны к перекрёстным ссылкам в тексте глав 1, 3 и 5.],
+  [13],
+  [Руководство пользователя и демонстрация],
+  [Составлено руководство пользователя (приложение Б): пошаговые сценарии локального и удалённого vault, шифрования, секретов, 2FA и фоновых задач. Подготовлена актуальная сборка APK и сценарий показа для защиты ВКР с акцентом на zero-knowledge и синхронизацию без утечки ключей.],
+  [14],
+  [Отчёт по практике и дневник],
+  [Ведён дневник практики с привязкой записей к фактическим этапам разработки (11–19.05) и оформлению отчётности (20–24.05). Итоговый отчёт объединяет задание, дневник, анализ работ и ссылки на артефакты Wallenc; зафиксированы сроки и соответствие заданию на преддипломную практику.],
+  [15],
+  [Подготовка к защите практики],
+  [Систематизированы результаты для представления руководителю от организации и университета: демонстрация приложения, ПЗ, отчёт. Выявленные на финальной проверке дефекты sync/Yandex устранены или отражены как направления развития. Практика завершена в установленный срок с полным комплектом отчётных материалов.],
+)

Report/prediploma-practice/build.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+OUT="$ROOT/prediploma-practice/out"
+mkdir -p "$OUT"
+cd "$ROOT/prediploma-practice"
+typst compile zadanie.typ "$OUT/zadanie.pdf"
+typst compile dnevnik.typ "$OUT/dnevnik.pdf"
+typst compile analiz.typ "$OUT/analiz.pdf"
+echo "OK: $OUT/zadanie.pdf, $OUT/dnevnik.pdf, $OUT/analiz.pdf"

Report/prediploma-practice/dnevnik.csv

@@ -0,0 +1,12 @@
+Дата,Выполненные мероприятия в соответствии с заданием на практику
+07.05.2026,"Инструктаж по ознакомлению с требованиями охраны труда, техники безопасности, правилам внутреннего распорядка. Согласование плана доработок Wallenc к защите ВКР."
+08.05.2026,"Актуализация технического задания и требований: синхронизация storage, группы хранилищ, сценарии 2FA и текстовых секретов."
+09.05.2026 – 10.05.2026,"Проектирование механизма синхронизации (журнал изменений, группы DbStorageSyncGroup), схемы пользовательских потоков для экрана задач и уведомлений."
+11.05.2026,"Реструктуризация Gradle-модулей (domain-storage, перенос localVault); deep links и запуск экрана задач из уведомления; оптимизация работы с API Яндекс.Диск."
+12.05.2026 – 13.05.2026,"Реализация StorageSyncEngine: группы синхронизации, снятие блокировки sync; маршруты и экраны текстовых секретов и 2FA; компоненты отображения статуса операций."
+14.05.2026 – 16.05.2026,"Доработка UI/UX списков storage и vault; уточнение логики фоновых операций и индикаторов загрузки Яндекс.Диск."
+17.05.2026,"Рабочий TOTP 2FA; группы синхронизации в Room и контроль совместимости storage; переподключение remote vault; перенос операций с секретами в очередь задач."
+18.05.2026,"Унификация доменных ошибок и статуса failed у задач; подписи прогресса; улучшение фоновой синхронизации; переключение языка; наведение порядка в DI (Hilt)."
+19.05.2026,"Добавление и прогон unit-тестов; устранение предупреждений компилятора; сборка и проверка сценариев шифрования, OAuth и sync на эмуляторе."
+20.05.2026 – 24.05.2026,"Составление отчёта по преддипломной практике; оформление пояснительной записки ВКР и иллюстраций; при необходимости – финальные правки sync и Yandex vault (стабилизация журнала, UX, foreground-задачи)."
+04.06.2026,Защита практики.

Report/prediploma-practice/dnevnik.typ

@@ -0,0 +1,34 @@
+#import "preamble.typ": *
+
+#practice_title[Дневник преддипломной практики]
+
+#table(
+  columns: (3.2cm, 1fr),
+  align: (left, left),
+  table.header(
+    [Дата],
+    [Выполненные мероприятия в соответствии с заданием на практику],
+  ),
+  [07.05.2026],
+  [Инструктаж по ознакомлению с требованиями охраны труда, техники безопасности, правилам внутреннего распорядка. Согласование плана доработок Wallenc к защите ВКР.],
+  [08.05.2026],
+  [Актуализация технического задания и требований: синхронизация storage, группы хранилищ, сценарии 2FA и текстовых секретов.],
+  [09.05.2026 – 10.05.2026],
+  [Проектирование механизма синхронизации (журнал изменений, группы `DbStorageSyncGroup`), схемы пользовательских потоков для экрана задач и уведомлений.],
+  [11.05.2026],
+  [Реструктуризация Gradle-модулей (`domain-storage`, перенос localVault); deep links и запуск экрана задач из уведомления; оптимизация работы с API Яндекс.Диск.],
+  [12.05.2026 – 13.05.2026],
+  [Реализация `StorageSyncEngine`: группы синхронизации, снятие блокировки sync; маршруты и экраны текстовых секретов и 2FA; компоненты отображения статуса операций.],
+  [14.05.2026 – 16.05.2026],
+  [Доработка UI/UX списков storage и vault; уточнение логики фоновых операций и индикаторов загрузки Яндекс.Диск.],
+  [17.05.2026],
+  [Рабочий TOTP 2FA; группы синхронизации в Room и контроль совместимости storage; переподключение remote vault; перенос операций с секретами в очередь задач.],
+  [18.05.2026],
+  [Унификация доменных ошибок и статуса failed у задач; подписи прогресса; улучшение фоновой синхронизации; переключение языка; наведение порядка в DI (Hilt).],
+  [19.05.2026],
+  [Добавление и прогон unit-тестов; устранение предупреждений компилятора; сборка и проверка сценариев шифрования, OAuth и sync на эмуляторе.],
+  [20.05.2026 – 24.05.2026],
+  [Составление отчёта по преддипломной практике; оформление пояснительной записки ВКР и иллюстраций; при необходимости – финальные правки sync и Yandex vault (стабилизация журнала, UX, foreground-задачи).],
+  [04.06.2026],
+  [Защита практики.],
+)

Report/prediploma-practice/preamble.typ

@@ -0,0 +1,33 @@
+#set page(
+  paper: "a4",
+  margin: (left: 2.5cm, right: 1.5cm, top: 2cm, bottom: 2cm),
+  numbering: none,
+)
+#set text(font: "Times New Roman", size: 14pt, lang: "ru")
+#set par(justify: true, first-line-indent: 0pt)
+#set table(stroke: 0.5pt + black, inset: (x: 6pt, y: 5pt))
+
+#let practice_meta = (
+  kind: "преддипломную",
+  period: "07.05.2026 – 04.06.2026",
+  org: "ООО НМФ «Нейротех»",
+  student: "Пытков Роман Евгеньевич",
+  group: "КТбо4-9",
+  direction: "09.03.04 «Программная инженерия»",
+  project: "мобильное приложение Wallenc (Android)",
+)
+
+#let practice_title(body) = {
+  align(center)[
+    #text(weight: "bold", size: 14pt)[#body]
+  ]
+  v(0.5em)
+  align(center)[
+    #practice_meta.student, группа #practice_meta.group \
+    Направление #practice_meta.direction \
+    #practice_meta.org \
+    Сроки: #practice_meta.period \
+    Проект: #practice_meta.project
+  ]
+  v(1em)
+}

Report/prediploma-practice/zadanie.csv

@@ -0,0 +1,16 @@
+№,Содержание задания (выполнялось в рамках темы ВКР и проекта Wallenc)
+1,"Актуализация постановки задачи ВКР и уточнение требований к мобильному приложению Wallenc с учётом результатов производственной практики."
+2,"Реструктуризация модулей проекта (Gradle): выделение domain-storage, унификация интерфейсов storage и навигации."
+3,"Развитие интеграции с Яндекс.Диск: REST-клиент, OAuth, репозиторий, удалённые vault; обработка сетевых ошибок и кэширование API."
+4,"Реализация синхронизации storage: журнал изменений, группы синхронизации в Room, фоновые задачи, уведомления и экран очереди задач."
+5,"Реализация экранов текстовых секретов и TOTP 2FA; выполнение операций через очередь фоновых задач."
+6,"Доработка UI/UX на Jetpack Compose: индикация статусов storage и задач, deep links, иконка приложения, локализация."
+7,"Доработка шифрования и метаданных storage (включая сценарии Yandex vault и первое открытие зашифрованного storage)."
+8,"Расширение автоматизированного тестирования (unit-тесты, инструментальные прогоны UI) и ручная проверка сценариев T-7…T-12."
+9,"Стабилизация сборки приложения: устранение предупреждений компилятора, наведение порядка в DI, оптимизация фоновой синхронизации."
+10,"Приведение технического задания в соответствие с реализованным функционалом и ГОСТ 7.32–2017."
+11,"Оформление пояснительной записки ВКР: обзор аналогов, архитектура, проектирование UI, описание реализации и тестирования."
+12,"Подготовка иллюстраций и приложений ПЗ: скриншоты интерфейса, схемы, листинги исходного кода."
+13,"Подготовка руководства пользователя и материалов для демонстрации APK на защите ВКР."
+14,"Составление отчёта по преддипломной практике и ведение дневника практики."
+15,"Подготовка к защите преддипломной практики; представление результатов руководителю от организации и университета."

Report/prediploma-practice/zadanie.typ

@@ -0,0 +1,26 @@
+#import "preamble.typ": *
+
+#practice_title[Задание обучающегося на преддипломную практику]
+
+Содержание задания (выполняется в рамках темы ВКР и проекта Wallenc):
+
+#table(
+  columns: (1.2cm, 1fr),
+  align: (center, left),
+  table.header([№], [Содержание задания]),
+  [1], [Актуализация постановки задачи ВКР и уточнение требований к мобильному приложению Wallenc с учётом результатов производственной практики.],
+  [2], [Реструктуризация модулей проекта (Gradle): выделение `domain-storage`, унификация интерфейсов storage и навигации.],
+  [3], [Развитие интеграции с Яндекс.Диск: REST-клиент, OAuth, репозиторий, удалённые vault; обработка сетевых ошибок и кэширование API.],
+  [4], [Реализация синхронизации storage: журнал изменений, группы синхронизации в Room, фоновые задачи, уведомления и экран очереди задач.],
+  [5], [Реализация экранов текстовых секретов и TOTP 2FA; выполнение операций через очередь фоновых задач.],
+  [6], [Доработка UI/UX на Jetpack Compose: индикация статусов storage и задач, deep links, иконка приложения, локализация.],
+  [7], [Доработка шифрования и метаданных storage (включая сценарии Yandex vault и первое открытие зашифрованного storage).],
+  [8], [Расширение автоматизированного тестирования (unit-тесты, инструментальные прогоны UI) и ручная проверка сценариев T-7…T-12.],
+  [9], [Стабилизация сборки приложения: устранение предупреждений компилятора, наведение порядка в DI, оптимизация фоновой синхронизации.],
+  [10], [Приведение технического задания в соответствие с реализованным функционалом и ГОСТ 7.32–2017.],
+  [11], [Оформление пояснительной записки ВКР: обзор аналогов, архитектура, проектирование UI, описание реализации и тестирования.],
+  [12], [Подготовка иллюстраций и приложений ПЗ: скриншоты интерфейса, схемы, листинги исходного кода.],
+  [13], [Подготовка руководства пользователя и материалов для демонстрации APK на защите ВКР.],
+  [14], [Составление отчёта по преддипломной практике и ведение дневника практики.],
+  [15], [Подготовка к защите преддипломной практики; представление результатов руководителю от организации и университета.],
+)