- 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>
197 lines
7.4 KiB
Markdown
197 lines
7.4 KiB
Markdown
# Рекомендации по улучшению проекта на основе анализа 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. Автоматизация процессов
|
||
|
||
---
|
||
|
||
## Заключение
|
||
|
||
Проект имеет хорошую основу, но для полного соответствия требованиям ИКАО и международным стандартам необходимо реализовать критичные компоненты, особенно управление ДЛГ и расширенную историю ВС.
|