klg-asutk-app/docs/#U0418#U041d#U0421#U0422#U0420#U0423#U041a#U0426#U0418#U042f_#U041f#U041e_#U0414#U0415#U041c#U041e#U041d#U0421#U0422#U0420#U0410#U0426#U0418#U0418.md

Инструкция по демонстрации проекта

Быстрая демонстрация (5-10 минут)

1. Запуск системы

cd klg_asutk_app
docker compose up --build

Дождитесь сообщения о готовности всех сервисов.

2. Открытие приложения

Откройте в браузере: http://localhost:8080

3. Демонстрация функций

Шаг 1: Главная страница (Дашборд)

• Покажите небесный фон с анимацией облаков
• Обратите внимание на KPI карточки:
  • Количество организаций
  • Количество воздушных судов
  • Количество заявок
  • ВС в эксплуатации / на обслуживании
  • Сертификаты с истекающим сроком
• Продемонстрируйте поиск:
  • Введите часть регистрационного номера (например, "RA-")
  • Нажмите "Найти"
  • Покажите результаты поиска
• Покажите кнопки "Загрузка данных" и "Документы"

Шаг 2: Воздушные суда

• Перейдите в раздел "Воздушные суда"
• Покажите список ВС с различными типами (самолеты и вертолеты)
• Обратите внимание на:
  • Разные статусы (в эксплуатации, на обслуживании и т.д.)
  • Налет и циклы
  • Операторов
• Нажмите "Детали" на любом ВС, чтобы показать модальное окно с полной информацией
• Покажите возможность создания нового ВС (кнопка "Добавить ВС")

Шаг 3: Организации

• Перейдите в раздел "Организации"
• Покажите список организаций разных типов:
  • Операторы (авиакомпании)
  • MRO (организации ТО)
  • Органы власти
• Продемонстрируйте создание новой организации:
  • Нажмите "Создать"
  • Заполните форму
  • Сохраните

Шаг 4: Загрузка данных

• Вернитесь на главную страницу
• Нажмите кнопку "Загрузка данных"
• Покажите модальное окно:
  • Выбор воздушного судна
  • Выбор типа файла (текст, PDF, XLS, PNG)
  • Загрузка файла
  • Таблица загруженных файлов

Шаг 5: Нормативные документы

• Нажмите кнопку "Документы" на главной странице или перейдите через меню
• Покажите документы от разных организаций:
  • ИКАО
  • МАК
  • EASA
  • Росавиация
• Обратите внимание на:
  • Статусы документов (действует, обновлен, новый)
  • Категории
  • Ссылки на официальные сайты

Шаг 6: Пользователи

• Перейдите в раздел "Пользователи"
• Покажите список пользователей с ролями
• Продемонстрируйте фильтрацию:
  • По организации
  • По роли

Шаг 7: Заявки на сертификацию

• Перейдите в раздел "Заявки"
• Покажите список заявок с различными статусами
• Обратите внимание на workflow заявок

4. Демонстрация API

Откройте в браузере: http://localhost:8000/docs

• Покажите Swagger UI
• Выполните несколько запросов:
  • GET /api/v1/organizations — список организаций
  • GET /api/v1/aircraft — список ВС
  • GET /api/v1/aircraft/types — типы ВС

---

Расширенная демонстрация (15-20 минут)

Дополнительные сценарии

Сценарий 1: Полный цикл работы с ВС

1. Создайте новое воздушное судно
2. Загрузите для него документы через "Загрузка данных"
3. Просмотрите детали ВС
4. Измените статус ВС

Сценарий 2: Работа с организациями

1. Создайте новую организацию (оператор)
2. Создайте ВС и привяжите его к этой организации
3. Покажите фильтрацию ВС по оператору

Сценарий 3: Поиск и фильтрация

1. Используйте поиск на главной странице
2. Покажите фильтрацию пользователей по организации и роли
3. Продемонстрируйте сортировку в таблицах

---

Ключевые моменты для демонстрации

Дизайн

• ✅ Небесный фон на всех страницах
• ✅ Белые карточки с тенями для читаемости
• ✅ Крупные зеленые кнопки для основных действий
• ✅ Глянцевые кнопки для дополнительных функций
• ✅ Адаптивный дизайн

Функциональность

• ✅ Управление воздушными судами (самолеты и вертолеты)
• ✅ Управление организациями
• ✅ Загрузка и управление файлами
• ✅ Поиск по ВС и организациям
• ✅ KPI на дашборде
• ✅ Нормативные документы

Технические особенности

• ✅ REST API с документацией
• ✅ Docker контейнеризация
• ✅ PostgreSQL база данных
• ✅ React + TypeScript frontend
• ✅ FastAPI backend

---

Возможные вопросы и ответы

Q: Какие данные уже есть в системе?
A: Система содержит тестовые данные:

• Несколько организаций (операторы, MRO, органы власти)
• Множество воздушных судов различных типов (самолеты и вертолеты)
• Типы воздушных судов (Boeing, Airbus, Sukhoi, Ми, Ка и др.)

Q: Можно ли добавить свои данные?
A: Да, через веб-интерфейс можно создавать новые организации, воздушные суда и загружать файлы.

Q: Как работает авторизация?
A: В режиме разработки используется упрощенная авторизация через JWT токены. В production будет использоваться OIDC через АСУ ТК-ИБ.

Q: Где хранятся загруженные файлы?
A: В текущей версии файлы хранятся локально в файловой системе. В production будет использоваться централизованное хранилище АСУ ТК.

Q: Можно ли экспортировать данные?
A: В текущей версии экспорт не реализован, но это можно добавить через API.

---

Устранение проблем

Проблема: Страница не загружается

Решение:

1. Проверьте, что все контейнеры запущены: docker compose ps
2. Проверьте логи: docker compose logs frontend
3. Перезапустите: docker compose restart frontend

Проблема: API не отвечает

Решение:

1. Проверьте логи backend: docker compose logs backend
2. Проверьте подключение к БД: docker compose logs db
3. Перезапустите: docker compose restart backend

Проблема: Данные не отображаются

Решение:

1. Проверьте, что БД инициализирована
2. Проверьте логи backend на наличие ошибок
3. Попробуйте пересоздать БД: docker compose down -v && docker compose up --build

---

Заключение

Система готова к демонстрации. Все основные функции работают, интерфейс интуитивно понятен, дизайн современный и привлекательный.

Для дополнительной информации см. файл ДЕМОНСТРАЦИЯ_ПРОЕКТА.md.