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