# FR24 / noisemap docs index

> Обновлено: 2026-04-26

## 🔑 Главный документ
- **`SYSTEM_OVERVIEW.md`** — полное актуальное описание системы: контейнеры, БД, ETL, UI, статус данных

## API
- **`FR24_API_NOTES.md`** — особенности FR24 API Explorer: лимиты, пагинация через временны́е окна, правильные prefixes, стоимость

## Основные документы
- `tasks/flightradar24/PROJECT.md` — общий статус и границы проекта
- `tasks/flightradar24/docs/ARCHITECTURE.md` — контейнерная архитектура (базовая, устарела частично)
- `tasks/flightradar24/docs/PHASE2_STEP2_DATA_MART.md` — ТЗ Фазы 2 Шаг 2 (витрина fr24_mart)
- `tasks/flightradar24/docs/VM_SETUP.md` — инструкция по созданию VM в PVE
- `tasks/flightradar24/docs/TEST_PLAN.md` — тестовый контракт

## Исторические документы (прототип)
- `tasks/flightradar24/prototype/docs/ARCHITECTURE.md`
- `tasks/flightradar24/prototype/docs/NOISE_MODEL.md`
- `tasks/flightradar24/prototype/docs/UI.md`
- `tasks/flightradar24/prototype/docs/DEVLOG.md`

## Метрики и анализ ADS-B
- **`analysis/ZUP_DEFINITION.md`** — зона уверенного приёма (35 км), метрики M1–M4, TQS
- **`analysis/adsb_quality_metrics.sql`** — SQL-запросы: гистограмма расстояний, M1–M4, TQS, RHI
- **`analysis/diagram_adsb_pipeline.png`** — схема тракта данных ADS-B → PostgreSQL
- **`specs/SPEC_M4_FILTER.md`** — ТЗ на M4-фильтр выбросов координат

## Что читать в каком порядке
1. `SYSTEM_OVERVIEW.md` — текущее состояние системы целиком
2. `analysis/ZUP_DEFINITION.md` — метрики качества ADS-B
3. `PROJECT.md` — задачи и backlog
4. `PHASE2_STEP2_DATA_MART.md` — если нужна витрина подробно