papa/klg-asutk-app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
a30bf929dc
klg-asutk-app/docs/USER_GUIDE.md

16 KiB
Raw Blame History

КЛГ АСУ ТК — Руководство пользователя

Система автоматизированного управления техническим контролем
Калининградский филиал · АО «REFLY»
Версия 2.1.0

1. Введение

КЛГ АСУ ТК — веб-приложение для контроля лётной годности воздушных судов, сертификации эксплуатантов и организаций ТОиР, управления рисками и ведения нормативной базы.

Система разработана в соответствии с требованиями Воздушного кодекса РФ, ФАП-145, ФАП-147, ФАП-148, ФАП-246, стандартов ICAO и EASA.

Для кого предназначена система

Роль Описание
Администратор Полный доступ ко всем модулям и данным всех организаций
Инспектор ФАВТ Рассмотрение заявок, инспекции, аудиты, панель регулятора
Руководитель эксплуатанта Управление парком ВС, подача заявок на сертификацию
Специалист эксплуатанта Просмотр данных, создание заявок
Руководитель ТОиР Наряды на ТО, чек-листы, управление дефектами
Специалист ТОиР Выполнение задач ТО, заполнение чек-листов

2. Вход в систему

Как войти в систему

  1. Откройте браузер (Chrome, Firefox, Safari или Edge) и перейдите по адресу системы:
    • Demo: https://demo.klg.refly.ru или выданный вам URL
    • Локально: http://localhost:3000
  2. Откроется страница входа (если вы ещё не авторизованы). Адрес страницы: .../login.
  3. Введите токен доступа в поле «Токен доступа»:
    • В demo-режиме токен вы получаете от администратора или берёте из файла demo/tokens.json (скопируйте строку token для нужного пользователя).
    • Поле можно вставить из буфера обмена (Ctrl+V / Cmd+V).
  4. Нажмите кнопку «Войти».
  5. При успешной авторизации вы будете перенаправлены на главную страницу (Dashboard). В правом верхнем углу отобразится ваше имя или роль.

Если токен неверный или истёк, появится сообщение: «Неверный токен или сервер недоступен». Проверьте токен или запросите новый.

Режимы авторизации

Режим Как войти
Demo (токены) На странице входа вставьте JWT-токен из demo/tokens.json в поле «Токен доступа» и нажмите «Войти».
Production (Keycloak) Перейдите по адресу системы — вас перенаправит на страницу Keycloak. Введите логин и пароль, выданные администратором. После входа вы вернётесь в КЛГ АСУ ТК.

Выход из системы

Нажмите на своё имя в правом верхнем углу → Выйти. Токен будет удалён из памяти, потребуется повторный вход.

3. Главная страница (Dashboard)

После входа отображается сводная панель:

  • Статистика: количество ВС, активных заявок, открытых рисков, предстоящих инспекций
  • Последние уведомления: новые заявки, замечания, приближающиеся сроки
  • Быстрые действия: кнопки перехода к основным модулям

4. Парк воздушных судов

4.1 Просмотр списка ВС

Перейдите в раздел Воздушные суда в боковом меню.

Отображается таблица со столбцами:

  • Регистрационный номер (например, RA-89001)
  • Тип ВС (SSJ100, МС-21, L-410)
  • Оператор (название организации)
  • Статус (active / maintenance / grounded / storage)
  • Год выпуска

Используйте поиск и фильтры для нахождения нужного ВС.

4.2 Карточка ВС

Нажмите на регистрационный номер для просмотра подробной информации:

  • Основные данные: серийный номер, тип, оператор, год выпуска
  • Наработка: часы налёта, циклы
  • Сертификаты лётной годности: действующие и истёкшие
  • Директивы ЛГ (AD): применённые и открытые
  • Модификации: выполненные SB и AD
  • История обслуживания: наряды на ТО

4.3 Добавление ВС (оператор/администратор)

  1. Нажмите кнопку + Добавить ВС
  2. Заполните обязательные поля: регистрационный номер, тип ВС
  3. Укажите оператора (вашу организацию)
  4. Нажмите Сохранить

5. Заявки на сертификацию

5.1 Создание заявки

  1. Перейдите в раздел Сертификация
  2. Нажмите + Новая заявка
  3. Заполните:
    • Тема — краткое описание (например, «Продление СЭ»)
    • Описание — подробности, scope, перечень ВС
  4. Нажмите Сохранить — заявка создаётся в статусе Черновик

5.2 Подача заявки

В карточке заявки нажмите Подать заявку. Статус изменится на Подана. Инспектор ФАВТ получит уведомление.

5.3 Рассмотрение (инспектор)

  1. Инспектор открывает заявку и нажимает Начать рассмотрение → статус На рассмотрении
  2. При наличии замечаний — нажмите Добавить замечание, введите текст
    • Заявителю автоматически устанавливается срок 30 дней на устранение
    • Статус меняется на Замечания
  3. После устранения заявитель повторно подаёт заявку
  4. Инспектор принимает решение:
    • Одобрить → статус Одобрена
    • Отклонить → статус Отклонена

5.4 Жизненный цикл заявки

Черновик → Подана → На рассмотрении → Одобрена
                                     → Замечания → Подана (повторно)
                                     → Отклонена

6. Наряды на техническое обслуживание (Work Orders)

6.1 Создание наряда

  1. Перейдите в Наряды на ТО
  2. Нажмите + Новый наряд
  3. Выберите:
    • ВС (из списка)
    • Тип: плановый / внеплановый / AOG (Aircraft on Ground)
    • Приоритет: обычный / высокий / критический
    • Описание работ
  4. Нажмите Создать

6.2 Выполнение наряда

  1. Назначенный специалист открывает наряд
  2. Выполняет работы согласно описанию и чек-листу
  3. После завершения — подписывает CRS (Certificate of Release to Service):
    • Нажмите Закрыть с CRS
    • Укажите данные подписанта

6.3 Статусы нарядов

Статус Описание
open Создан, ожидает выполнения
in_progress В работе
completed Выполнен, CRS подписан
cancelled Отменён

7. Дефекты

7.1 Регистрация дефекта

  1. Перейдите в Дефекты
  2. Нажмите + Зарегистрировать дефект
  3. Укажите:
    • ВС
    • Глава ATA (по классификации)
    • Описание дефекта
    • Критичность: критический / значительный / незначительный
  4. Для критических дефектов автоматически создаётся risk alert

7.2 MEL Deferral

Если дефект допускает отложенное устранение по MEL (Minimum Equipment List):

  1. Откройте карточку дефекта
  2. Нажмите Отложить по MEL
  3. Укажите категорию MEL (A/B/C/D) и срок

8. Чек-листы и аудиты

8.1 Шаблоны чек-листов

В разделе Чек-листы доступны шаблоны по стандартам:

  • ФАП-М (поддержание лётной годности)
  • ATA chapters
  • CSV (загрузка собственных)

8.2 Проведение аудита

  1. Перейдите в Аудиты → + Новый аудит
  2. Выберите тип, ВС или организацию, шаблон чек-листа
  3. Заполняйте пункты: ✅ Соответствует / ❌ Не соответствует / ⚠️ Замечание
  4. При завершении нажмите Закрыть аудит
  5. Результаты сохраняются в журнале

9. Управление рисками

9.1 Панель рисков

Раздел Риски отображает:

  • Автоматически обнаруженные risk alerts (истекающие ресурсы, просроченные квалификации, новые обязательные AD)
  • Ручные записи от инспекторов

9.2 Обработка риска

  1. Откройте карточку риска
  2. Проанализируйте описание и связанные сущности
  3. Выполните корректирующие действия
  4. Нажмите Закрыть риск с описанием принятых мер

10. Нормативная база

Раздел Нормативная база содержит 19 базовых документов:

  • Воздушный кодекс РФ (60-ФЗ)
  • ФАП-10/246, ФАП-21, ФАП-128, ФАП-145, ФАП-147, ФАП-148, ФАП-149
  • ICAO Annex 1, 6, 7, 8, 19
  • EASA Part-21, Part-66, Part-M, Part-145
  • ФЗ-152, ФЗ-149

Для каждого документа доступны: текст, перекрёстные ссылки, комментарии, судебная практика.

11. Уведомления

Система уведомляет в реальном времени (WebSocket) о:

  • Новых заявках и изменении статуса
  • Замечаниях с дедлайнами
  • Приближающихся инспекциях
  • Критических рисках
  • Новых обязательных директивах ЛГ

Уведомления отображаются в виде значка 🔔 в шапке. Нажмите для просмотра списка. Кнопка Прочитать все отмечает все как прочитанные.

12. Панель ФАВТ (только для инспекторов)

Инспекторы ФАВТ имеют доступ к read-only панели со сводной информацией:

  • Все организации и их парки ВС
  • Все заявки на сертификацию (по всем организациям)
  • Результаты аудитов
  • Статистика рисков

Эта панель соответствует требованиям ВК РФ ст. 8.

13. Импорт и экспорт данных

Импорт

  • CSV/XLSX: загрузка данных о ВС, компонентах, персонале
  • PDF/DOCX: входящие документы (через раздел «Входящие»)
  • ZIP: массовый импорт

Экспорт

  • Таблицы можно экспортировать в CSV/XLSX
  • Заявки — в PDF
  • Аудиты — в PDF с результатами

14. API (для разработчиков)

Полная документация API доступна по адресам:

  • Swagger UI: /docs
  • ReDoc: /redoc
  • OpenAPI JSON: /openapi.json

Все запросы требуют заголовок Authorization: Bearer <TOKEN>.

Пример:

curl -H "Authorization: Bearer <TOKEN>" https://demo.klg.refly.ru/api/v1/aircraft

15. Частые вопросы

В: Как получить токен для входа?
О: В demo-режиме токены генерируются командой python demo/generate_tokens.py. В production токены выдаёт Keycloak после аутентификации.

В: Почему я не вижу ВС других организаций?
О: Система использует мультитенантность (RLS). Каждый пользователь видит только данные своей организации. Администратор и инспектор ФАВТ видят данные всех организаций.

В: Как изменить свою роль?
О: Роли назначаются администратором. Обратитесь к администратору системы.

В: Что делать при ошибке 401 (Unauthorized)?
О: Срок действия токена истёк. Получите новый токен и войдите заново.

В: Поддерживаются ли мобильные устройства?
О: Да, интерфейс адаптивный (responsive). Рекомендуется использовать на экранах шириной от 768px.

16. Техническая поддержка

При возникновении проблем:

  1. Проверьте раздел «Частые вопросы» выше
  2. Проверьте статус системы: /api/v1/health
  3. Свяжитесь с администратором системы
  4. Для разработчиков: логи доступны через docker compose logs -f

© АО «REFLY» — Разработчик АСУ ТК КЛГ