wiki/tasks/flightradar24/reports/dev-2026-04-21-schedule-ui.md

dev-2026-04-21-schedule-ui.md

Дата: 2026-04-21
Статус: DONE
ТЗ: TZ-schedule-ui-enrichment.md

---

Задача

Обогащение UI расписания данными из flight_actual и mart.flights:

• Новые колонки: ВПП, тип ВС, регистрация, длительность, взлёт/посадка факт
• Source badge для FR24-источников
• Track badge для RTL-SDR/FA треков
• Убрать дублирующийся столбец Трек и столбец Статус

---

Выполненные изменения

main.py — функция schedule_data()

1. SQL переписан с bare FROM fr24_ext.schedule на FROM fr24_ext.schedule s с двумя LEFT JOIN:

   • LEFT JOIN fr24_ext.flight_actual fa ON fa.fr24_id = s.fr24_id AND s.fr24_id IS NOT NULL
   • LEFT JOIN fr24_mart.flights mf ON mf.flight_number = s.flight_number AND mf.flight_date = s.flight_date

2. Добавлены новые SELECT поля:

   • fa.runway_takeoff, fa.runway_landed
   • fa.actual_distance
   • fa.flight_time AS fa_flight_time
   • fa.reg AS registration
   • fa.operated_as
   • fa.category AS fa_category
   • mf.aircraft_type
   • mf.track_source, mf.track_points
   • s.source AS sched_source

3. Фикс ambiguity: _schedule_where() генерирует WHERE без table-alias. После JOIN столбцы flight_date и flight_number становятся неоднозначными (есть в flight_actual и mart.flights). Решение: в schedule_data() применяется re.sub() для подстановки s. prefix перед этими колонками в safe_where строке.

4. Новые поля в JSON-ответе:

   • runway_takeoff, runway_landed
   • actual_distance
   • flight_time_min (из fa_flight_time)
   • registration
   • aircraft_type
   • track_source, track_points
   • sched_source
   • duration_eff = fa_flight_time or duration_min

---

schedule.html — полная перепись

Было: 12 колонок, Трек дублировался в col 2 и col 12, был столбец Статус
Стало: 13 колонок согласно ТЗ:

#	Колонка	Данные
1	Дата	flight_date
2	Рейс	flight_number + cat badge + source badge
3	Авиакомпания	airline + registration (мелко)
4	↑↓	direction icon
5	Маршрут	thread_title или origin → destination
6	Аэропорт	airport_iata
7	По расп.	scheduled_at (MSK)
8	Взлёт факт	actual_takeoff (MSK) + delay badge
9	Посадка факт	actual_landed (MSK) + delay badge
10	Длит.	duration_eff в формате "2ч 35м"
11	ВПП	runway_takeoff → runway_landed
12	ВС	aircraft_type
13	Трек	✈ FR24 + 🛰 RTL-SDR + FA badge

Добавлен CSS:

• .src-badge + .src-fr24 для badge источника данных

---

schedule.js — полная перепись

Новые функции:

• fmtDuration(min) — форматирует минуты как "2ч 35м" или "45м"

renderTable() переписана:

• 13 колонок вместо 12
• actTakeoffCell: actual_takeoff + delayCell(delay_takeoff_min)
• actLandedCell: actual_landed + delayCell(delay_landed_min)
• airlineCell: airline + <small>registration</small> под ней
• srcBadge: показывается если sched_source === 'fr24'
• trackCol: ✈ (если fr24_id) + 🛰 (если track_source=rtlsdr) + FA (если track_source=fa)
• runway: runway_takeoff → runway_landed или "—"
• acType: aircraft_type
• durationCell: fmtDuration(duration_eff)

renderCards() обновлена — добавлены строки:

• Взлёт факт + задержка
• Посадка факт + задержка
• Длительность
• ВПП
• ВС / Борт (aircraft_type / registration)
• Трек (✈ FR24, 🛰 RTL-SDR, FA)

delayCell() — убран возврат "—" для null (теперь возвращает пустую строку, чтобы не засорять ячейки когда задержки нет)

colspan везде обновлён с 12 на 13 (setLoading, showError, empty state)

---

Деплой

Файлы нужно скопировать на VM в контейнер fr24-api:

/home/fr24/projects/fr24/frontend/main.py
/home/fr24/projects/fr24/frontend/static/schedule.html
/home/fr24/projects/fr24/frontend/static/schedule.js

После: docker restart fr24-api

---