# Changelog — КЛГ АСУ ТК

## v27 (2026-02-13) — ФГИС РЭВС Integration
### Added
- **Интеграция с ФГИС РЭВС** — полная реализация:
  - **Сервис** (629 lines): REST API + СМЭВ 3.0 (SOAP) клиент
    - Модели данных: FGISAircraft, FGISCertificate, FGISOperator, FGISDirective, FGISMaintOrg
    - ГОСТ Р 34.10-2012 (УКЭП) для юридически значимого обмена
    - Mock-данные для тестовой среды (4 ВС, 3 СЛГ, 2 ДЛГ, 1 эксплуатант)
  - **API routes** (313 lines, 15 endpoints):
    - PULL: `/fgis-revs/aircraft`, `/certificates`, `/operators`, `/directives`, `/maintenance-organizations`
    - PUSH: `/push/compliance`, `/push/maintenance`, `/push/defect`
    - SYNC: `/sync/aircraft`, `/sync/certificates`, `/sync/directives`, `/sync/all`
    - STATUS: `/status`, `/config`, `/sync-log`
  - **Frontend** (323 lines, 7 вкладок):
    - Статус подключения (mock/connected/error)
    - Реестр ВС, СЛГ, Директивы ЛГ, Эксплуатанты — DataTable с фильтрами
    - Ручная синхронизация + push compliance/maintenance/defect
    - Журнал синхронизаций
  - **Scheduler**: авто-синхронизация каждые 24ч
    - Pull ВС → Pull СЛГ → Pull ДЛГ
    - Новые mandatory AD → автоматические risk alerts
    - Expired СЛГ → предупреждения
  - **16 тестов**: pull (6), push (3), sync (4), status (3)

### Правовые основания
- ВК РФ ст. 33 (реестр ВС), ст. 36 (СЛГ), ст. 37.2 (поддержание ЛГ)
- Приказ Минтранса № 98 от 02.07.2007
- Приказ Росавиации № 180-П от 09.03.2017
- ФАП-148 п.4.3 (уведомление о выполнении ДЛГ)
- ФАП-145 п.A.55 (документация ТО)
- ФАП-128 (обязательные донесения)

## v26 (2026-02-13) — Final Polish
### Added
- **⌨️ Keyboard shortcuts**: Ctrl+K (search), g→d/a/m/p/c/f/s (navigation), ? (help)
  - ShortcutsHelp overlay с полным списком
- **DataTable v2**: сортировка по столбцам + клиентская пагинация (20 записей/стр)
- **🔔 Notification bell**: real-time WS счётчик, dropdown с последними событиями
- **📍 Breadcrumbs**: автоматическая навигационная цепочка на всех страницах
- **📱 Responsive sidebar**: mobile hamburger toggle (lg: breakpoint)
- **🩺 Health dashboard**: `/health/detailed` — БД, Redis, диск, память, данные
- **Frontend validation**: validate() + RULES для aircraft_reg, P/N, S/N, табельных №
### Metrics
- Полный список горячих клавиш (10 shortcuts)
- DataTable с сортировкой + пагинацией на ВСЕХ таблицах

## v25 (2026-02-13) — Tests, UX, Documentation
### Added
- **15 новых backend тестов** для всех v22-v24 endpoints:
  - test_import_export (3): XLSX export 6 типов + validation
  - test_global_search (4): пустой поиск, min length, поиск AD, поиск персонала
  - test_notification_prefs (2): defaults + update
  - test_wo_integration (6): WO from AD/defect/SB, batch from MP, PDF
- **4 новых E2E теста**: calendar, settings, defects, maintenance
- **👤 Профиль пользователя** — аватар, роль, ID, быстрые ссылки
- **📚 Справка** — вся нормативная база (19 документов) с поиском
  - 4 категории: РФ законодательство, ФАП, ICAO, EASA
- **🌙 Тёмная тема** — toggle в настройках
- **📝 Audit History** — фильтры по типу объекта и действию
### Metrics
- Backend: 130+ BE tests | 20 E2E
- Pages: 34 | Components: 50+
- Endpoints: 160+

## v24 (2026-02-13) — Medium Priority Improvements
### Added
- **📅 Календарь ТО** — визуализация плановых WO, дедлайнов AD, сроков ПК, ресурсов
  - Месячная сетка с цветовой кодировкой типов событий
  - Навигация по месяцам, подсветка текущего дня
- **📊 Import/Export Excel (XLSX)** — массовая загрузка и выгрузка:
  - Экспорт: components, directives, bulletins, specialists, defects, work_orders
  - Импорт: components, specialists, directives (с валидацией)
- **📐 Batch WO из программы ТО** — `POST /work-orders/batch-from-program/{id}`
  - Автоматическое создание нарядов для каждой задачи MP
- **🖨️ Печатная форма CRS** — `/print/crs?wo_id=...` с auto-print
  - Двуязычная (ru/en), ФАП-145 п.A.50 / EASA Part-145.A.50
- **⚙️ Настройки уведомлений** — 9 типов событий × 3 канала (email/push/WS)
  - Toggle-интерфейс, сохранение на бэкенде
- **PWA v2** — улучшенный service worker:
  - Network-first для API (с offline-кешем)
  - Cache-first для статики
  - Offline fallback для всех страниц

## v23 (2026-02-13) — Production Hardening
### Critical Fixes
- **ORM модели**: 10 SQLAlchemy классов для всех новых таблиц (258 lines)
  - PLGSpecialist, PLGAttestation, PLGQualification
  - ADDirective, ServiceBulletin, LifeLimit, MaintenanceProgram, AircraftComponent
  - WorkOrder
- **Global auth**: Depends(get_current_user) на всех 26 роутерах
- **Loading states**: 7 страниц получили индикаторы загрузки

### Added
- **WebSocket notifications** для критических событий:
  - Новая обязательная ДЛГ, критический дефект, AOG наряд, CRS закрытие
  - ConnectionManager с room support (128 lines)
- **Вложения к нарядам/дефектам**: AttachmentUpload компонент
- **Глобальный поиск**: /search/global — ВС, компоненты, AD, SB, WO, дефекты, персонал
  - SearchBar в Sidebar с debounce + dropdown результатов
- **PDF отчёт по WO**: /work-orders/{id}/report/pdf с блоком CRS
- **Dashboard графики**: тренды WO (bar chart), распределение дефектов (progress bars)

## v22 (2026-02-13) — Cross-Module Integration
### Added
- **Сквозная интеграция модулей:**
  - AD → WO (auto-create work order from directive)
  - SB → WO (auto-create from bulletin)
  - Defect → WO (auto-create from defect)
  - All with correct priority mapping (mandatory AD → urgent WO, critical defect → AOG)
- **Dashboard** — добавлены секции WO stats + открытые дефекты + AOG
- **Панель ФАВТ** — endpoint `/regulator/maintenance-summary` (агрегированные данные ТО)
- **Airworthiness** page → навигационный хаб (4 модуля)
- README полностью обновлён с архитектурой v22
### Changed
- Work Orders: 7 → 10 endpoints (+3 интеграционных)
- Regulator: 8 → 9 endpoints

## v21 (2026-02-13) — Work Orders + Refactoring
### Added
- **Наряды на ТО (Work Orders)** — полный lifecycle: draft → in_progress → closed (CRS)
  - 7 endpoints: CRUD + open/close/cancel + stats
  - CRS workflow (Certificate of Release to Service) — ФАП-145 п.A.50
  - Связь с AD, SB, дефектами
  - AOG priority tracking
- DB миграция `007_defects_workorders.sql` (2 таблицы + индексы + RLS)
- 8 новых тестов (5 WO + 3 Defects)
### Changed
- **Dashboard** — интеграция AD, Life Limits, персонала, WO stats
- **5 legacy страниц** переведены на ui/ компоненты (risks, applications, audit-history, inbox, modifications)
- **Дефекты** — frontend с формой регистрации, фильтрами, MEL deferral
### Fixed
- Все страницы теперь используют единую UI библиотеку

## v20 (2026-02-13) — Dashboard Integration + Defects + Alerts
### Added
- **Dashboard переработан** — интеграция AD, Life Limits, персонала ПЛГ, рисков
  - Критические баннеры (открытые ДЛГ, ресурсы, просрочки ПК)
  - 4 секции: Парк ВС, Контроль ЛГ, Персонал ПЛГ, Безопасность
  - Quick links на все модули
- **Дефекты и неисправности** (backend + frontend)
  - 5 endpoints: CRUD + rectify + defer (MEL/CDL)
  - ФАП-145 п.145.A.50; EASA Part-M.A.403
  - Фильтры по статусу, борту, серьёзности
- **Email alert templates** для критических событий
  - Новая обязательная ДЛГ, критический ресурс, просрочка ПК, критический дефект

## v19 (2026-02-13) — Ядро системы ПЛГ (Airworthiness Core)
### Added
- **5 подсистем контроля лётной годности:**
  - Директивы ЛГ (AD/ДЛГ) — регистрация, трекинг выполнения, repetitive ADs
  - Сервисные бюллетени (SB) — категоризация, трудоёмкость, связь с AD
  - Ресурсы и сроки службы (Life Limits) — часы/циклы/календарь, автоматический остаток
  - Программы ТО (Maintenance Programs) — задачи с интервалами, ревизии
  - Карточки компонентов — P/N, S/N, перемещение между ВС, сертификаты
- **18 API endpoints** с audit logging
- **DB миграция** `006_airworthiness_core.sql` (5 таблиц + RLS + индексы)
- **Статус ЛГ конкретного ВС** (`/aircraft-status/{reg}`)
- 10 backend тестов
- Правовые основания: ВК РФ ст. 36-37.2; ФАП-145/148; EASA Part-M; ICAO Annex 6/8

## v17 (2026-02-13) — Сертификация персонала ПЛГ
### Added
- **Модуль «Персонал ПЛГ»** — полный учёт специалистов, аттестация, ПК
  - 11 программ подготовки (PLG-INIT/REC/TYPE + 8 спецкурсов)
  - 13 модулей первичной подготовки (240 ч, соответствие EASA Part-66)
  - Карточка специалиста с историей аттестаций и квалификаций
  - Compliance dashboard (просроченные / истекающие)
  - Экспорт CSV/JSON
- **DB миграция** `005_personnel_plg.sql` (3 таблицы + RLS + индексы)
- **Интеграция с risk_scheduler** — автоматические алерты при просрочке ПК
- **Вкладка «Персонал ПЛГ» в панели ФАВТ** (агрегированные данные)
- 15 backend тестов + 1 E2E
- Правовые основания: ВК РФ ст. 52-54; ФАП-145/147/148; EASA Part-66; ICAO Annex 1

## v15 (2026-02-13) — Панель регулятора ФАВТ
### Added
- **Панель регулятора ФАВТ** — 6 read-only endpoints + 5-tab UI page
  - Сводка, Реестр ВС, Сертификация, Безопасность, Аудиты
  - PDF и JSON экспорт отчётов
  - Правовые основания: ВК РФ, ФАП-246/285, ICAO Annex 6/7/8/19, EASA Part-M/ARO
- Роль `favt_inspector` в Keycloak
- 12 тестов на контроль доступа и защиту данных
- Аудит-логирование всех запросов к /regulator

## v14 — Full Production Stack
### Added
- Universal API proxy (consolidated 23→14 routes)
- Request logging middleware (X-Response-Time)
- Enhanced health check (DB, Redis, Scheduler)
- Data restore endpoint (JSON upload)
- Analytics page (/analytics)
- Auto-migration on startup

## v13 — Dead Code Elimination
### Removed
- 12 dead components (−663 lines)
- 5 dead API routes (−494 lines)
- 7 dead hooks (−625 lines)
- 2 dead services (−100 lines)
### Fixed
- All remaining modals wired into pages
- ErrorBoundary + SkipToMain in layout

## v12 — Zero Inline Styles
### Changed
- **0 inline styles** across entire frontend (was 450+)
- All components converted to Tailwind CSS
### Added
- OIDC JWT verification backend (oidc.py)
- Backup/restore API
- Dark mode toggle in Sidebar
- Activity Timeline, Online Users, Keyboard Help

## v11 — UI Library & Refactoring
### Added
- 9 UI components: PageLayout, DataTable, Modal, FilterBar, StatusBadge, FormField, EmptyState, Pagination, NotificationBell
- Batch operations API
- Email notification service
- OIDC auth hook (frontend)
### Changed
- 14 modals refactored: 4,933→593 lines (−88%)
- Dashboard: 773→180 lines (−77%)

## v10 — Tailwind CSS Migration
### Changed
- 14 pages migrated to Tailwind (−2,108 lines)
- Keycloak OIDC realm configuration
- 8 Playwright E2E smoke tests

## v9 — Monitoring & PWA
### Added
- Prometheus metrics + alerts (5 rules)
- Grafana dashboard (5 panels)
- PWA: manifest, service worker, offline page
- Docker Compose: 3 profiles
- Helm chart for Kubernetes
- Dark mode + i18n (ru/en)

## v1-v8 — Core Platform
### Added
- 12 DRY API routes → 70+ endpoints
- Multi-tenancy RLS (178-line SQL migration)
- Rate limiting, RBAC (6 roles)
- WebSocket realtime notifications
- CI/CD pipeline (.github/workflows)
- Comprehensive audit logging
- Risk scheduler (APScheduler)
- Export API (CSV/JSON, 5 datasets)