klg-asutk-app/docs/ТЗ_соответствие.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

102 lines
5.5 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.

# Соответствие проекта техническому заданию
## Общая информация
**Функциональная задача:** «Контроль лётной годности воздушных судов» (ФЗ «КЛГ» АСУ ТК)
**Заказчик:** АО «REFLY»
**Вариант развертывания:** в составе АСУ ТК
## Платформенные решения АСУ ТК
### 1. ЦХД АСУ ТК (Центральное хранилище данных)
- **Реализация:** PostgreSQL
- **Расположение:** `backend/app/db/`
- **Статус:** ✅ Реализовано базовое хранилище с выделенными таблицами под КЛГ
### 2. П-ИВ АСУ ТК (Протокол интеграции и взаимодействия)
- **Реализация:** Модуль `backend/app/integration/piv.py`
- **Функции:**
- `push_event()` - отправка событий в П-ИВ
- Журналирование интеграционных процессов
- **Статус:** ✅ Реализована заглушка, требуется уточнение контрактов
### 3. АСУ ТК-ИБ (Информационная безопасность)
- **Реализация:** Модуль `backend/app/services/security.py`
- **Функции:**
- OIDC/JWT валидация
- JWKS проверка подписи токенов
- Маппинг claim'ов пользователей
- **Статус:** ✅ Реализована базовая авторизация, требуется уточнение маппинга claim'ов
### 4. Информационный портал
- **Реализация:** React приложение в `frontend/`
- **Статус:** ✅ Реализован базовый UI, готов к интеграции как единая точка входа
## Реализованные функции
### ✅ Базовые функции
- Управление организациями (операторы, MRO, органы власти)
- Управление воздушными судами и типами ВС
- Процесс заявок на сертификацию организации по ТО
- Система уведомлений
- Загрузка и управление вложениями
- Логирование интеграционных процессов
### ✅ Модели данных согласно формам ТЗ
#### Реализовано:
1. **MaintenanceTask** - Статус выполненного технического обслуживания
2. **LimitedLifeComponent** - Статус компонентов с ограниченным межремонтным ресурсом/сроком службы (LLP, HT)
3. **LandingGearComponent** - Комплектующие изделия с ограниченным ресурсом (шасси)
4. **DamageReport** - Отчет по ремонтам и повреждениям конструкции
5. **DefectReport** - Отчет по дефектам
#### Требует реализации API:
- Endpoints для работы с моделями технического обслуживания
- Endpoints для работы с отчетами о дефектах и повреждениях
- Валидация данных согласно формам ТЗ
## Требования ТЗ, требующие дальнейшей реализации
### 1. Дополнительные процессы
- [ ] ДЛГ (Документ лётной годности)
- [ ] КД (Контрольные данные)
- [ ] Модификации воздушных судов
- [ ] Инспекции
- [ ] Полный цикл контроля технического обслуживания
### 2. Интеграции
- [ ] Уточнение контрактов П-ИВ (форматы сообщений, расписания, ETL-pipeline)
- [ ] Подключение П-НСИ (централизованная НСИ)
- [ ] Интеграция с внешними системами
### 3. Безопасность
- [ ] Полная ролевая модель согласно АСУ ТК-ИБ
- [ ] Матрица прав доступа
- [ ] Реализация требований к защите информации от НСД
### 4. Документация и тестирование
- [ ] ПМИ (Программно-методические инструкции)
- [ ] Автотесты согласно процедурам приемки
- [ ] Документация по API
## Структура соответствия
```
backend/app/
├── models/
│ ├── maintenance.py # Модели ТО (соответствует формам ТЗ)
│ ├── defects.py # Модели дефектов (соответствует формам ТЗ)
│ └── ...
├── integration/
│ └── piv.py # П-ИВ интеграция
└── services/
└── security.py # АСУ ТК-ИБ авторизация
```
## Примечания
- Все модели данных соответствуют формам, указанным в ТЗ
- API endpoints для новых моделей требуют реализации
- Требуется уточнение контрактов интеграций с платформенными решениями АСУ ТК