Files
ss-tools/ui-audit-report.md
2026-05-19 18:36:15 +03:00

307 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# UI Audit Report — Superset Tools (http://localhost:8100)
**Дата проверки:** 19.05.2026
**Пользователь:** admin / admin123
**Окружение:** dev (https://ss-dev.bebesh.ru)
**Всего разделов:** ~20 страниц
---
## Сводка
| Категория | Кол-во |
|---|---|
| 🟢 Работает корректно | 8 |
| 🟡 Требует доработки | 7 |
| 🔴 Не работает / пусто | 5 |
| 🔄 Дублирование функционала | 4 |
---
## 1. ДЭШБОРДЫ ( /dashboards )
### 1.1 Обзор ( /dashboards )
**Статус:** 🟢 Работает
- Таблица с 10 дашбордами, загруженными из Superset
- Колонки: Заголовок, GIT, Статус LLM пров., Действия, Дата изменения, Владельцы
- Фильтры: поиск, сортировка по колонкам, "Активны фильтры профиля"
- Действия для каждого дашборда: Мигрировать, Проверить, Создать бэкап
**Проблемы:**
- У всех дашбордов статус "НЕТ РЕПО" — Git не настроен ни для одного дашборда
- Кнопки "Выбрать все" / "Выбрать видимые" — нет индикатора сколько выбрано
- Breadcrumb показывает "nav.dashboard" (непереведённый ключ)
### 1.2 Центр здоровья ( /dashboards/health )
**Статус:** 🟡 Требует доработки
- Страница существует, есть фильтр по окружению
- **Нет данных:** все счётчики 0, "Записи валидации не найдены"
- Вероятно, не запускалась валидация дашбордов (LLM check)
- Пустая таблица деталей валидации
---
## 2. ДАТАСЕТЫ
### 2.1 Все датасеты ( /datasets )
**Статус:** 🔴 Пустая страница
- Показывает только "Датасеты" + "Окружение: dev"
- **Нет списка датасетов**, нет таблицы, нет контента
- Breadcrumb показывает "Маппер колонок" — несоответствие навигации
### 2.2 Review Workspace ( /datasets/review )
**Статус:** 🟢 Работает
- Интерфейс для review-сессий датасетов
- Два способа старта: "Ссылка Superset" и "Выбор датасета"
- Селектор окружения, поле URL Superset
- Кнопка "Старт по ссылке" disabled (нет URL)
---
## 3. МИГРАЦИЯ
### 3.1 Обзор ( /migration )
**Статус:** 🟡 Требует доработки
- Список задач миграции: 2 задачи system-debug (SUCCESS)
- Source и Target окружения — **только dev доступен** (мигрировать некуда)
- Кнопки "Dry Run" и "Запустить миграцию" **disabled**
- Фильтр "Fix Cross-Filters" и "Заменить БД" — есть, но неактивны без выбора дашбордов
### 3.2 Маппинги ( /migration/mappings )
**Статус:** 🔴 Не работает
- Выбор source/target окружений (только dev)
- Кнопка "Получить БД и подсказки" **disabled**
- Нет данных, нет таблицы маппингов
---
## 4. GIT ( /git )
### 4.1 Состояние репозитория
**Статус:** 🟢 Работает (но данных нет)
- Список дашбордов с полями "ЗАГОЛОВОК", "ПОСЛЕДНЕЕ ИЗМЕНЕНИЕ", "СТАТУС"
- Все дашборды: "Нет репозитория"
- Пагинация: 10 дашбордов, кнопки "Назад"/"Вперед" disabled
- **Git не интегрирован** — ни один дашборд не привязан к репозиторию
---
## 5. ПЕРЕВОДЫ (TRANSLATE)
### 5.1 Задания ( /translate )
**Статус:** 🟢 Работает
- Фильтры: All (1), Черновик, Готово, Выполняется, Завершено, Ошибка
- Одна задача "test" со статусом "READY"
- Действия: Дублировать, Удалить
### 5.2 Словари ( /translate/dictionaries )
**Статус:** 🟢 Работает (пусто)
- "Словарей пока нет", кнопка "Создайте первый словарь"
### 5.3 История ( /translate/history )
**Статус:** 🟡 Требует доработки
- **Счётчики не соответствуют:** "Всего запусков: 4", "Успешных: 0", "Ошибок: 3", но в списке задач было "Готово (1)"
- 4 запуска задачи "test": 3 FAILED (100% ошибок), 1 CANCELLED (78 ошибок)
- Все строки в каждом запуске: "0 ок" / "100 ошибок" — **перевод полностью не работает**
- Кнопка "Повторить ошибки" есть, но неясно работает ли
- Фильтры: по задаче, статусу, триггеру, дате
---
## 6. ОТЧЕТЫ ( /reports )
**Статус:** 🟡 Требует доработки
- 2 отчёта от system-debug задач (242377ce, 5f557d5e)
- **Оба отображаются как "Прочее / Неизвестный тип"** — классификация не работает
- Фильтры: по типу (LLM, Бэкапы, Миграция, Documentation) и статусу
- **UX-проблема:** Сырой JSON (дамп Superset API) отображается прямо на странице как текст — нечитаемо для пользователя
---
## 7. ИНСТРУМЕНТЫ (TOOLS)
### 7.1 Маппер колонок ( /tools/mapper )
**Статус:** 🟢 Работает
- Форма: окружение, ID датасета, источник маппинга (PostgreSQL/Excel)
- "Сохраненное подключение" — пустой выпадающий список
- Кнопки: "Сгенерировать документацию", "Запустить маппер"
- **Дублирование:** тот же "Маппер колонок" доступен из раздела "Датасеты"
### 7.2 Диагностика ( /tools/debug )
**Статус:** 🟢 Работает
- 2 действия: "Проверить Database API" и "Получить структуру датасета (JSON)"
- Source/Target окружения (только dev)
- Кнопка "Запустить диагностику"
### 7.3 Файловое хранилище ( /tools/storage )
**Статус:** 🟡 Требует доработки
- 2 папки: `backups` (11.03.2026) и `repositorys` (17.05.2026)
- **Опечатка:** "repositorys" → должно быть "repositories"
- Загрузка файлов по категориям: Бэкапы / Репозитории
- **Дублирование:** "Хранилище > Бэкапы" ведёт на этот же URL (/tools/storage)
### 7.4 Бэкапы ( /tools/backups )
**Статус:** 🟡 Требует доработки
- 3 существующих бэкапа: SS-PREPROD, SS1, SS2 (без дат — "--")
- Кнопка "Начать бэкап" **disabled** (не выбран окружение)
- Кнопка "Перейти к хранилищу" — ведёт в /tools/storage
---
## 8. ХРАНИЛИЩЕ (STORAGE)
### 8.1 Бэкапы → /tools/storage
**Статус:** 🔄 Дублирует "Инструменты > Файловое хранилище"
### 8.2 Репозитории ( /storage/repos )
**Статус:** 🔴 Не работает
- Зависает на "Загрузка..." — данные не загружаются
- Breadcrumb: Файловое хранилище > Repos
---
## 9. АДМИН (ADMIN)
### 9.1 Пользователи ( /admin/users )
**Статус:** 🟢 Работает
- 1 пользователь: admin (LOCAL, Admin, Активен)
- CRUD: Создать, Редактировать, Удалить
### 9.2 Роли ( /admin/roles )
**Статус:** 🟢 Работает
- 1 роль: Admin (System Administrator)
- CRUD: Создать, Редактировать, Удалить
### 9.3 Настройка ADFS ( /admin/settings )
**Статус:** 🟢 Работает
- AD group mapping (пусто) — кнопка "Добавить маппинг"
- Настройка логирования: уровень DEBUG (приложение), INFO (задачи)
- Belief State logging (Beta) — включён
### 9.4 Провайдеры LLM ( /admin/settings/llm )
**Статус:** 🟢 Работает
- 1 провайдер: "kilo free" (qwen/qwen3.6-flash), активен
- Назначение задач: Dashboard check, Documentation, Git commit
- Шаблоны промптов (английские, редактируемые)
- **Проблема:** все провайдеры по умолчанию стоят "По умолчанию" — неясно какой провайдер используется
---
## 10. СИСТЕМНЫЕ ЭЛЕМЕНТЫ
### 10.1 AI Ассистент (слайд-панель)
**Статус:** 🟡 Требует доработки
- Открывается как боковая панель
- Диалоги: Новый, Активные (1), Архив (0)
- **Команда "Привет" не распознана** — ответ "Команда неоднозначна. Уточните действие: git / migration / backup / llm / status"
- Нет приветственного сообщения или онбординга
- UI мелкий, трудночитаемый
### 10.2 Активность (панель задач)
**Статус:** 🟢 Работает
- Показывает последние фоновые задачи
- Кнопка "Отчеты" (ведёт в /reports)
### 10.3 Настройки ( /settings ) — шестерёнка
**Статус:** 🟡 Требует доработки
- **Дублирует** часть функционала из "Админ"
- Вкладки: Окружения, Логирование, Подключения, Git, LLM, Синхронизация миграции, Хранилище, Разделы проекта, Automation
- Окружения: 1 запись (dev, https://ss-dev.bebesh.ru)
- Много overlap с админ-панелью
### 10.4 Языковой переключатель (Русский / English)
**Статус:** 🟡 Требует доработки
- Переключение между Русским и English
- **Смешанные языки:** breadcrumb "nav.dashboard", статусы "CANCELLED/FAILED/READY"
- Не все строки переведены
---
## 11. ДУБЛИРОВАНИЕ ФУНКЦИОНАЛА
| Функция | Дублируется в | Комментарий |
|---|---|---|
| Маппер колонок | Датасеты (breadcrumb) + Инструменты > Маппер колонок | Один и тот же функционал |
| Файловое хранилище | Инструменты > Файловое хранилище + Хранилище > Бэкапы | Один URL /tools/storage |
| Настройки | Шестерёнка ( /settings ) + Админ | Значительный overlap |
| Бэкапы | Инструменты > Бэкапы + Хранилище > Бэкапы | Разные URL, разный функционал |
---
## 12. НЕ РАБОТАЕТ (КРИТИЧЕСКИЕ ПРОБЛЕМЫ)
| Страница | Проблема |
|---|---|
| /datasets | Пустая страница, нет списка датасетов |
| /storage/repos | Зависает на "Загрузка..." |
| /migration/mappings | Кнопка disabled, нет данных |
| /translate/history | 0 успешных переводов из 400 записей (100% ошибок) |
| Dashboards Git | Ни один дашборд не привязан к репозиторию |
---
## 13. РЕКОМЕНДАЦИИ
### Критические (блокирующие):
1. **Починить датасеты:** /datasets пустая — вероятно, не подключен API или сломан эндпоинт
2. **Починить перевод:** 100% ошибок при переводе — проверить LLM провайдера и конфигурацию задачи "test"
3. **Починить /storage/repos:** страница зависает на "Загрузка..."
4. **Настроить Git:** ни один дашборд не имеет репозитория — без этого миграция не работает
### Важные:
5. **Устранить дублирование навигации:** решить, где должен быть "Маппер колонок", "Файловое хранилище", "Настройки"
6. **Перевод интерфейса:** "nav.dashboard" и статусы CANCELLED/FAILED/READY должны быть локализованы
7. **Отчёты:** JSON не должен отображаться сырым — нужна читаемая визуализация
8. **AI Ассистент:** добавить приветствие / тултип / онбординг при первом открытии
9. **Миграция:** добавить второе окружение для тестирования миграции (dev→dev — бессмысленно)
### Косметические:
10. **Опечатка:** "repositorys" → "repositories"
11. **Центр здоровья:** нет данных — либо скрыть, либо запустить валидацию
12. **Бэкапы:** даты создания показывают "--" — не хватает метаданных
13. **Удаление без подтверждения:** в файловом хранилище кнопка "Удалить" без confirm-диалога
---
## Полная карта навигации
```
Superset Tools
├── РЕСУРСЫ
│ ├── Дашборды
│ │ ├── Обзор (/dashboards)
│ │ └── Центр здоровья (/dashboards/health) [пусто]
│ ├── Датасеты
│ │ ├── Все датасеты (/datasets) [пусто!]
│ │ └── Review Workspace (/datasets/review)
│ └── Миграция
│ ├── Обзор (/migration) [только dev]
│ └── Маппинги (/migration/mappings) [не работает]
├── ОПЕРАЦИИ
│ ├── Git (/git) [нет репозиториев]
│ ├── Переводы
│ │ ├── Задания (/translate)
│ │ ├── Словари (/translate/dictionaries) [пусто]
│ │ └── История (/translate/history) [100% ошибок]
│ └── Отчеты (/reports) [JSON сыром]
├── СИСТЕМА
│ ├── Инструменты
│ │ ├── Маппер колонок (/tools/mapper)
│ │ ├── Диагностика (/tools/debug)
│ │ ├── Файловое хранилище (/tools/storage)
│ │ └── Бэкапы (/tools/backups)
│ ├── Хранилище
│ │ ├── Бэкапы → /tools/storage [ДУБЛЬ]
│ │ └── Репозитории (/storage/repos) [зависает]
│ └── Админ
│ ├── Пользователи (/admin/users)
│ ├── Роли (/admin/roles)
│ ├── Настройка ADFS (/admin/settings)
│ └── Провайдеры LLM (/admin/settings/llm)
└── [ХЕДЕР]
├── AI Ассистент (панель)
├── Активность (панель задач)
├── Настройки (/settings) [ДУБЛЬ с Админ]
└── Меню пользователя
```