klg-asutk-app/README.md
Yuriy aa052763f6 Безопасность и качество: 8 исправлений + обновления
- .env.example: полный шаблон, защита секретов
- .gitignore: явное исключение .env.* и секретов
- layout.tsx: XSS — заменён dangerouslySetInnerHTML на next/script для SW
- ESLint: no-console error (allow warn/error), ignore scripts/
- scripts/remove-console-logs.js: очистка console.log без glob
- backend/routes/modules: README с планом рефакторинга крупных файлов
- SECURITY.md: гид по секретам, XSS, CORS, auth, линту
- .husky/pre-commit: запуск npm run lint

+ прочие правки приложения и бэкенда

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-14 21:29:16 +03:00

87 lines
4.2 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.

# КЛГ АСУ ТК — Автоматизированная система управления техническим контролем
> Калининградский филиал — платформа контроля лётной годности, сертификации и безопасности полётов.
## Архитектура v22
```
┌──────────────────────────────────────────────────────────┐
│ Frontend (Next.js 14) │
│ 29 pages · 49 components · Tailwind · PWA · i18n │
├──────────────────────────────────────────────────────────┤
│ Backend (FastAPI) │
│ 147+ endpoints · 29 route files · SQLAlchemy · RLS │
├──────────────────────────────────────────────────────────┤
│ Infrastructure │
│ PostgreSQL · Redis · Keycloak OIDC · Docker · Helm │
│ Prometheus · Grafana · APScheduler │
└──────────────────────────────────────────────────────────┘
```
## Модули системы
| Модуль | Endpoints | Правовая основа |
|--------|-----------|----------------|
| ✈️ Парк ВС | 7 | ВК РФ ст. 33; ФГИС РЭВС |
| 🔧 Контроль ЛГ (AD, SB, LL, MP, Components) | 18 | ВК РФ ст. 36-37.2; ФАП-148; EASA Part-M |
| 📐 Наряды на ТО (Work Orders + CRS) | 10 | ФАП-145 п.A.50-65; EASA Part-145 |
| 🛠️ Дефекты (MEL deferral) | 5 | ФАП-145 п.A.50; EASA Part-M.A.403 |
| 🎓 Персонал ПЛГ (11 программ) | 10 | ФАП-147; EASA Part-66; ICAO Annex 1 |
| 📋 Чек-листы + аудиты | 12 | ВК РФ ст. 28; ICAO Doc 9734 |
| ⚠️ Управление рисками | 3 | ICAO Annex 19; ВК РФ ст. 24.1 |
| 📄 Сертификация эксплуатантов | 9 | ФАП-246; ICAO Annex 6 |
| ⚙️ Модификации ВС | 5 | ФАП-21; EASA Part-21 |
| 🏛️ Панель ФАВТ (read-only) | 9 | ВК РФ ст. 8; ФЗ-152 |
| 📚 Нормативная база | 21 | 19 исходных документов |
| 📊 Dashboard + Analytics | 2 | — |
## Сквозная интеграция
```
ДЛГ (AD) ──→ WO (наряд) ──→ CRS ──→ AD complied
SB ─────────→ WO ──────────→ CRS ──→ SB incorporated
Дефект ─────→ WO ──────────→ CRS ──→ Defect rectified
Life Limit ─→ WO (по остатку) ──→ Component updated
Персонал ───→ scheduler (6ч) ──→ Risk alert
```
## Запуск
```bash
# Development
docker compose --profile base up -d
cd backend && pip install -r requirements.txt && uvicorn app.main:app --reload
cd .. && npm install && npm run dev
# Production
docker compose --profile full up -d
# Kubernetes
helm install klg-asutk ./helm/klg-asutk
```
## Правовые основания (19 документов)
### Законодательство РФ
- Воздушный кодекс РФ, 60-ФЗ (ст. 8, 24.1, 28, 33, 35, 36, 37, 37.2, 52-54)
- ФЗ-488 от 30.12.2021 — ст. 37.2 «Поддержание ЛГ»
- ФАП-10/246 · ФАП-21 · ФАП-128 · ФАП-145 · ФАП-147 · ФАП-148 · ФАП-149
- Поручение Президента РФ Пр-1379 · ТЗ АСУ ТК (утв. 24.07.2022)
- ФЗ-152, ФЗ-149
### ICAO
Annex 1, 6, 7, 8, 19 · Doc 9734, 9760, 9859
### EASA
Part-21 · Part-66 · Part-M · Part-CAMO · Part-145 · Part-ARO
## Тесты
```bash
cd backend && pytest -v # 113 tests
npx playwright test # 16 E2E tests
```
---
© АО «REFLY» — Разработчик АСУ ТК КЛГ