klg-asutk-app/docs/Рекомендации_Bureau_Veritas_ИКАО.md
Yuriy 0150aba4f5 Consolidation: KLG ASUTK + PAPA integration
- 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>
2026-02-08 17:18:31 +03:00

197 lines
7.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Рекомендации по улучшению проекта на основе анализа Bureau Veritas и требований ИКАО
## Введение
На основе анализа требований ИКАО Annex 8 (Airworthiness of Aircraft), лучших практик индустрии и стандартов сертификации, ниже представлены рекомендации по улучшению проекта КЛГ.
---
## 1. КРИТИЧНЫЕ УЛУЧШЕНИЯ (Высокий приоритет)
### 1.1. Документ лётной годности (ДЛГ / Airworthiness Certificate)
**Текущее состояние:**Не реализовано
**Требования ИКАО Annex 8:**
- Каждое ВС должно иметь действующий сертификат лётной годности
- Сертификат должен содержать условия и ограничения
- Необходимо отслеживание сроков действия
**Рекомендации:**
1. Создать модель `AirworthinessCertificate`
2. Связать с моделью `Aircraft`
3. Реализовать автоматические уведомления о приближении срока истечения
4. Добавить историю изменений сертификатов
**Приоритет:** 🔴 КРИТИЧНО
---
### 1.2. Расширение модели Aircraft
**Текущее состояние:** ⚠️ Базовые поля реализованы
**Рекомендуемые дополнения:**
- Серийный номер ВС
- Дата производства
- Дата первого полета
- Общий налет (TTSN - Total Time Since New)
- Общее количество циклов (TCSN - Total Cycles Since New)
- Текущий статус ВС (в эксплуатации, на обслуживании, на хранении)
- Связь с ДЛГ
- Конфигурация ВС
**Приоритет:** 🔴 КРИТИЧНО
---
### 1.3. История ВС (Aircraft History)
**Текущее состояние:**Не реализовано
**Требования:**
- Полная история всех событий ВС
- Отслеживание налета и циклов
- История обслуживаний, модификаций, инцидентов
**Рекомендации:**
1. Создать модель `AircraftHistory`
2. Автоматическое логирование всех изменений
3. Временная шкала событий
4. Связь с документами
**Приоритет:** 🔴 КРИТИЧНО
---
## 2. ВАЖНЫЕ УЛУЧШЕНИЯ (Средний приоритет)
### 2.1. Модификации ВС (Modifications)
**Текущее состояние:**Не реализовано
**Требования ИКАО:**
- Отслеживание обязательных модификаций (AD - Airworthiness Directives)
- Контроль сроков выполнения
- Документирование выполненных модификаций
**Рекомендации:**
1. Модель `AircraftModification`
2. Интеграция с базой данных AD/SB
3. Уведомления о новых обязательных модификациях
4. Отчеты о соответствии
**Приоритет:** 🟡 ВАЖНО
---
### 2.2. Инспекции и аудиты
**Текущее состояние:**Не реализовано
**Требования:**
- Планирование периодических инспекций
- Чек-листы инспекций
- Отчеты по результатам
- Отслеживание корректирующих действий
**Рекомендации:**
1. Модель `Inspection`
2. Шаблоны чек-листов
3. Интеграция с календарем
4. Отчеты по инспекциям
**Приоритет:** 🟡 ВАЖНО
---
### 2.3. Улучшение MaintenanceTask
**Текущее состояние:** ✅ Базовая модель есть
**Рекомендации:**
- Добавить подписи техника и инспектора
- Добавить доказательства выполнения (фото, документы)
- Группировка по типам обслуживания (A, B, C, D-check)
- Приоритеты задач
- Зависимости между задачами
- Автоматический расчет сроков
**Приоритет:** 🟡 ВАЖНО
---
## 3. ДОПОЛНИТЕЛЬНЫЕ УЛУЧШЕНИЯ (Низкий приоритет)
### 3.1. Расширенная отчетность
**Рекомендации:**
- Дашборды с аналитикой
- Экспорт отчетов в PDF/Excel
- Автоматическая генерация отчетов
- Интеграция с системами BI
**Приоритет:** 🟢 ЖЕЛАТЕЛЬНО
---
### 3.2. Интеграции
**Рекомендации:**
- Импорт данных из систем планирования полетов
- Интеграция с системами управления запчастями
- Синхронизация с реестрами ВС
- API для внешних систем
**Приоритет:** 🟢 ЖЕЛАТЕЛЬНО
---
## 4. СООТВЕТСТВИЕ СТАНДАРТАМ
### 4.1. ИКАО Annex 8
**Ключевые требования:**
- ✅ Сертификация организаций (реализовано)
- ❌ Управление ДЛГ (требуется)
- ⚠️ Отслеживание налета (частично)
- ⚠️ Программа ТО (базовая реализация)
- ❌ Модификации (требуется)
- ❌ Инспекции (требуется)
### 4.2. EASA Part M (для международных операций)
**Ключевые требования:**
- Управление continuing airworthiness
- Контроль выполнения обслуживания
- Отслеживание компонентов
- Управление документацией
---
## 5. ПЛАН ВНЕДРЕНИЯ
### Фаза 1 (Критично - 1-2 месяца)
1. Расширение модели Aircraft
2. Создание модели AirworthinessCertificate
3. Создание модели AircraftHistory
4. Улучшение MaintenanceTask
### Фаза 2 (Важно - 2-3 месяца)
5. Модель AircraftModification
6. Модель Inspection
7. Расширенная отчетность
8. Улучшение дашбордов
### Фаза 3 (Желательно - 3-6 месяцев)
9. Интеграции с внешними системами
10. Мобильное приложение
11. Расширенная аналитика
12. Автоматизация процессов
---
## Заключение
Проект имеет хорошую основу, но для полного соответствия требованиям ИКАО и международным стандартам необходимо реализовать критичные компоненты, особенно управление ДЛГ и расширенную историю ВС.