# КЛГ АСУ ТК — Руководство пользователя > Система автоматизированного управления техническим контролем > Калининградский филиал · АО «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 `. Пример: ```bash curl -H "Authorization: Bearer " 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» — Разработчик АСУ ТК КЛГ*