the file structure has been created and the application's basic architecture has been defined

2026-03-21 19:33:45 +03:00
commit c0a1fa6273
68 changed files with 15904 additions and 0 deletions
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -0,0 +1,63 @@
+# Architectural Guidance: Кроссплатформенный Менеджер Паролей
+
+Эта документация детально описывает архитектурные решения, структуру проекта и стандарты разработки, обеспечивающие безопасность, масштабируемость и поддерживаемость системы.
+
+## 1. Архитектурные принципы и паттерны
+
+### Backend (Rust / Tauri)
+- **Separation of Concerns (SoC):** Четкое разделение между инфраструктурой Tauri (`commands/`), бизнес-логикой (`core/`) и слоем данных (`database/`).
+- **Dependency Inversion:** Ядро системы (`core/`) не зависит от деталей реализации Tauri.
+- **Repository Pattern:** Работа с SQLite инкапсулирована в репозиториях, что позволяет легко менять схему БД или переходить на другой движок.
+
+### Frontend (Angular)
+- **Domain-Driven Design (DDD):** Структура папок организована вокруг бизнес-доменов (`auth`, `vault`), а не технических типов (все компоненты в одной куче).
+- **Strategy Pattern:** Используется в `CryptoStrategyService` для гибкого переключения между методами аутентификации (пароль, биометрия).
+- **Adapter Pattern:** `TauriIpcService` скрывает детали взаимодействия с Tauri API, предоставляя чистые RxJS интерфейсы.
+- **Smart/Dumb Components:** Четкое разделение ответственности: "умные" компоненты управляют состоянием, "глупые" — только отображением.
+
+## 2. Структура папок и именование
+
+### Backend Structure (`src-tauri/src/`)
+```text
+src-tauri/src/
+├── commands/      # Обработчики IPC. Имя: [domain].rs (например, auth.rs)
+├── core/          # Математика и логика. Имя: [feature].rs (например, crypto.rs)
+├── database/      # SQL и миграции. 
+├── events/        # Рассылка событий во фронтенд.
+└── main.rs        # Конфигурация приложения.
+```
+
+### Frontend Structure (`src/app/`)
+```text
+src/app/
+├── core/          # Singleton сервисы (Crypto, Auth, Ipc)
+├── models/        # Классы сущностей. Имя: [name].model.ts
+├── shared/        # UI-кит (Buttons, Inputs, Cards)
+└── features/      # Модули фич. Свои компоненты, роуты и локальные сервисы.
+```
+
+## 3. Контракты и интерфейсы (Примеры)
+
+### IPC Command (Rust -> TS)
+**Rust:**
+```rust
+#[tauri::command]
+pub async fn decrypt_vault(password: String, vault_path: PathBuf) -> Result<VaultData, String> { ... }
+```
+
+**TypeScript:**
+```typescript
+interface VaultData {
+  accounts: AccountDTO[];
+  updatedAt: number;
+}
+```
+
+## 4. Стратегия безопасности
+1. **Zero Trust Storage:** Данные шифруются индивидуальным ключом DEK, который не хранится на диске без системной защиты (Keyring).
+2. **Memory Safety:** Rust гарантирует отсутствие утечек памяти в ядре. В Angular `VaultService` обязуется очищать `BehaviorSubject` при потере фокуса или блокировке.
+3. **Argon2id:** Минимум 2 прохода, 64МБ памяти (настраиваемо) для защиты от брутфорса.
+
+## 5. Управление зависимостями
+- **Rust:** Использование `cargo-edit` для контроля версий. Минимизация `unsafe` кода.
+- **Frontend:** Строгое следование версиям в `package.json`. Использование `ESLint` со строгими правилами для Angular.
--- a/docs/DESIGN.md
+++ b/docs/DESIGN.md
@@ -0,0 +1,97 @@
+```markdown
+# Design System Specification: Monolithic Security & Technical Elegance
+
+## 1. Overview & Creative North Star
+The Creative North Star for this design system is **"The Monolithic Vault."** 
+
+This system moves away from the "airy" and "playful" trends of modern SaaS, opting instead for a visual language rooted in utility, high-stakes security, and technical precision. It is an editorial approach to software where every element feels carved from a single block of obsidian. By utilizing intentional asymmetry, deep tonal layering, and "Ghost Borders," we create a high-end experience that feels both impenetrable and sophisticated.
+
+The goal is to provide a "Curated Technical" vibe—where the density of information (like the reference grid) is balanced by generous outer margins and sophisticated glass transitions. We break the template by treating the background not as a flat canvas, but as a series of receding depths.
+
+---
+
+## 2. Colors & Surface Philosophy
+The palette is built on deep blacks and "Noble Orange" accents, prioritizing retinal comfort and high-end aesthetic value.
+
+### Tonal Hierarchy
+- **Base (The Void):** `surface` (#131313) or `surface_container_lowest` (#0E0E0E). Used for the primary app background to establish depth.
+- **Surface (The Stage):** `surface_container` (#201F1F). Used for primary content areas.
+- **Elevated (The Highlight):** `surface_container_highest` (#353534). Used for cards or active nested containers.
+
+### The "No-Line" Rule
+Traditional 1px solid borders are strictly prohibited for sectioning. Boundaries must be defined through background color shifts. To separate a sidebar from a main feed, use `surface_container_low` against a `surface` background. The eye should perceive a change in "mass," not a line.
+
+### Surface Hierarchy & Nesting
+Think of the UI as physical layers. An inner table or data grid should occupy a `surface_container_lowest` slot, creating an "inset" feel (Neumorphic debt) within a `surface_container` parent. This "carved out" effect enhances the feeling of a technical tool.
+
+### Glass & Gradient Rule
+For floating elements (modals, active menu states, or dropdowns), utilize **Glassmorphism**.
+- **Fill:** `surface_bright` at 60% opacity.
+- **Backdrop-Blur:** 12px to 20px.
+- **Stroke:** Use the "Ghost Border" (1px `outline_variant` at 10% opacity) to catch the light.
+
+---
+
+## 3. Typography
+The typography strategy is "Technical Editorial." We pair the Swiss-style precision of **Inter** with the monospaced authority of **JetBrains Mono**.
+
+- **Inter (UI & Navigation):** Used for all structural elements. It provides a clean, neutral foundation that doesn't distract from the data.
+- **JetBrains Mono (Data & Codes):** Used for passwords, monetary values, timestamps, and technical labels. This injects a sense of "under-the-hood" transparency and precision.
+
+### Key Scales
+- **Display-LG (3.5rem):** High-contrast, low-tracking titles for impact.
+- **Headline-SM (1.5rem):** For primary section headers.
+- **Label-MD (0.75rem):** Always in JetBrains Mono for a technical, metadata feel.
+- **Body-MD (0.875rem):** The workhorse for all interface text.
+
+---
+
+## 4. Elevation & Depth
+In this design system, depth is achieved through **Tonal Layering** rather than structural geometry.
+
+- **The Layering Principle:** Avoid shadows for static layout components. Instead, place a `surface_container_lowest` card inside a `surface_container_low` section. This creates a soft, natural "recess" (Minimalist Neumorphism) without visual clutter.
+- **Ambient Shadows:** For floating components like Tooltips or Modals, use a "Shadow-Glow."
+  - **Blur:** 40px - 60px.
+  - **Opacity:** 6% of `on_surface`.
+  - **Color:** Tinted slightly toward the `primary` (#FFB694) to simulate light refraction.
+- **The "Ghost Border":** When high precision is required (as seen in the reference table header), use a 1px line at `outline_variant` (#574239) with only **10-15% opacity**. This should look like a faint reflection, not a structural divider.
+
+---
+
+## 5. Components
+
+### Buttons
+- **Primary:** `primary_container` (#C2571A) background with `on_primary_container` text. Use `sm` (0.125rem) or `none` roundedness for a sharper, monolithic look.
+- **Secondary:** Transparent background with a `Ghost Border`.
+- **Tertiary:** Text-only in `primary` color, used for low-priority actions.
+
+### Technical Grids (Tables)
+Follow the reference image logic:
+- **Header:** `surface_container_highest` with a subtle top "Ghost Border."
+- **Rows:** No horizontal lines. Use a slight color shift on `:hover` to `surface_bright` at 10% opacity.
+- **Spacing:** Use `spacing-4` (0.9rem) between data cells to ensure readability without lines.
+
+### Input Fields
+- **Container:** `surface_container_lowest` (#0E0E0E) to create an "inset" appearance.
+- **Focus State:** 1px "Ghost Border" at 30% opacity using `primary` color. No heavy glow.
+- **Font:** Use **JetBrains Mono** for the input text itself to emphasize the technical nature of the data.
+
+### Tooltips & Menus
+- Use the **Glassmorphism** rule.
+- Roundedness should be `md` (0.375rem) to slightly soften the technical edge for interactive elements.
+
+---
+
+## 6. Do's and Don'ts
+
+### Do
+- **Do** use `JetBrains Mono` for any value that feels like "data" (dates, amounts, IDs).
+- **Do** prioritize vertical whitespace over horizontal lines.
+- **Do** use `primary_container` (#C2571A) sparingly; it is a "noble" accent meant to guide the eye to critical actions only.
+- **Do** apply `backdrop-blur` to any element that sits "above" the base surface.
+
+### Don't
+- **Don't** use pure white (#FFFFFF) for text. Always use `on_surface` (#E5E2E1) or `on_surface_variant` (#DEC0B4) to maintain the premium dark-mode depth.
+- **Don't** use standard Material Design "Drop Shadows." They feel "cheap" in this monolithic context.
+- **Don't** use high roundedness (full circles) unless it is for a specific, functional icon container. Stick to `sm` and `none` for layout boxes.
+- **Don't** ever use a 100% opaque border for sectioning. It breaks the "Monolithic Vault" illusion.
--- a/docs/PRD.md
+++ b/docs/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/` — Статические файлы (локальные шрифты, иконки).
--- a/docs/TASKS.md
+++ b/docs/TASKS.md
@@ -0,0 +1,164 @@
+# Project Tasks: Кроссплатформенный Менеджер Паролей
+
+> [!NOTE]
+> Каждый тикет — одна атомарная единица работы: её можно взять, выполнить и смержить независимо от других.
+> Архитектурные решения описаны в [ARCHITECTURE.md](file:///Users/aleksandrebaklakov/Documents/Code/utils/abdristus/docs/ARCHITECTURE.md).
+
+---
+
+## `[INFRA]` — Инициализация и Инфраструктура
+
+- [x] **INFRA-01** Создать Tauri-проект (`tauri init`) с базовой конфигурацией `tauri.conf.json`
+- [ ] **INFRA-02** Создать Angular-проект с флагом `--standalone` (без NgModules)
+- [ ] **INFRA-03** Настроить Rust-зависимости в `Cargo.toml`: `argon2`, `chacha20poly1305`, `sqlx`, `keyring`, `uuid`
+- [ ] **INFRA-04** Настроить npm-зависимости: `@tauri-apps/api`, `rxjs`, установить ESLint + строгий TypeScript
+- [ ] **INFRA-05** Настроить `tauri-plugin-global-shortcut` в `main.rs`
+- [ ] **INFRA-06** Настроить глобальные CSS-переменные и тему (цвета, типографику из `DESIGN.md`)
+
+---
+
+## `[CRYPTO]` — Криптография (Rust · `core/crypto.rs`)
+
+- [ ] **CRYPTO-01** Реализовать генерацию случайной соли (`rand`) для Argon2id
+- [ ] **CRYPTO-02** Реализовать деривацию ключа DEK из Мастер-пароля через Argon2id (параметры: 2 прохода, ≥64 МБ)
+- [ ] **CRYPTO-03** Реализовать шифрование данных через XChaCha20-Poly1305 (возвращает `nonce` + `ciphertext`)
+- [ ] **CRYPTO-04** Реализовать дешифрование данных через XChaCha20-Poly1305 (принимает `nonce` + `ciphertext`)
+- [ ] **CRYPTO-05** Написать unit-тесты: шифрование → дешифрование возвращает исходные данные
+- [ ] **CRYPTO-06** Написать unit-тест: неверный nonce вызывает ошибку аутентификации
+
+---
+
+## `[PASSGEN]` — Генератор Паролей (Rust · `core/password_gen.rs`)
+
+- [ ] **PASSGEN-01** Реализовать генерацию пароля заданной длины из набора символов (буквы, цифры)
+- [ ] **PASSGEN-02** Добавить поддержку флага включения специальных символов
+- [ ] **PASSGEN-03** Написать unit-тест: результат соответствует заданным параметрам (длина, набор символов)
+
+---
+
+## `[DB]` — База Данных (Rust · `database/`)
+
+- [ ] **DB-01** Написать SQL-схему для таблицы `accounts` (`database/schema.sql`): поля `id`, `service_name`, `encrypted_data`, `nonce`, `updated_at`, `is_deleted`
+- [ ] **DB-02** Реализовать функцию создания/открытия изолированного файла БД `vault_<uuid>.sqlite` (`database/repository.rs`)
+- [ ] **DB-03** Определить Rust-структуры для маппинга таблиц БД (`database/models.rs`)
+- [ ] **DB-04** Реализовать `INSERT` — добавление новой зашифрованной записи (`repository.rs`)
+- [ ] **DB-05** Реализовать `SELECT` — получение всех записей по `vault_id` (с фильтром `is_deleted = false`)
+- [ ] **DB-06** Реализовать `UPDATE` — обновление записи и её поля `updated_at`
+- [ ] **DB-07** Реализовать `UPDATE` — Soft-delete записи (установка `is_deleted = true`)
+- [ ] **DB-08** Написать integration-тест для каждой операции репозитория (CRUD)
+
+---
+
+## `[AUTH]` — Аутентификация (Rust · `commands/auth.rs`)
+
+- [ ] **AUTH-01** Реализовать IPC-команду `unlock_vault`: принимает Мастер-пароль, возвращает успех/ошибку
+- [ ] **AUTH-02** Реализовать сохранение DEK в системный Keyring после успешного ввода Мастер-пароля (macOS Keychain)
+- [ ] **AUTH-03** Реализовать сохранение DEK в системный Keyring (Windows Credential Manager)
+- [ ] **AUTH-04** Реализовать IPC-команду `unlock_vault_biometric`: вытащить DEK из Keyring через biometric prompt (macOS Touch ID)
+- [ ] **AUTH-05** Реализовать IPC-команду `unlock_vault_biometric`: вытащить DEK из Keyring через biometric prompt (Windows Hello)
+- [ ] **AUTH-06** Реализовать IPC-команду `lock_vault`: сбросить сессионный DEK из памяти
+- [ ] **AUTH-07** Написать integration-тест для команды `unlock_vault` с корректным и некорректным паролем
+
+---
+
+## `[VAULT]` — Управление Записями (Rust · `commands/vault.rs`)
+
+- [ ] **VAULT-01** Реализовать IPC-команду `get_accounts`: расшифровать и вернуть все записи для текущей сессии
+- [ ] **VAULT-02** Реализовать IPC-команду `create_account`: принять данные от фронтенда, зашифровать через DEK, сохранить в БД
+- [ ] **VAULT-03** Реализовать IPC-команду `update_account`: обновить запись, выставить `updated_at`
+- [ ] **VAULT-04** Реализовать IPC-команду `delete_account`: выполнить soft-delete (`is_deleted = true`)
+- [ ] **VAULT-05** Написать integration-тест для каждой IPC-команды vault
+
+---
+
+## `[EVENTS]` — Push-события (Rust · `events/emitter.rs`)
+
+- [ ] **EVENTS-01** Реализовать эмиттер события `vault-updated` (отправляется после create/update/delete)
+- [ ] **EVENTS-02** Реализовать эмиттер события `system-locked` (отправляется при блокировке ОС или по таймеру)
+
+---
+
+## `[FE-CORE]` — Frontend: Сервисы и Ядро (Angular · `app/core/`)
+
+- [ ] **FE-CORE-01** Реализовать `TauriIpcService`: типизированная обертка над `window.__TAURI__.invoke`
+- [ ] **FE-CORE-02** Реализовать `TauriEventBusService`: RxJS-адаптер, слушающий события `vault-updated` и `system-locked`
+- [ ] **FE-CORE-03** Реализовать `VaultService`: `BehaviorSubject<Account[]>` для хранения сессионного стейта
+- [ ] **FE-CORE-04** В `VaultService`: реализовать метод `clear()` — сброс данных из памяти при блокировке
+- [ ] **FE-CORE-05** Реализовать `CryptoStrategyService`: интерфейс `AuthStrategy` с двумя реализациями — `MasterPasswordStrategy` и `BiometricStrategy`
+
+---
+
+## `[FE-MODELS]` — Frontend: Модели данных (Angular · `app/models/`)
+
+- [ ] **FE-MODELS-01** Определить интерфейс `AccountDTO` (raw данные от Rust)
+- [ ] **FE-MODELS-02** Реализовать класс `Account` с геттерами, валидацией и методом `accept(visitor)` для паттерна Visitor
+- [ ] **FE-MODELS-03** Реализовать класс `User` с полями профиля
+- [ ] **FE-MODELS-04** Реализовать `CsvExportVisitor` — экспорт аккаунтов в CSV через паттерн Visitor
+
+---
+
+## `[FE-SHARED]` — Frontend: UI-кит (Angular · `app/shared/`)
+
+- [ ] **FE-SHARED-01** Создать компонент `ButtonComponent` (primary / secondary / tertiary варианты из `DESIGN.md`)
+- [ ] **FE-SHARED-02** Создать компонент `PasswordInputComponent`: поле ввода + иконка показать/скрыть
+- [ ] **FE-SHARED-03** В `PasswordInputComponent`: добавить визуальный индикатор сложности пароля (weak / fair / strong)
+- [ ] **FE-SHARED-04** Создать компонент `AccountCardComponent`: отображение одной записи (сервис, логин, кнопки действий)
+- [ ] **FE-SHARED-05** Создать компонент `NotificationComponent`: toast-уведомления об ошибках и успехе
+
+---
+
+## `[FE-AUTH]` — Frontend: Экран Авторизации (Angular · `app/features/auth/`)
+
+- [ ] **FE-AUTH-01** Создать экран ввода Мастер-пароля: форма с `PasswordInputComponent`, кнопка «Войти»
+- [ ] **FE-AUTH-02** Подключить экран к `CryptoStrategyService` (`MasterPasswordStrategy`)
+- [ ] **FE-AUTH-03** Создать экран Биометрии: кнопка «Войти по биометрии», fallback на Мастер-пароль
+- [ ] **FE-AUTH-04** Подключить экран биометрии к `CryptoStrategyService` (`BiometricStrategy`)
+- [ ] **FE-AUTH-05** Реализовать навигацию: успешная авторизация → главное окно; ошибка → сообщение об ошибке
+
+---
+
+## `[FE-MAIN]` — Frontend: Главное Окно (Angular · `app/features/main-window/`)
+
+- [ ] **FE-MAIN-01** Создать layout главного окна: сайдбар + основной контент
+- [ ] **FE-MAIN-02** Реализовать список аккаунтов, подписанный на `VaultService` (реактивное обновление)
+- [ ] **FE-MAIN-03** Добавить строку поиска/фильтрации по названию сервиса
+- [ ] **FE-MAIN-04** Добавить фильтрацию по тегам
+- [ ] **FE-MAIN-05** Создать форму добавления записи: поля (сервис, логин, пароль, заметки, теги) + кнопка «Сгенерировать пароль»
+- [ ] **FE-MAIN-06** Подключить форму добавления к IPC-команде `create_account`
+- [ ] **FE-MAIN-07** Создать форму редактирования записи (переиспользует форму добавления, предзаполнена данными)
+- [ ] **FE-MAIN-08** Подключить форму редактирования к IPC-команде `update_account`
+- [ ] **FE-MAIN-09** Реализовать удаление записи с confirm-диалогом, использовать `delete_account`
+- [ ] **FE-MAIN-10** Создать экран Настроек: поле «таймер автоблокировки» (минуты), параметры генератора паролей
+
+---
+
+## `[FE-SPOTLIGHT]` — Frontend: Окно Spotlight (Angular · `app/features/spotlight/`)
+
+- [ ] **FE-SPOTLIGHT-01** Создать изолированный компонент Spotlight-окна (отдельный `BrowserWindow` в Tauri)
+- [ ] **FE-SPOTLIGHT-02** Реализовать строку быстрого поиска по аккаунтам (live-filter из `VaultService`)
+- [ ] **FE-SPOTLIGHT-03** Реализовать быстрое добавление аккаунта прямо из Spotlight-окна
+- [ ] **FE-SPOTLIGHT-04** Реализовать закрытие Spotlight-окна при потере фокуса (blur event)
+
+---
+
+## `[SYSUX]` — Системные UX-функции (Rust + Angular)
+
+- [ ] **SYSUX-01** Зарегистрировать глобальный шорткат (`Cmd/Ctrl+Shift+Space`) для открытия Spotlight (`main.rs`)
+- [ ] **SYSUX-02** Реализовать таймер бездействия на стороне Rust: по истечении отправлять событие `system-locked`
+- [ ] **SYSUX-03** Подписать Angular (`TauriEventBusService`) на событие `system-locked` → вызвать `VaultService.clear()` и перейти на экран авторизации
+- [ ] **SYSUX-04** Реализовать обработку события блокировки ОС (Rust) → отправлять `system-locked`
+
+---
+
+## `[TEST]` — Тестирование
+
+- [ ] **TEST-01** Unit-тесты криптографии (покрыты в тикетах CRYPTO-05, CRYPTO-06)
+- [ ] **TEST-02** Unit-тесты генератора паролей (покрыт в PASSGEN-03)
+- [ ] **TEST-03** Integration-тесты репозитория БД (покрыты в DB-08)
+- [ ] **TEST-04** Integration-тесты IPC-команд auth (покрыты в AUTH-07)
+- [ ] **TEST-05** Integration-тесты IPC-команд vault (покрыты в VAULT-05)
+- [ ] **TEST-06** Unit-тесты Angular сервисов (`VaultService`, `TauriIpcService`, `CryptoStrategyService`)
+- [ ] **TEST-07** E2E: создание нового сейфа и первый вход (Мастер-пароль)
+- [ ] **TEST-08** E2E: добавление и поиск записи в главном окне
+- [ ] **TEST-09** E2E: автоблокировка по таймеру — данные очищаются из памяти
+- [ ] **TEST-10** E2E: открытие Spotlight по глобальному шорткату
--- a/docs/spotlight-design/code.html
+++ b/docs/spotlight-design/code.html
@@ -0,0 +1,220 @@
+<!DOCTYPE html>
+
+<html class="dark" lang="en"><head>
+<meta charset="utf-8"/>
+<meta content="width=device-width, initial-scale=1.0" name="viewport"/>
+<title>VAULT_SECURE - Spotlight</title>
+<script src="https://cdn.tailwindcss.com?plugins=forms,container-queries"></script>
+<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800;900&amp;family=JetBrains+Mono:wght@400;500;700&amp;display=swap" rel="stylesheet"/>
+<link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:wght,FILL@100..700,0..1&amp;display=swap" rel="stylesheet"/>
+<script id="tailwind-config">
+      tailwind.config = {
+        darkMode: "class",
+        theme: {
+          extend: {
+            colors: {
+              "secondary-fixed": "#ffdbcc",
+              "on-primary": "#571f00",
+              "on-error-container": "#ffdad6",
+              "tertiary-fixed": "#cce5ff",
+              "primary-container": "#c2571a",
+              "outline-variant": "#574239",
+              "on-tertiary-container": "#00050d",
+              "on-tertiary": "#003351",
+              "surface": "#131313",
+              "surface-bright": "#3a3939",
+              "surface-dim": "#131313",
+              "on-tertiary-fixed-variant": "#004b73",
+              "primary-fixed": "#ffdbcc",
+              "on-error": "#690005",
+              "inverse-on-surface": "#313030",
+              "on-tertiary-fixed": "#001d31",
+              "on-primary-fixed-variant": "#7b2f00",
+              "inverse-surface": "#e5e2e1",
+              "on-secondary-fixed": "#351000",
+              "outline": "#a58b80",
+              "on-secondary-fixed-variant": "#6b3a22",
+              "tertiary-container": "#007dbd",
+              "surface-container": "#201f1f",
+              "secondary-fixed-dim": "#fdb696",
+              "background": "#131313",
+              "on-background": "#e5e2e1",
+              "surface-variant": "#353534",
+              "on-secondary-container": "#eaa586",
+              "error-container": "#93000a",
+              "on-surface-variant": "#dec0b4",
+              "secondary-container": "#6b3a22",
+              "on-surface": "#e5e2e1",
+              "on-primary-container": "#0f0200",
+              "surface-container-low": "#1c1b1b",
+              "surface-container-lowest": "#0e0e0e",
+              "tertiary-fixed-dim": "#93ccff",
+              "on-primary-fixed": "#351000",
+              "inverse-primary": "#a14000",
+              "error": "#ffb4ab",
+              "surface-container-high": "#2a2a2a",
+              "secondary": "#fdb696",
+              "surface-container-highest": "#353534",
+              "primary-fixed-dim": "#ffb694",
+              "on-secondary": "#4f240e",
+              "primary": "#ffb694",
+              "surface-tint": "#ffb694",
+              "tertiary": "#93ccff"
+            },
+            fontFamily: {
+              "headline": ["Inter"],
+              "body": ["Inter"],
+              "label": ["JetBrains Mono"],
+              "mono": ["JetBrains Mono"]
+            },
+            borderRadius: {"DEFAULT": "0.125rem", "lg": "0.25rem", "xl": "0.5rem", "full": "0.75rem"},
+          },
+        },
+      }
+    </script>
+<style>
+      .material-symbols-outlined {
+        font-variation-settings: 'FILL' 0, 'wght' 400, 'GRAD' 0, 'opsz' 24;
+      }
+      .ghost-border {
+        outline: 1px solid rgba(87, 66, 57, 0.15);
+      }
+      .glass-panel {
+        background: rgba(58, 57, 57, 0.6);
+        backdrop-filter: blur(20px);
+      }
+    </style>
+<style>
+    body {
+      min-height: max(884px, 100dvh);
+    }
+  </style>
+</head>
+<body class="bg-surface text-on-surface font-body selection:bg-primary-container selection:text-on-primary-container min-h-screen overflow-hidden">
+<!-- Background Layer (Simulating App Behind Spotlight) -->
+<div class="fixed inset-0 z-0 flex">
+<!-- NavigationDrawer -->
+<aside class="h-screen w-64 fixed left-0 top-0 bg-[#131313] flex flex-col py-6 px-4 opacity-20 pointer-events-none">
+<div class="mb-12">
+<span class="text-xl font-black tracking-tighter text-[#E5E2E1]">VAULT_SECURE</span>
+</div>
+<nav class="space-y-2">
+<div class="flex items-center gap-3 px-3 py-2 text-orange-500 font-bold border-r-2 border-orange-600 bg-orange-900/10">
+<span class="material-symbols-outlined">lock</span>
+<span class="font-['Inter'] font-medium text-sm tracking-tight">Vault</span>
+</div>
+<div class="flex items-center gap-3 px-3 py-2 text-[#DEC0B4]/60">
+<span class="material-symbols-outlined">verified_user</span>
+<span class="font-['Inter'] font-medium text-sm tracking-tight">Security Shield</span>
+</div>
+</nav>
+</aside>
+<!-- Main Content Placeholder -->
+<main class="ml-64 w-full p-12 opacity-10 pointer-events-none">
+<div class="grid grid-cols-12 gap-6">
+<div class="col-span-8 bg-surface-container h-64 rounded-lg"></div>
+<div class="col-span-4 bg-surface-container h-64 rounded-lg"></div>
+<div class="col-span-12 bg-surface-container-low h-96 rounded-lg"></div>
+</div>
+</main>
+</div>
+<!-- Spotlight Overlay Shell -->
+<div class="fixed inset-0 z-50 flex items-start justify-center pt-[132px] bg-[#0A0A0A]/40 backdrop-blur-md">
+<!-- Monolithic Spotlight Window -->
+<div class="w-full max-w-2xl bg-surface-container-lowest rounded-xl shadow-2xl overflow-hidden ghost-border animate-in fade-in zoom-in duration-300">
+<!-- Header/Search Bar -->
+<div class="flex items-center px-6 py-5 bg-surface-container-lowest border-b border-outline-variant/10">
+<span class="material-symbols-outlined text-on-surface-variant mr-4">search</span>
+<input autofocus="" class="w-full bg-transparent border-none focus:ring-0 text-xl font-headline placeholder:text-on-surface-variant/40 text-on-surface" placeholder="Start typing..." type="text"/>
+<div class="flex items-center gap-1.5 ml-4">
+<span class="px-1.5 py-0.5 rounded bg-surface-container-highest text-[10px] font-label text-on-surface-variant border border-outline-variant/20">ESC</span>
+</div>
+</div>
+<!-- Suggestion List -->
+<div class="p-2">
+<div class="px-4 py-2">
+<h3 class="text-[10px] font-label uppercase tracking-widest text-on-surface-variant/50">Actions</h3>
+</div>
+<div class="space-y-0.5">
+<!-- Action: Add account -->
+<div class="flex items-center justify-between px-4 py-3 bg-primary-container/10 group cursor-pointer border-l-2 border-primary-container">
+<div class="flex items-center gap-4">
+<div class="w-8 h-8 flex items-center justify-center bg-primary-container text-on-primary-container rounded-sm">
+<span class="material-symbols-outlined text-[20px]" data-weight="fill" style="font-variation-settings: 'FILL' 1;">person_add</span>
+</div>
+<div>
+<p class="text-sm font-semibold text-on-surface">Add account</p>
+<p class="text-xs font-label text-on-surface-variant/60">Initialize a new profile within the system</p>
+</div>
+</div>
+<div class="flex items-center gap-2">
+<span class="text-[10px] font-label text-primary opacity-0 group-hover:opacity-100 transition-opacity">Press Enter</span>
+<span class="material-symbols-outlined text-sm text-primary">keyboard_return</span>
+</div>
+</div>
+<!-- Action: Access Vault Data -->
+<div class="flex items-center justify-between px-4 py-3 hover:bg-surface-container-highest/50 group cursor-pointer transition-colors duration-150 border-l-2 border-transparent">
+<div class="flex items-center gap-4">
+<div class="w-8 h-8 flex items-center justify-center bg-surface-container-highest text-on-surface-variant rounded-sm">
+<span class="material-symbols-outlined text-[20px]">database</span>
+</div>
+<div>
+<p class="text-sm font-semibold text-on-surface">Access Vault Data</p>
+<p class="text-xs font-label text-on-surface-variant/60">Query the encrypted storage nodes</p>
+</div>
+</div>
+<div class="opacity-0 group-hover:opacity-100 transition-opacity">
+<span class="material-symbols-outlined text-sm text-on-surface-variant">chevron_right</span>
+</div>
+</div>
+<!-- Action: Recovery Code -->
+<div class="flex items-center justify-between px-4 py-3 hover:bg-surface-container-highest/50 group cursor-pointer transition-colors duration-150 border-l-2 border-transparent">
+<div class="flex items-center gap-4">
+<div class="w-8 h-8 flex items-center justify-center bg-surface-container-highest text-on-surface-variant rounded-sm">
+<span class="material-symbols-outlined text-[20px]">shield_moon</span>
+</div>
+<div>
+<p class="text-sm font-semibold text-on-surface">Recovery Code</p>
+<p class="text-xs font-label text-on-surface-variant/60">Backup phrase or 2FA seed</p>
+</div>
+</div>
+<div class="opacity-0 group-hover:opacity-100 transition-opacity">
+<span class="material-symbols-outlined text-sm text-on-surface-variant">chevron_right</span>
+</div>
+</div>
+</div>
+<!-- Section: Advanced -->
+<div class="px-4 py-2 mt-2">
+<h3 class="text-[10px] font-label uppercase tracking-widest text-on-surface-variant/50">Search Engine</h3>
+</div>
+<div class="px-2 pb-2">
+<div class="flex items-center gap-3 px-4 py-3 hover:bg-surface-container-highest/30 rounded cursor-pointer transition-all duration-200">
+<span class="material-symbols-outlined text-on-surface-variant/40">history</span>
+<span class="text-sm text-on-surface-variant">Search in activity log...</span>
+</div>
+</div>
+</div>
+<!-- Footer Meta -->
+<div class="px-6 py-3 bg-surface-container border-t border-outline-variant/10 flex items-center justify-between">
+<div class="flex items-center gap-4">
+<div class="flex items-center gap-1.5">
+<span class="material-symbols-outlined text-xs text-on-surface-variant">keyboard_arrow_up</span>
+<span class="material-symbols-outlined text-xs text-on-surface-variant">keyboard_arrow_down</span>
+<span class="text-[10px] font-label text-on-surface-variant">Navigate</span>
+</div>
+<div class="flex items-center gap-1.5">
+<span class="material-symbols-outlined text-xs text-on-surface-variant">keyboard_return</span>
+<span class="text-[10px] font-label text-on-surface-variant">Select</span>
+</div>
+</div>
+<div class="flex items-center gap-2">
+<span class="w-1.5 h-1.5 rounded-full bg-primary animate-pulse"></span>
+<span class="text-[10px] font-label text-on-surface-variant">SECURE_TUNNEL_ACTIVE</span>
+</div>
+</div>
+</div>
+</div>
+<!-- Visual Polish: Grain Overlay -->
+<div class="fixed inset-0 pointer-events-none opacity-[0.03] z-[100]" data-alt="Subtle noise texture for cinematic UI finish" style="background-image: url('https://lh3.googleusercontent.com/aida-public/AB6AXuAbfbfnVqdPzvsgoJIgZ55zFdozHNw52My4wLiSZfshpua5KaAtfDNsNyVJUd2OqMPubD3XTXnd4QKMGHL0shcM099MqtqUd4TVLoC_cKEr6_alJ1OHvwtHTtQGfzBB53yIH_uBiuGOT95b9VYp7NtpnV1yPiPOCxbEk9r2fmoToy-uTsYLPbwlB0wPkCTkha9Abfl3bsYRgQub7h2nHqBzb2mz5FUm1VDe7xAb7eG2nswCmh3l7HG8nVAdde72qPeGTZcMiq2YyKH8');">
+</div>
+</body></html>
--- a/docs/spotlight-design/screen.png
+++ b/docs/spotlight-design/screen.png
--- a/docs/vault-design/code.html
+++ b/docs/vault-design/code.html
@@ -0,0 +1,291 @@
+<!DOCTYPE html><html class="dark" lang="en"><head>
+<meta charset="utf-8">
+<meta content="width=device-width, initial-scale=1.0" name="viewport">
+<title>VAULT_SECURE | Password Management</title>
+<script src="https://cdn.tailwindcss.com?plugins=forms,container-queries"></script>
+<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800;900&amp;family=JetBrains+Mono:wght@400;500;700&amp;display=swap" rel="stylesheet">
+<link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:wght,FILL@100..700,0..1&amp;display=swap" rel="stylesheet">
+<style>
+        .font-mono { font-family: 'JetBrains Mono', monospace; }
+        .font-sans { font-family: 'Inter', sans-serif; }
+        .material-symbols-outlined {
+            font-variation-settings: 'FILL' 0, 'wght' 400, 'GRAD' 0, 'opsz' 24;
+        }
+        /* Custom scrollbar for the monolithic look */
+        ::-webkit-scrollbar { width: 4px; }
+        ::-webkit-scrollbar-track { background: #0E0E0E; }
+        ::-webkit-scrollbar-thumb { background: #353534; }
+    </style>
+<script id="tailwind-config">
+        tailwind.config = {
+            darkMode: "class",
+            theme: {
+                extend: {
+                    colors: {
+                        "secondary-fixed": "#ffdbcc",
+                        "on-primary": "#571f00",
+                        "on-error-container": "#ffdad6",
+                        "tertiary-fixed": "#cce5ff",
+                        "primary-container": "#c2571a",
+                        "outline-variant": "#574239",
+                        "on-tertiary-container": "#00050d",
+                        "on-tertiary": "#003351",
+                        "surface": "#131313",
+                        "surface-bright": "#3a3939",
+                        "surface-dim": "#131313",
+                        "on-tertiary-fixed-variant": "#004b73",
+                        "primary-fixed": "#ffdbcc",
+                        "on-error": "#690005",
+                        "inverse-on-surface": "#313030",
+                        "on-tertiary-fixed": "#001d31",
+                        "on-primary-fixed-variant": "#7b2f00",
+                        "inverse-surface": "#e5e2e1",
+                        "on-secondary-fixed": "#351000",
+                        "outline": "#a58b80",
+                        "on-secondary-fixed-variant": "#6b3a22",
+                        "tertiary-container": "#007dbd",
+                        "surface-container": "#201f1f",
+                        "secondary-fixed-dim": "#fdb696",
+                        "background": "#131313",
+                        "on-background": "#e5e2e1",
+                        "surface-variant": "#353534",
+                        "on-secondary-container": "#eaa586",
+                        "error-container": "#93000a",
+                        "on-surface-variant": "#dec0b4",
+                        "secondary-container": "#6b3a22",
+                        "on-surface": "#e5e2e1",
+                        "on-primary-container": "#0f0200",
+                        "surface-container-low": "#1c1b1b",
+                        "surface-container-lowest": "#0e0e0e",
+                        "tertiary-fixed-dim": "#93ccff",
+                        "on-primary-fixed": "#351000",
+                        "inverse-primary": "#a14000",
+                        "error": "#ffb4ab",
+                        "surface-container-high": "#2a2a2a",
+                        "secondary": "#fdb696",
+                        "surface-container-highest": "#353534",
+                        "primary-fixed-dim": "#ffb694",
+                        "on-secondary": "#4f240e",
+                        "primary": "#ffb694",
+                        "surface-tint": "#ffb694",
+                        "tertiary": "#93ccff"
+                    },
+                    fontFamily: {
+                        "headline": ["Inter"],
+                        "body": ["Inter"],
+                        "label": ["Inter"]
+                    },
+                    borderRadius: {"DEFAULT": "0.125rem", "lg": "0.25rem", "xl": "0.5rem", "full": "0.75rem"},
+                },
+            },
+        }
+    </script>
+<style>
+        body {
+            min-height: 100dvh;
+        }
+    </style>
+</head>
+<body class="bg-surface text-on-surface font-sans selection:bg-primary-container selection:text-on-primary-container">
+<!-- Main Content Canvas -->
+<main class="min-h-screen flex flex-col relative">
+<!-- TopAppBar -->
+<header class="fixed top-0 left-0 right-0 z-40 bg-[#131313]/80 backdrop-blur-xl flex items-center justify-between px-8 h-16 border-b border-[#574239]/10">
+<div class="flex items-center gap-6">
+<span class="text-xl font-black tracking-tighter text-[#E5E2E1]" style="">VAULT_SECURE</span>
+<div class="h-6 w-px bg-outline-variant/20 mx-2"></div>
+<div class="flex items-center gap-4 text-orange-600">
+<span class="material-symbols-outlined" data-icon="search" style="">search</span>
+<span class="font-['Inter'] font-semibold text-sm text-[#DEC0B4]" style="">Search Vault (⌘K)</span>
+</div>
+</div>
+<div class="flex items-center gap-6">
+<div class="hidden md:flex items-center gap-2 px-3 py-1 rounded bg-surface-container-highest border border-outline-variant/10">
+<span class="text-[10px] font-mono text-primary uppercase tracking-widest" style="">Master Key Status:</span>
+<span class="text-[10px] font-mono text-green-500 uppercase" style="">Verified</span>
+</div>
+<button class="text-[#DEC0B4] hover:bg-[#353534]/30 p-2 rounded transition-colors" style="">
+<span class="material-symbols-outlined" data-icon="account_circle" style="">account_circle</span>
+</button>
+</div>
+</header>
+<!-- Notification Toast -->
+<div class="fixed top-20 left-1/2 -translate-x-1/2 z-50 flex animate-in fade-in slide-in-from-top-4 duration-300">
+<div class="bg-surface-container border border-primary-container/50 px-6 py-3 rounded-lg flex items-center gap-4 shadow-2xl">
+<span class="material-symbols-outlined text-primary text-sm" data-icon="check_circle" style="">check_circle</span>
+<span class="text-sm font-medium" style="">Password Copied</span>
+<div class="h-4 w-px bg-outline-variant/30"></div>
+<span class="text-[10px] font-mono text-on-surface-variant" style="">0.4ms</span>
+</div>
+</div>
+<!-- Scrollable Content Area -->
+<div class="mt-16 p-4 md:p-10 flex-1 max-w-7xl mx-auto w-full">
+<!-- Action Header -->
+<div class="flex justify-between items-center mb-8">
+<div class="flex gap-4">
+<button class="text-xs font-mono uppercase tracking-widest text-primary border-b-2 border-primary pb-1" style="">All Items</button>
+<button class="text-xs font-mono uppercase tracking-widest text-on-surface-variant/60 hover:text-on-surface transition-colors pb-1" style="">Favorites</button>
+</div>
+<button class="bg-primary-container text-on-primary-container px-6 py-2 text-sm font-bold flex items-center gap-2 hover:opacity-90 transition-opacity" style="">
+<span class="material-symbols-outlined text-sm" data-icon="add" style="">add</span>
+                NEW ENTITY
+            </button>
+</div>
+<!-- Monolithic Data Grid -->
+<div class="bg-surface-container-lowest rounded-lg border border-outline-variant/10 overflow-hidden shadow-2xl">
+<!-- Grid Headers -->
+<div class="hidden md:grid grid-cols-12 gap-4 px-8 py-4 bg-surface-container-highest/40 border-b border-outline-variant/10">
+<div class="col-span-3 text-[10px] font-mono text-on-surface-variant uppercase tracking-widest" style="">Site / Application</div>
+<div class="col-span-2 text-[10px] font-mono text-on-surface-variant uppercase tracking-widest" style="">Login</div>
+<div class="col-span-2 text-[10px] font-mono text-on-surface-variant uppercase tracking-widest" style="">Email Address</div>
+<div class="col-span-3 text-[10px] font-mono text-on-surface-variant uppercase tracking-widest" style="">Security String</div>
+<div class="col-span-1 text-[10px] font-mono text-on-surface-variant uppercase tracking-widest" style="">Tags</div>
+<div class="col-span-1 text-right"></div>
+</div>
+<!-- Password Rows -->
+<div class="divide-y divide-outline-variant/5">
+<!-- Row 1 -->
+<div class="grid grid-cols-1 md:grid-cols-12 gap-4 px-8 py-6 items-center hover:bg-surface-bright/5 transition-colors group cursor-pointer border-l-2 border-transparent hover:border-primary">
+<div class="col-span-1 md:col-span-3 flex items-center gap-4">
+<div class="w-10 h-10 bg-surface-container-high flex items-center justify-center rounded-sm shrink-0">
+<span class="material-symbols-outlined text-primary" data-icon="play_circle" style="font-variation-settings: &quot;FILL&quot; 1;">play_circle</span>
+</div>
+<div class="flex flex-col overflow-hidden">
+<span class="text-sm font-bold truncate" style="">Disney Plus</span>
+<span class="text-[10px] text-on-surface-variant font-mono truncate" style="">disney.com</span>
+</div>
+</div>
+<div class="col-span-1 md:col-span-2">
+<span class="text-xs font-medium truncate block" style="">disney_premium_admin</span>
+</div>
+<div class="col-span-1 md:col-span-2">
+<span class="text-[10px] text-on-surface-variant font-mono truncate block" style="">admin@disney.corp</span>
+</div>
+<div class="col-span-1 md:col-span-3">
+<span class="font-mono text-on-surface-variant tracking-[0.2em] text-lg select-none" style="">••••••••••••••••</span>
+</div>
+<div class="col-span-1 md:col-span-1 flex gap-1 flex-wrap">
+<span class="px-2 py-0.5 bg-surface-variant text-[9px] font-mono text-on-surface-variant border border-outline-variant/20" style="">ENT.</span>
+</div>
+<div class="col-span-1 flex justify-end gap-2 md:opacity-0 group-hover:opacity-100 transition-opacity">
+<button class="text-on-surface-variant hover:text-primary transition-colors p-1" style="">
+<span class="material-symbols-outlined text-lg" data-icon="content_copy" style="">content_copy</span>
+</button>
+<button class="text-on-surface-variant hover:text-on-surface transition-colors p-1" style="">
+<span class="material-symbols-outlined text-lg" data-icon="more_vert" style="">more_vert</span>
+</button>
+</div>
+</div>
+<!-- Row 2 -->
+<div class="grid grid-cols-1 md:grid-cols-12 gap-4 px-8 py-6 items-center hover:bg-surface-bright/5 transition-colors group cursor-pointer border-l-2 border-transparent hover:border-primary">
+<div class="col-span-1 md:col-span-3 flex items-center gap-4">
+<div class="w-10 h-10 bg-surface-container-high flex items-center justify-center rounded-sm shrink-0">
+<span class="material-symbols-outlined text-[#DEC0B4]" data-icon="shield" style="">shield</span>
+</div>
+<div class="flex flex-col overflow-hidden">
+<span class="text-sm font-bold truncate" style="">AWS Console</span>
+<span class="text-[10px] text-on-surface-variant font-mono truncate" style="">console.aws.amazon.com</span>
+</div>
+</div>
+<div class="col-span-1 md:col-span-2">
+<span class="text-xs font-medium truncate block" style="">iam_root_security</span>
+</div>
+<div class="col-span-1 md:col-span-2">
+<span class="text-[10px] text-on-surface-variant font-mono truncate block" style="">root@sys.internal</span>
+</div>
+<div class="col-span-1 md:col-span-3">
+<span class="font-mono text-on-surface-variant tracking-[0.2em] text-lg select-none opacity-50" style="">••••••••••••••••</span>
+</div>
+<div class="col-span-1 md:col-span-1 flex gap-1 flex-wrap">
+<span class="px-2 py-0.5 bg-surface-variant text-[9px] font-mono text-on-surface-variant border border-outline-variant/20" style="">INFRA</span>
+</div>
+<div class="col-span-1 flex justify-end gap-2 md:opacity-0 group-hover:opacity-100 transition-opacity">
+<button class="text-on-surface-variant hover:text-primary transition-colors p-1" style="">
+<span class="material-symbols-outlined text-lg" data-icon="content_copy" style="">content_copy</span>
+</button>
+<button class="text-on-surface-variant hover:text-on-surface transition-colors p-1" style="">
+<span class="material-symbols-outlined text-lg" data-icon="more_vert" style="">more_vert</span>
+</button>
+</div>
+</div>
+<!-- Row 3 -->
+<div class="grid grid-cols-1 md:grid-cols-12 gap-4 px-8 py-6 items-center hover:bg-surface-bright/5 transition-colors group cursor-pointer border-l-2 border-transparent hover:border-primary">
+<div class="col-span-1 md:col-span-3 flex items-center gap-4">
+<div class="w-10 h-10 bg-surface-container-high flex items-center justify-center rounded-sm shrink-0">
+<span class="material-symbols-outlined text-[#DEC0B4]" data-icon="terminal" style="">terminal</span>
+</div>
+<div class="flex flex-col overflow-hidden">
+<span class="text-sm font-bold truncate" style="">GitHub Enterprise</span>
+<span class="text-[10px] text-on-surface-variant font-mono truncate" style="">github.com</span>
+</div>
+</div>
+<div class="col-span-1 md:col-span-2">
+<span class="text-xs font-medium truncate block" style="">dev_ops_internal</span>
+</div>
+<div class="col-span-1 md:col-span-2">
+<span class="text-[10px] text-on-surface-variant font-mono truncate block" style="">dev@github.com</span>
+</div>
+<div class="col-span-1 md:col-span-3">
+<span class="font-mono text-on-surface-variant tracking-[0.2em] text-lg select-none opacity-50" style="">••••••••••••••••</span>
+</div>
+<div class="col-span-1 md:col-span-1 flex gap-1 flex-wrap">
+<span class="px-2 py-0.5 bg-surface-variant text-[9px] font-mono text-on-surface-variant border border-outline-variant/20" style="">DEV</span>
+</div>
+<div class="col-span-1 flex justify-end gap-2 md:opacity-0 group-hover:opacity-100 transition-opacity">
+<button class="text-on-surface-variant hover:text-primary transition-colors p-1" style="">
+<span class="material-symbols-outlined text-lg" data-icon="content_copy" style="">content_copy</span>
+</button>
+<button class="text-on-surface-variant hover:text-on-surface transition-colors p-1" style="">
+<span class="material-symbols-outlined text-lg" data-icon="more_vert" style="">more_vert</span>
+</button>
+</div>
+</div>
+<!-- Row 4 -->
+<div class="grid grid-cols-1 md:grid-cols-12 gap-4 px-8 py-6 items-center hover:bg-surface-bright/5 transition-colors group cursor-pointer border-l-2 border-transparent hover:border-primary">
+<div class="col-span-1 md:col-span-3 flex items-center gap-4">
+<div class="w-10 h-10 bg-surface-container-high flex items-center justify-center rounded-sm shrink-0">
+<span class="material-symbols-outlined text-[#DEC0B4]" data-icon="token" style="">token</span>
+</div>
+<div class="flex flex-col overflow-hidden">
+<span class="text-sm font-bold truncate" style="">Stripe Merchant</span>
+<span class="text-[10px] text-on-surface-variant font-mono truncate" style="">dashboard.stripe.com</span>
+</div>
+</div>
+<div class="col-span-1 md:col-span-2">
+<span class="text-xs font-medium truncate block" style="">finance_primary_vault</span>
+</div>
+<div class="col-span-1 md:col-span-2">
+<span class="text-[10px] text-on-surface-variant font-mono truncate block" style="">billing@stripe.com</span>
+</div>
+<div class="col-span-1 md:col-span-3">
+<span class="font-mono text-on-surface-variant tracking-[0.2em] text-lg select-none opacity-50" style="">••••••••••••••••</span>
+</div>
+<div class="col-span-1 md:col-span-1 flex gap-1 flex-wrap">
+<span class="px-2 py-0.5 bg-surface-variant text-[9px] font-mono text-on-surface-variant border border-outline-variant/20" style="">FIN</span>
+</div>
+<div class="col-span-1 flex justify-end gap-2 md:opacity-0 group-hover:opacity-100 transition-opacity">
+<button class="text-on-surface-variant hover:text-primary transition-colors p-1" style="">
+<span class="material-symbols-outlined text-lg" data-icon="content_copy" style="">content_copy</span>
+</button>
+<button class="text-on-surface-variant hover:text-on-surface transition-colors p-1" style="">
+<span class="material-symbols-outlined text-lg" data-icon="more_vert" style="">more_vert</span>
+</button>
+</div>
+</div>
+</div>
+</div>
+</div>
+<!-- Footer Visual Decoration -->
+<footer class="mt-auto px-10 py-6 flex justify-between items-center border-t border-outline-variant/5 bg-surface-container-lowest/50">
+<div class="flex gap-8">
+<div class="flex flex-col">
+<span class="text-[8px] font-mono text-on-surface-variant uppercase" style="">End-to-End Encryption</span>
+<span class="text-[10px] font-mono text-green-500" style="">AES-256-GCM ACTIVE</span>
+</div>
+</div>
+<div class="text-[10px] font-mono text-on-surface-variant/40" style="">
+            © 2024 VAULT_SECURE / VER_4.1.0_MINIMAL
+        </div>
+</footer>
+</main>
+</body></html>
--- a/docs/vault-design/screen.png
+++ b/docs/vault-design/screen.png