AWatch-rus/docs/diagrams/webui-patches.md

# WebUI Russian Localization Patches - Компонентная диаграмма

## Обзор
Система патчей для русификации и адаптации ActivityWatch WebUI под российские требования.

## Архитектура

```mermaid
graph TB
    subgraph "Patch System"
        A[Patch Loader]
        B[DOM Injection]
        C[Style Injection]
        D[Navigation Patches]
        E[DLP Center Injection]
        F[Host Groups Center]
        G[Category Builder Patch]
        H[Text Translation]
    end

    subgraph "ActivityWatch WebUI"
        I[Original WebUI]
        J[DOM Structure]
        K[Vue Components]
        L[Router]
        M[Axios API]
    end

    subgraph "Patch Targets"
        N[Navigation Menu]
        O[Activity View]
        P[Category Builder]
        Q[Buckets View]
        R[Settings]
    end

    A --> B
    A --> C
    A --> D
    A --> E
    A --> F
    A --> G
    A --> H
    
    B --> J
    C --> J
    D --> L
    E --> K
    F --> K
    G --> K
    H --> K
    
    D --> N
    E --> K
    F --> K
    G --> P
    H --> O
    
    I --> J
    I --> K
    I --> L
    
    style B fill:#ff6b6b
    style C fill:#ff6b6b
    style E fill:#4ecdc4
    style F fill:#4ecdc4
    style H fill:#ffe66d
```

## Потоки данных

### Patch Application Flow
```mermaid
sequenceDiagram
    participant User as Browser
    participant WebUI as AW WebUI
    participant Loader as Patch Loader
    participant DOM as DOM Manipulator
    participant API as AW API

    User->>WebUI: Load page
    WebUI->>Loader: Trigger patch application
    Loader->>Loader: Check route
    Loader->>DOM: Inject DLP center
    DOM->>DOM: Modify navigation
    DOM->>DOM: Add Russian styles
    Loader->>DOM: Translate text elements
    DOM->>DOM: Replace text with Russian
    Loader->>API: Fetch Russian data
    API->>Loader: Return translated data
    Loader->>DOM: Update UI with Russian
    DOM->>User: Render patched UI
```

### DLP Center Injection Flow
```mermaid
graph LR
    A[Route Check] --> B{Is DLP route?}
    B -->|Yes| C[Load DLP Center Component]
    B -->|No| D[Skip DLP injection]
    C --> E[Inject into DOM]
    E --> F[Bind Events]
    F --> G[Load DLP Data]
    G --> H[Render DLP UI]
```

## Ключевые функции

### Загрузка патчей
- `aw_ru_patch_applypatch()` - применение патча
- `aw_ru_patch_scheduleapplypatch()` - отложенное применение
- `aw_ru_patch_ensurehostgroupsdata()` - обеспечение данных групп хостов

### Инъекция компонентов
- `aw_ru_patch_injectdlpnavigation()` - инъекция DLP навигации
- `aw_ru_patch_injectdlpreviewcenter()` - инъекция центра просмотра DLP
- `aw_ru_patch_injectdlpalertscenter()` - инъекция центра алертов
- `aw_ru_patch_injecthostgroupscenter()` - инъекция центра групп хостов
- `aw_ru_patch_injectpveauditcenter()` - инъекция центра аудита PVE

### Патчи навигации
- `aw_ru_patch_findprimarynavlist()` - поиск главного меню
- `aw_ru_patch_hidenoisenavigation()` - скрытие лишних пунктов
- `aw_ru_patch_removebaddlplinks()` - удаление битых DLP ссылок
- `aw_ru_patch_updatedlplinks()` - обновление DLP ссылок

### Патчи представлений
- `aw_ru_patch_enforcesafeactivityviewforpvehost()` - безопасный вид для PVE
- `aw_ru_patch_collapsereviewevents()` - сворачивание событий ревью
- `aw_ru_patch_collapseruleevents()` - сворачивание событий правил
- `aw_ru_patch_loadbucketevents()` - загрузка событий bucket

### Группы хостов
- `aw_ru_patch_getdefaulthostgroupsconfig()` - конфигурация групп по умолчанию
- `aw_ru_patch_matchhostgroup()` - сопоставление группы хоста
- `aw_ru_patch_renderhostgroupcards()` - рендер карточек групп
- `aw_ru_patch_hosthasbucketprefix()` - проверка префикса bucket

### Перевод
- `aw_ru_patch_translateattributes()` - перевод атрибутов
- `aw_ru_patch_normalizetext()` - нормализация текста
- `aw_ru_patch_escapehtml()` - экранирование HTML

### Утилиты
- `aw_ru_patch_replacetext()` - замена текста
- `aw_ru_patch_walk()` - обход DOM
- `aw_ru_patch_ishomeroute()` - проверка домашнего маршрута
- `aw_ru_patch_ispvelikehost()` - проверка PVE хоста

## Структура патчей

### Патчи по маршрутам
```javascript
const routePatches = {
  '/': 'home-patch',
  '/activity': 'activity-patch',
  '/buckets': 'buckets-patch',
  '/category-builder': 'category-builder-patch',
  '/dlp/review': 'dlp-review-patch',
  '/dlp/rules': 'dlp-rules-patch',
  '/dlp/alerts': 'dlp-alerts-patch'
};
```

### Инъекции DLP компонентов
```javascript
const dlpInjections = {
  navigation: 'inject-dlp-nav',
  reviewCenter: 'inject-dlp-review',
  rulesManager: 'inject-dlp-rules',
  alertsCenter: 'inject-dlp-alerts'
};
```

### Русификация
```javascript
const translations = {
  'Activity': 'Активность',
  'Buckets': 'Бакеты',
  'Duration': 'Длительность',
  'Events': 'События',
  'Settings': 'Настройки'
};
```

## Конфигурация

### Host Groups Config
```json
{
  "host_groups": [
    {
      "id": "workstations",
      "name": "Рабочие станции",
      "hosts": ["WORKSTATION01", "WORKSTATION02"],
      "color": "#4ecdc4"
    },
    {
      "id": "servers",
      "name": "Серверы",
      "hosts": ["SERVER01", "SERVER02"],
      "color": "#ff6b6b"
    }
  ]
}
```

### DLP Settings
```json
{
  "dlp_enabled": true,
  "review_center_enabled": true,
  "alerts_center_enabled": true,
  "auto_refresh_interval": 30,
  "default_severity_filter": "all"
}
```

## Компоненты UI

### DLP Review Center
- Список инцидентов
- Фильтрация по типам
- Детальный просмотр
- Архивирование
- Экспорт

### DLP Rules Manager
- Список правил
- Создание/редактирование
- Включение/выключение
- Тестирование правил
- Импорт/экспорт

### DLP Alerts Center
- Алерты в реальном времени
- Группировка по серьезности
- История алертов
- Подписки на алерты

### Host Groups Center
- Управление группами хостов
- Визуализация по группам
- Агрегированная статистика
- Сравнение групп

## Интеграция с ActivityWatch

### API Endpoints
```javascript
// Получение DLP инцидентов
GET /api/0/buckets/{bucket_id}/events?filters=dlp_incident

// Получение правил DLP
GET /api/0/dlp/rules

// Сохранение инцидента
POST /api/0/dlp/incident

// Получение групп хостов
GET /api/0/host_groups
```

### Bucket Prefixes
```
aw-watcher-dlp-endpoint-*
aw-watcher-browser-domains-*
aw-watcher-email-outbound-*
```

## Стили

### Russian UI Styles
```css
.ru-font {
  font-family: 'Segoe UI', 'Roboto', sans-serif;
}

.ru-nav-item {
  padding: 8px 16px;
  border-radius: 4px;
}

.ru-dlp-card {
  border-left: 4px solid #ff6b6b;
  background: #fff5f5;
}
```

## Производительность

### Оптимизации
- Lazy loading патчей
- Кэширование переводов
- Debouncing обновлений DOM
- Virtual scrolling для больших списков

### Метрики
- Время применения патча
- Количество модификаций DOM
- Частота перерисовки
- Размер загружаемых переводов

## Отладка

### Логирование патчей
```javascript
console.log('[AW-RU-Patch] Applying patch:', patchName);
console.log('[AW-RU-Patch] Route:', currentRoute);
console.log('[AW-RU-Patch] Elements modified:', count);
```

### Режим разработки
```javascript
const DEBUG_MODE = true;

if (DEBUG_MODE) {
  window.AW_RU_PATCHES = {
    applied: [],
    skipped: [],
    errors: []
  };
}
```

## Совместимость

### Поддерживаемые версии ActivityWatch
- v0.12.x
- v0.13.x
- v0.14.x

### Поддерживаемые браузеры
- Chrome 90+
- Firefox 88+
- Edge 90+
- Safari 14+