papayu/AUDIT.md

# Полный аудит приложения PAPA YU

**Дата:** 2026-01-28  
**Цель:** проверка компонентов, связей UI ↔ backend, исправление отображения блока выбора пути к папкам и заключение.

---

## 1. Структура проекта

| Путь | Назначение |
|------|------------|
| `src/` | React (Vite) — UI |
| `src/pages/Tasks.tsx` | Страница «Задачи» — анализ проекта, выбор папок, preview/apply/undo/redo |
| `src/pages/Dashboard.tsx` | Страница «Панель управления» |
| `src/App.tsx` | Роутинг, Layout (header + main) |
| `src-tauri/src/` | Rust (Tauri) — команды, tx, types |

---

## 2. Проверенные компоненты

### 2.1 UI

- **App.tsx** — маршруты `/` (Tasks), `/control-panel` (Dashboard). Layout: header с навигацией, main с `overflow: visible` (исправлено).
- **Tasks.tsx** — блок «Путь к папке проекта»:
  - Расположен **первым** под заголовком «Анализ проекта».
  - Секция с `data-section="path-selection"` и классом `tasks-sources`.
  - Две кнопки: **«Выбрать папку»** (основная синяя), **«+ Добавить ещё папку»**.
  - Список выбранных папок или текст «Папки не выбраны. Нажмите кнопку «Выбрать папку» выше.».
  - Ниже: поле ввода пути и кнопка «Отправить».
- **index.css** — правило для `.tasks-sources[data-section="path-selection"]`: `display: block !important`, `visibility: visible !important`, чтобы блок не скрывался.

### 2.2 Связи UI → Backend (invoke)

| Действие в UI | Команда Tauri | Файл Rust |
|---------------|---------------|-----------|
| Загрузка списка папок при монтировании | `get_folder_links` | folder_links.rs |
| Сохранение списка папок | `set_folder_links` (links: { paths }) | folder_links.rs |
| Анализ + preview + apply (пакет) | `run_batch_cmd` (payload: paths, confirm_apply, auto_check, selected_actions) | run_batch.rs |
| Состояние undo/redo | `get_undo_redo_state_cmd` | undo_last.rs, tx/store.rs |
| Откат | `undo_last` | undo_last.rs |
| Повтор | `redo_last` | redo_last.rs |
| Генерация плана (v2.4) | `generate_actions` | generate_actions.rs |

Выбор папки через диалог: `open({ directory: true })` из `@tauri-apps/plugin-dialog` — плагин зарегистрирован в `lib.rs` (`tauri_plugin_dialog::init()`).

---

## 3. Backend (Rust)

### 3.1 Зарегистрированные команды (lib.rs)

- `analyze_project_cmd`, `preview_actions_cmd`, `apply_actions_cmd`, `run_batch_cmd`
- `undo_last`, `undo_available`, `redo_last`, `get_undo_redo_state_cmd`
- `generate_actions`
- `get_folder_links`, `set_folder_links`

### 3.2 Модули

- **commands/** — analyze_project, apply_actions, preview_actions, run_batch, undo_last, redo_last, generate_actions, folder_links, auto_check.
- **tx/** — limits (preflight), store (undo/redo stacks), mod (snapshot_before, rollback_tx, apply_actions_to_disk, collect_rel_paths, write_manifest, read_manifest, etc.).
- **types** — ApplyPayload, ApplyResult, TxManifest, Action, ActionKind, AnalyzeReport, BatchPayload, BatchEvent, etc.

### 3.3 Folder links

- `FolderLinks { paths: Vec<String> }` — сериализуется в `app_data_dir/folder_links.json`.
- `load_folder_links`, `save_folder_links` — используются в `get_folder_links` / `set_folder_links`.

Связь с UI: при загрузке Tasks вызывается `get_folder_links` и при необходимости обновляется `folderLinks`; при добавлении/удалении папки вызывается `set_folder_links`. Формат `{ links: { paths } }` соответствует типу `FolderLinks`.

---

## 4. Внесённые исправления

1. **Блок выбора пути к папке (Tasks.tsx)**
   - Секция «Путь к папке проекта» вынесена в начало страницы (сразу под заголовком).
   - Заголовок секции: «Путь к папке проекта», подпись с указанием нажать кнопку или ввести путь.
   - Кнопки «Выбрать папку» и «+ Добавить ещё папку» оформлены заметно (размер, контраст, тень у основной).
   - Добавлены `className="tasks-sources"` и `data-section="path-selection"` для стилей и отладки.
   - Секция с рамкой, фоном и `minHeight: 140px`, чтобы блок всегда занимал место и был виден.
   - В строке ввода оставлены только поле пути и «Отправить» (дублирующая кнопка «Выбрать папку» убрана, чтобы не путать с блоком выше).

2. **Layout (App.tsx)**  
   - Для `main` заданы `overflow: visible` и `minHeight: 0`, чтобы контент не обрезался.

3. **Глобальные стили (index.css)**  
   - Добавлено правило для `.tasks-sources[data-section="path-selection"]`: блок принудительно видим.

---

## 5. Рекомендации после обновления кода

- Перезапустить приложение: `cd papa-yu/src-tauri && cargo tauri dev`.
- В браузере/WebView сделать жёсткое обновление (Ctrl+Shift+R / Cmd+Shift+R), чтобы подтянуть новый UI без кэша.
- Если используется только фронт (Vite): перезапустить `npm run dev` и обновить страницу.

После этого в начале страницы «Задачи» должен отображаться блок «Путь к папке проекта» с кнопками «Выбрать папку» и «+ Добавить ещё папку» и списком выбранных папок.

---

## 6. Заключение

- **Компоненты:** App, Tasks, Dashboard, Layout и точки входа (main.tsx, index.html) проверены; маршруты и вложенность корректны.
- **Связи UI ↔ backend:** вызовы `get_folder_links`, `set_folder_links`, `run_batch_cmd`, `get_undo_redo_state_cmd`, `undo_last`, `redo_last` соответствуют зарегистрированным командам и типам (FolderLinks, BatchPayload, ApplyPayload и т.д.).
- **Исправления:** блок выбора пути к папкам сделан первым и визуально выделен; добавлены гарантии видимости через разметку и CSS; дублирование кнопки убрано.
- **Ошибки:** явных ошибок в компонентах и связях не выявлено. Если на экране по-прежнему не видно кнопок и блока, наиболее вероятны кэш сборки или WebView — выполнить перезапуск и жёсткое обновление по п. 5.

Аудит выполнен. Состояние: **исправления внесены, рекомендации по обновлению даны.**