Initial commit

PRD. Менеджер аккаунтов.md

@@ -0,0 +1,91 @@
+# Product Requirements Document (PRD): Кроссплатформенный Менеджер Паролей
+
+## 1. Обзор продукта
+
+Локальный, строго типизированный кроссплатформенный менеджер паролей с поддержкой многопользовательского режима, надежным шифрованием данных "в покое" (data-at-rest) и подготовленной архитектурой для будущей облачной синхронизации и интеграции с браузерными расширениями.
+
+**Технологический стек:**
+- **Backend / Ядро:** Rust (Tauri) — отвечает за криптографию, работу с ФС, БД и системными API (биометрия).
+- **Frontend:** Angular (TypeScript) — отвечает за UI, строгую ООП-архитектуру, управление состояниями и валидацию.
+- **База данных:** SQLite (через Rust).
+## 2. Архитектура безопасности и хранения данных
+Безопасность строится на принципе нулевого доверия к окружению (Zero Trust Local Storage). Даже при полной компрометации устройства (кража диска или копирование файла БД), злоумышленник не должен получить доступ к данным без знания Мастер-пароля.
+### 2.1. Криптографическая схема
+- **Деривация ключа (Key Derivation):** Мастер-пароль пользователя никогда не хранится в явном виде. При вводе он пропускается через функцию **Argon2id** (устойчивую к атакам на GPU/ASIC) вместе со случайной солью. Результатом является Ключ Шифрования Данных (Data Encryption Key - **DEK**).
+- **Шифрование полезной нагрузки:** Для шифрования самих паролей и заметок используется алгоритм **XChaCha20-Poly1305** (AEAD — Authenticated Encryption with Associated Data). Он быстрее и безопаснее стандартного AES на программном уровне и проверяет целостность данных.
+- **Что шифруется:** Логины, пароли, заметки и привязанные почты шифруются. Метаданные (UUID записи, дата создания) можно оставить открытыми для упрощения синхронизации в будущем.
+### 2.2. База данных (SQLite) и многопользовательский режим
+- Каждый пользователь имеет свой отдельный файл базы данных (например, `vault_<user_uuid>.sqlite`). Это изолирует данные пользователей друг от друга и радикально упрощает будущую синхронизацию (не нужно фильтровать чужие записи).
+- **Схема таблицы `accounts` (задел под синхронизацию):**
+    - `id` (TEXT, UUIDv4) — Первичный ключ.
+    - `service_name` (TEXT) — Название сервиса.
+    - `encrypted_data` (BLOB) — Зашифрованный JSON с логином, паролем, ссылкой и тегами.
+    - `nonce` (BLOB) — Уникальный вектор инициализации для расшифровки XChaCha20.
+    - `updated_at` (INTEGER) — Unix timestamp последнего изменения. **Критично для будущей синхронизации** (разрешение конфликтов LWW - Last Write Wins).
+    - `is_deleted` (BOOLEAN) — Soft-delete (мягкое удаление). При удалении запись не стирается, а помечается удаленной, чтобы при будущей синхронизации другие устройства узнали об удалении.
+### 2.3. Биометрия (Touch ID / Windows Hello)
+- **Логика работы:** При успешном вводе Мастер-пароля, полученный ключ **DEK** шифруется средствами операционной системы (через системный Keyring/Связку ключей/Windows Credential Manager) и сохраняется там.
+- При следующем входе приложение запрашивает биометрическую аутентификацию через системный API (в Rust для этого используются крейты `keyring` или платформозависимые вызовы). При успехе ОС отдает приложению **DEK**, и база расшифровывается без ввода пароля.
+## 3. Frontend Архитектура (Angular + OOP)
+Код должен быть максимально модульным, тестируемым и следовать принципам SOLID.
+### 3.1. Основные слои (Dependency Injection)
+1. **Domain Models (Модели данных):** Классы `Account`, `UserVault`, `Tag`. Модели не содержат бизнес-логики, только структуру и методы-геттеры/сеттеры.
+2. **Services (Бизнес-логика):**
+    - `TauriIpcService`: Абстракция над `window.__TAURI__.invoke`. Реализует паттерн **Adapter**, изолируя Angular от специфики Tauri.
+    - `CryptoStrategyService`: Реализует паттерн **Strategy** для выбора метода авторизации (Мастер-пароль или Биометрия).
+    - `VaultService`: Управляет состоянием расшифрованных паролей в оперативной памяти (в виде RxJS `BehaviorSubject`). При блокировке приложения этот сервис немедленно очищает данные из памяти.
+3. **Components (UI):** Разделены на "Умные" (Smart/Container) — общаются с сервисами, и "Глупые" (Dumb/Presentational) — только отображают данные (кнопки, формы ввода, карточки паролей).
+### 3.2. Паттерны проектирования в UI
+- **Observer (через RxJS):** Компоненты подписываются на изменения в `VaultService`. Если в фоновом режиме (или через окно быстрого добавления) добавился пароль, список в главном окне обновляется реактивно.
+- **Visitor:** Для будущей реализации экспорта (в CSV, JSON). Класс `Account` принимает "посетителя" `CsvExportVisitor`, который знает, как правильно отформатировать поля аккаунта для выгрузки, не нарушая инкапсуляцию самого аккаунта.
+## 4. Подготовка к будущим фичам (Future-Proofing)
+### 4.1. Задел для облачной синхронизации
+Так как на старте используется локальный SQLite с полями `updated_at` и `is_deleted` (Soft-delete), в будущем реализация синхронизации сведется к написанию фонового процесса (в Rust), который будет:
+1. Запрашивать у сервера все записи с `updated_at` больше, чем время последней синхронизации.
+2. Отправлять на сервер локальные записи, которые изменились с момента последней синхронизации.
+3. Сервер (когда он появится) будет просто передавать зашифрованные BLOB-ы (E2E шифрование), ничего не зная о содержимом.
+### 4.2. Задел для браузерного расширения
+Чтобы расширение могло общаться с десктопным приложением (забирать пароли и сохранять новые), приложение на Tauri должно выступать в роли сервера.
+- **Архитектурное решение:** В ядре Rust поднимается легковесный локальный WebSocket-сервер или используется механизм **Native Messaging** (стандарт для Chrome/Firefox).
+- Все запросы от браузера проверяются на подлинность (расширение и десктопное приложение обмениваются криптографическими токенами при первичном сопряжении). На текущем этапе (MVP) этот сервер не реализуется, но API-функции для получения конкретного пароля по URL сайта на стороне Rust проектируются заранее, чтобы их можно было легко обернуть в сетевой интерфейс позже.
+## 5. Требования к UI / UX
+- **Горячие клавиши (Global Shortcuts):** Окно "быстрого добавления/поиска" (Spotlight-like) вызывается системным шорткатом (например, `Cmd/Ctrl + Shift + Space`). Работает глобально, даже если главное окно закрыто. Реализуется через `tauri-plugin-global-shortcut`.
+- **Генератор паролей:** Интегрирован прямо в форму создания аккаунта. При фокусе на поле "Пароль" предлагается сгенерированная строка. Сложность (длина, спецсимволы) настраивается в параметрах.
+- **Автоматическая блокировка:** По таймеру бездействия (настраивается пользователем, например, 5 минут) или при блокировке операционной системы приложение уничтожает расшифрованные данные из памяти Angular и требует повторного сканирования биометрии или ввода пароля.
+## 6. Структура проекта (Репозиторий и src-файлы)
+Проект строится по принципу монорепозитория, разделенного на два изолированных контекста: системный бэкенд (Tauri/Rust) и фронтенд-интерфейс (Angular).
+### 6.1. Backend: Ядро на Rust (`/src-tauri/src/`)
+Структура следует принципам чистого кода, жестко отделяя инфраструктуру Tauri от чистой бизнес-логики и работы с базой данных.
+- `main.rs` — Точка входа. Регистрация плагинов, глобальных шорткатов, инициализация БД и запуск Tauri-приложения.
+- `commands/` — Обработчики вызовов от фронтенда (Tauri IPC Commands). Здесь функции получают аргументы от UI и делегируют работу ядру.
+    - `auth.rs` (апи для авторизации и сканирования биометрии)
+    - `vault.rs` (сохранение и получение записей)
+- `core/` — Изолированная бизнес-логика, которая ничего не знает про Tauri (максимально тестируемый код).
+    - `crypto.rs` (реализация шифрования XChaCha20-Poly1305 и деривации ключей Argon2id)
+    - `password_gen.rs` (генератор надежных паролей)
+- `database/` — Слой абстракции над SQLite.
+    - `schema.sql` (миграции базы данных)
+    - `models.rs` (структуры данных Rust для маппинга таблиц БД)
+    - `repository.rs` (SQL-запросы и транзакции)
+- `events/` — Система Push-событий (Event-Driven Architecture).
+    - `emitter.rs` (отправка событий `system-locked`, `vault-updated` во фронтенд).
+### 6.2. Frontend: Angular App (`/src/`)
+Используется современный подход с Angular Standalone-компонентами (без лишнего бойлерплейта в виде `NgModules`). Структура директорий базируется на Domain-Driven Design (DDD) для строгого соблюдения принципов ООП.
+- `main.ts` — Точка входа фреймворка Angular.
+- `app/` — Корневая директория логики UI.
+    - `core/` — Базовая инфраструктура и Сервисы-синглтоны (существуют в единственном экземпляре).
+        - `services/tauri-event-bus.service.ts` (RxJS-адаптер, слушающий события от Rust)
+        - `services/crypto-strategy.service.ts` (паттерн Strategy для авторизации)
+        - `services/vault.service.ts` (хранение расшифрованного стейта в оперативной памяти)
+    - `models/` — Глобальные TypeScript-интерфейсы и ООП-классы Моделей.
+        - `account.model.ts` (включая методы для валидации и приема паттерна Visitor)
+        - `user.model.ts`
+    - `shared/` — «Глупые» (Dumb/Presentational) компоненты и UI-кит. Они не содержат бизнес-логики, только принимают данные и отдают события кликов.
+        - `components/account-card/` (карточка аккаунта)
+        - `components/password-input/` (компонент поля ввода с индикатором надежности)
+    - `features/` — «Умные» (Smart) компоненты, разделенные по бизнес-доменам приложения.
+        - `auth/` (экраны ввода мастер-пароля и биометрии)
+        - `main-window/` (весь интерфейс главного окна со списком паролей и настройками)
+        - `spotlight/` (изолированное окно быстрого добавления/поиска, вызываемое горячими клавишами)
+- `styles/` — Глобальные стили, Tailwind конфигурации и CSS-переменные темы.
+- `assets/` — Статические файлы (локальные шрифты, иконки).