- Unify API: lib/api.ts uses /api/v1, inbox uses /api/inbox (rewrites) - Remove localhost refs: openapi, inbox page - Add rewrites: /api/inbox|tmc -> inbox-server, /api/v1 -> FastAPI - Add stub routes: knowledge/insights, recommendations, search, log-error - Transfer from PAPA: prompts (inspection, tmc), scripts, supabase, data/tmc-requests - Fix inbox-server: ORDER BY created_at, package.json - Remove redundant app/api/inbox/files route (rewrites handle it) - knowledge/ in gitignore (large PDFs) Co-authored-by: Cursor <cursoragent@cursor.com>
223 lines
8.6 KiB
Markdown
223 lines
8.6 KiB
Markdown
# Улучшения визуального оформления системы КЛГ
|
||
|
||
## Анализ лучших практик авиационных систем
|
||
|
||
На основе анализа программ для поддержания лётной годности (ICAO, EASA, ModernHawk и др.) были внедрены следующие улучшения:
|
||
|
||
---
|
||
|
||
## 1. Цветовая система статусов (ICAO/EASA стандарты)
|
||
|
||
### Статусы воздушных судов:
|
||
- **В эксплуатации** (in_service) - Зеленый (#10B981)
|
||
- **На обслуживании** (maintenance) - Оранжевый (#F59E0B)
|
||
- **На хранении** (storage) - Синий (#6366F1)
|
||
- **Списан** (retired) - Красный (#EF4444)
|
||
|
||
### Статусы сертификатов:
|
||
- **Действителен** (valid) - Зеленый
|
||
- **Предупреждение** (warning) - Оранжевый (истекает в ближайшие 30 дней)
|
||
- **Истек** (expired) - Красный
|
||
- **Ожидает** (pending) - Синий
|
||
|
||
---
|
||
|
||
## 2. Улучшенные компоненты интерфейса
|
||
|
||
### Карточки метрик
|
||
- Градиентные фоны для визуального разделения
|
||
- Hover-эффекты для интерактивности
|
||
- Дополнительная информация (например, "X в эксплуатации")
|
||
- Иконки с бейджами для уведомлений
|
||
|
||
### Индикаторы прогресса
|
||
- Круговые индикаторы для статуса флота
|
||
- Процентное отображение соответствия требованиям
|
||
- Цветовое кодирование для быстрого понимания
|
||
|
||
### Улучшенные таблицы
|
||
- Четкое разделение заголовков и данных
|
||
- Hover-эффекты для строк
|
||
- Улучшенные отступы и типографика
|
||
- Статус-бейджи с индикаторами
|
||
|
||
### Уведомления и алерты
|
||
- Цветовое кодирование по типу (info, warning, error, success)
|
||
- Иконки для быстрого распознавания
|
||
- Возможность закрытия
|
||
- Кнопки действий
|
||
|
||
---
|
||
|
||
## 3. Информационная архитектура
|
||
|
||
### Дашборд
|
||
- **7 карточек метрик** вместо 5:
|
||
- Организации
|
||
- Воздушные суда (с дополнительной информацией)
|
||
- Заявки
|
||
- Одобрено
|
||
- Пользователи
|
||
- На обслуживании (НОВАЯ)
|
||
- Сертификаты истекают (НОВАЯ)
|
||
|
||
- **Панель статуса флота**:
|
||
- Круговые индикаторы для визуализации
|
||
- Процентное отображение
|
||
- Разделение по категориям
|
||
|
||
- **Умные уведомления**:
|
||
- Автоматическое отображение предупреждений
|
||
- Информация о ВС на обслуживании
|
||
- Уведомления об истекающих сертификатах
|
||
|
||
---
|
||
|
||
## 4. Визуальные улучшения
|
||
|
||
### Типографика
|
||
- Использование шрифта Unbounded для заголовков
|
||
- Montserrat для основного текста
|
||
- Улучшенные размеры и веса шрифтов
|
||
- Правильные отступы и межстрочные интервалы
|
||
|
||
### Тени и глубина
|
||
- Многоуровневая система теней
|
||
- Hover-эффекты с поднятием элементов
|
||
- Четкое разделение слоев интерфейса
|
||
|
||
### Скругления
|
||
- Единая система радиусов (6px, 8px, 12px, 16px)
|
||
- Современный внешний вид
|
||
- Улучшенная читаемость
|
||
|
||
### Анимации
|
||
- Плавные переходы (150ms, 250ms, 350ms)
|
||
- Hover-эффекты
|
||
- Анимации появления элементов
|
||
|
||
---
|
||
|
||
## 5. Улучшенные статус-бейджи
|
||
|
||
### Визуальные индикаторы
|
||
- Цветные точки перед текстом
|
||
- Фоновое выделение
|
||
- Границы для контраста
|
||
- Улучшенная читаемость
|
||
|
||
### Классы статусов
|
||
- `.status-badge-valid` - для действительных статусов
|
||
- `.status-badge-warning` - для предупреждений
|
||
- `.status-badge-expired` - для истекших/просроченных
|
||
- `.status-badge-pending` - для ожидающих
|
||
- `.status-badge-maintenance` - для обслуживания
|
||
|
||
---
|
||
|
||
## 6. Адаптивность
|
||
|
||
### Мобильная версия
|
||
- Адаптивные карточки
|
||
- Уменьшенные размеры шрифтов
|
||
- Оптимизированные отступы
|
||
- Улучшенная навигация
|
||
|
||
---
|
||
|
||
## 7. Соответствие стандартам
|
||
|
||
### ICAO Annex 8
|
||
- Цветовое кодирование статусов
|
||
- Четкое отображение информации о сертификатах
|
||
- Визуализация соответствия требованиям
|
||
|
||
### EASA Part M
|
||
- Отображение статусов обслуживания
|
||
- Индикаторы сроков действия документов
|
||
- Уведомления о предстоящих событиях
|
||
|
||
### Лучшие практики UI/UX
|
||
- Минимализм в визуализациях
|
||
- Четкая информационная иерархия
|
||
- Интерактивность и обратная связь
|
||
- Доступность и читаемость
|
||
|
||
---
|
||
|
||
## 8. Новые функции визуализации
|
||
|
||
### Круговые индикаторы прогресса
|
||
- Статус флота (в эксплуатации / на обслуживании)
|
||
- Соответствие требованиям
|
||
- Процентное отображение
|
||
|
||
### Умные уведомления
|
||
- Автоматическое определение критических ситуаций
|
||
- Контекстные действия
|
||
- Приоритизация информации
|
||
|
||
### Расширенные карточки
|
||
- Дополнительная информация в карточках
|
||
- Иконки с бейджами
|
||
- Визуальные индикаторы
|
||
|
||
---
|
||
|
||
## 9. Файлы изменений
|
||
|
||
### Новые файлы:
|
||
- `frontend/src/assets/theme.css` - Расширенная тема с улучшениями
|
||
|
||
### Обновленные файлы:
|
||
- `frontend/src/pages/Dashboard.tsx` - Улучшенный дашборд
|
||
- `frontend/src/pages/Aircraft.tsx` - Улучшенные статус-бейджи
|
||
- `frontend/src/main.tsx` - Подключение новой темы
|
||
|
||
---
|
||
|
||
## 10. Результаты улучшений
|
||
|
||
### Визуальное качество
|
||
- ✅ Современный и профессиональный внешний вид
|
||
- ✅ Соответствие стандартам авиационной индустрии
|
||
- ✅ Улучшенная читаемость и навигация
|
||
|
||
### Функциональность
|
||
- ✅ Больше информации на дашборде
|
||
- ✅ Умные уведомления
|
||
- ✅ Визуализация статусов
|
||
|
||
### Пользовательский опыт
|
||
- ✅ Интуитивная навигация
|
||
- ✅ Быстрое понимание статусов
|
||
- ✅ Улучшенная обратная связь
|
||
|
||
---
|
||
|
||
## Следующие шаги для дальнейшего улучшения
|
||
|
||
1. **Графики и диаграммы**:
|
||
- Временные графики истории обслуживания
|
||
- Диаграммы распределения статусов
|
||
- Тренды соответствия требованиям
|
||
|
||
2. **Расширенные фильтры**:
|
||
- Фильтры по датам
|
||
- Фильтры по операторам
|
||
- Сохранение фильтров
|
||
|
||
3. **Экспорт данных**:
|
||
- Экспорт в PDF
|
||
- Экспорт в Excel
|
||
- Печать отчетов
|
||
|
||
4. **Темная тема**:
|
||
- Переключение между светлой и темной темой
|
||
- Сохранение предпочтений пользователя
|
||
|
||
5. **Персонализация**:
|
||
- Настройка дашборда
|
||
- Избранные метрики
|
||
- Пользовательские виджеты
|