124 lines
5.9 KiB
Markdown
124 lines
5.9 KiB
Markdown
# Фаза 2, Шаг 3: Перенос и доработка визуала noisemap на VM-FR24
|
||
|
||
## Статус
|
||
🔲 Не начат (зависит от Шага 2)
|
||
|
||
## Цель
|
||
Перенести прототип noisemap (сейчас работает на mva154) на VM-FR24, адаптировать его для работы с новой витриной данных `fr24_mart` и доработать UI под новые возможности.
|
||
|
||
---
|
||
|
||
## Бизнес-требования
|
||
|
||
### BR-1: Перенос прототипа
|
||
- Прототип noisemap переносится с mva154 на VM-FR24
|
||
- Работает как отдельный контейнер в том же docker-compose стеке
|
||
- Доступен по тому же пути `/noisemap/` через nginx reverse proxy
|
||
|
||
### BR-2: Адаптация под витрину данных
|
||
- Источник данных: `fr24_mart` вместо CSV/JSON файлов
|
||
- Слой плотности пролётов — из `fr24_mart.noise_grid`
|
||
- Треки рейсов — из `fr24_mart.track_points_unified`
|
||
- Информация о рейсе — из `fr24_mart.flights_unified`
|
||
- Слайдер по дням — работает с реальными датами из БД
|
||
|
||
### BR-3: Новые возможности UI
|
||
- Фильтр по источнику данных: RTL-SDR / FR24 API / все
|
||
- Индикатор покрытия: % рейсов с треком для выбранного дня
|
||
- Попап рейса: показывать авиакомпанию, маршрут, тип ВС, источник данных
|
||
- Live режим: автообновление карты каждые 60 сек (данные из RTL-SDR)
|
||
|
||
### BR-4: Шумовая карта
|
||
- Слой шума строится из `fr24_mart.noise_grid`
|
||
- Цветовая шкала: зелёный (тихо) → жёлтый → красный (шумно)
|
||
- Легенда с единицами (условные единицы шума)
|
||
- Возможность переключения между "плотность пролётов" и "уровень шума"
|
||
|
||
---
|
||
|
||
## Технические требования
|
||
|
||
### Контейнер `fr24-noisemap`
|
||
- Flask + OpenLayers (как в прототипе)
|
||
- Подключение к PostgreSQL (fr24_mart схема)
|
||
- Порт: 5556 (как в прототипе на mva154)
|
||
- Nginx proxy: `/noisemap/` → `fr24-noisemap:5556`
|
||
|
||
### API endpoints (новые/изменённые)
|
||
```
|
||
GET /api/dates — список дат с данными
|
||
GET /api/density?date= — шумовая сетка за дату (из noise_grid)
|
||
GET /api/flights?date= — список рейсов за дату (из flights_unified)
|
||
GET /api/track/<flight_id> — трек рейса (из track_points_unified)
|
||
GET /api/live — live борты (из fr24.track_points, последние 60 мин)
|
||
GET /api/coverage?date= — метрики покрытия источников
|
||
```
|
||
|
||
### Nginx конфигурация
|
||
- Добавить location `/noisemap/` в существующий nginx на VM-FR24
|
||
- Или развернуть nginx как отдельный контейнер если его нет
|
||
|
||
---
|
||
|
||
## ТЗ для Dev-агента
|
||
|
||
### Файлы для создания/изменения
|
||
```
|
||
tasks/flightradar24/noisemap/
|
||
Dockerfile
|
||
app.py # Flask приложение (адаптация прототипа)
|
||
requirements.txt
|
||
static/
|
||
index.html # UI (адаптация прототипа)
|
||
app.js # логика карты
|
||
style.css
|
||
tasks/flightradar24/compose/docker-compose.yml # добавить сервис noisemap + nginx
|
||
tasks/flightradar24/compose/nginx.conf # конфигурация nginx
|
||
```
|
||
|
||
### Что взять из прототипа
|
||
- `tasks/flightradar24/prototype/app.py` — базовая структура Flask
|
||
- `tasks/flightradar24/prototype/static/` — UI компоненты
|
||
- `tasks/flightradar24/prototype/docs/NOISE_MODEL.md` — модель шума
|
||
|
||
---
|
||
|
||
## Тест-кейсы
|
||
|
||
### TC-1: Базовая работоспособность
|
||
- [ ] Контейнер стартует без ошибок
|
||
- [ ] Карта открывается по `/noisemap/`
|
||
- [ ] Слайдер по дням работает
|
||
|
||
### TC-2: Данные из витрины
|
||
- [ ] Слой плотности загружается из `fr24_mart.noise_grid`
|
||
- [ ] Треки рейсов отображаются из `fr24_mart.track_points_unified`
|
||
- [ ] Попап рейса показывает авиакомпанию и маршрут
|
||
|
||
### TC-3: Фильтры
|
||
- [ ] Фильтр по источнику (RTL-SDR / FR24 / все) работает
|
||
- [ ] Индикатор покрытия обновляется при смене даты
|
||
|
||
### TC-4: Live режим
|
||
- [ ] Live борты обновляются каждые 60 сек
|
||
- [ ] При отсутствии RTL-SDR данных — graceful degradation
|
||
|
||
### TC-5: Производительность
|
||
- [ ] Загрузка слоя плотности < 2 сек
|
||
- [ ] Загрузка треков за день < 3 сек
|
||
|
||
### TC-6: Перенос с mva154
|
||
- [ ] Старый прототип на mva154 продолжает работать (не ломаем)
|
||
- [ ] Новый инстанс на VM-FR24 работает независимо
|
||
|
||
---
|
||
|
||
## Зависимости
|
||
- Шаг 2 (витрина fr24_mart должна быть заполнена)
|
||
- Прототип noisemap (tasks/flightradar24/prototype/)
|
||
- Nginx на VM-FR24 (или новый контейнер)
|
||
|
||
## Риски
|
||
- Прототип использует OpenLayers — нужно проверить совместимость с новым API
|
||
- Модель шума в прототипе заточена под FR24 данные — нужна адаптация под RTL-SDR
|