Polish Integrated Display System dla kontrolerów VATSIM PL vACC. Układ wzorowany na PANDORZE (PAŻP), zawartość zakładek w stylu EUROCONTROL NM UI. Backend FastAPI + SQLite, frontend w czystym JS, całość w Dockerze.
| Zakładka | Co jest |
|---|---|
| RADIO | jedna strona jak w PANDORZE: u góry pasek ATIS polskich lotnisk, podglądy FIR EPWW LOW (przekrój FL095–FL330 suwakiem wysokości), mały MID i HIGH z obszarami stanowisk ACC: sektory obsługiwane przez to samo stanowisko (kolejność przejmowania z om.plvacc.pl) jako jeden obszar z nazwą stanowiska i częstotliwością, sektorów bez nikogo nie rysujemy (zostaje granica FIR EPWW); stosy sektorów sąsiadów graniczących z EPWW jak w VACS, bez FMP (ESAA, EDWW, EDUU, EDMM, LKAA po lewej; UMKK, EYVL, UMMV, UKLV, LZBB po prawej): częstotliwość tylko, gdy ktoś obsługuje sektor, bez nikogo w stosie ADVISORY 122.800, granice FL raz, między polami; warstwy ATIS, LOW MID HIGH, APP (część TMA na stanowisko: WA APP, WA N APP, WA S APP; TMA bez APP z wieżą), TWR, TWR/ATIS i FIS – etykiety obok obrysów TMA i CTR, z linią do punktu, częstotliwość tylko, gdy ktoś obsługuje; kliknięcie nazwy FIR-u sąsiada otwiera wyciąg z LOA (tabele przekazań, zasady, stanowiska, PDF w OTHER › DOCS) |
| METEO | METAR/TAF, mapa QNH regionalnego na podkładzie jak mapa rejonów QNH z AIP Polska (PAŻP), WIND z wiatrem 0 ft / 3000 ft na podejściu do każdego pasa, SAT PL i SAT EUR, TURB (mapy turbulencji IMGW +0…+21 h z odtwarzaniem), SIGWX (IMGW) |
| AERODROME | podzakładki jak w PANDORZE: 0 = OVERVIEW całego FIR EPWW (jeden TL dla kraju: FL080, a FL090, gdy na którymkolwiek lotnisku QNH ≤ 995 hPa; METAR/TAF ze stanem LVP, aktywne NOTAM-y, restrykcje ECFMP i vIFF, Airport Monitor vIFF; filtr stanowiska: APP/ACC zawęża lotniska i pokazuje checklistę otwarcia, TWR przenosi do lotniska); EPWW, ESAA, ED, ET, LKAA, LZBB, UMKK, EYVL, UMMV, UKLV = listy lotnisk FIR-u (także VFR i MIL) z wyszukiwarką WYŚWIETL / WYCZYŚĆ; lotnisko zagraniczne: karta z METAR, TAF, ATIS i stanowiskami APP/TWR/GND/DEL/ATIS; lotnisko polskie: PRZEGLĄD (wiatr, pasy, ATIS, LVP, NOTAM, częstotliwości, wiatr na podejściu), AWOS (wiatr co 5 s, RVR z METAR albo symulowany, układ 1 PAS / 2 PASY z osobnym pasem DEP i ARR) i RUCH jak DMAN/AMAN (drabiny TSAT, TTOT i ELDT, na lotniskach bez A-CDM EOBT i ETOT; widok AMAN z punktami wejścia i odstępem FLOW) |
| AD CIV / AD MIL / AD VFR, INOP | eAIP PAŻP; INOP: om.plvacc.pl (procedury operacyjne PL vACC) |
| CALLSIGN, AIRCRAFT | callsigny, typy samolotów (WTC, RECAT-EU, wymiary, zdjęcia, przyciski producentów) |
| MAP | ruch VATSIM (odlot / przylot / tranzyt), przestrzeń na wybranym poziomie FL (ACC, TMA, CTA, CTR, FIS, sektory sąsiadów z ich plików .ese), przepustowość i szczegóły lotów z vIFF; ATIS linia po linii, dane kontrolera po najechaniu na plakietkę lub opis stanowiska, lista sąsiednich FIR-ów domyślnie zwinięta; obsada wg kontrolerów online: sektory jednego stanowiska jako jeden obszar z jedną etykietą (granica tylko tam, gdzie zmienia się obsługujący), przestrzeni bez nikogo nie rysujemy; sekcja Pozycje: drzewo FIR → ACC / FIS / lotniska → stanowiska, w którym można włączyć stanowisko offline (symulacja logowania, SYM) albo ukryć zalogowane – sektoryzacja, plakietki lotnisk i plakietki CTR FIR-ów wg tego wyboru |
| PHRASEOLOGY | baza frazeologii EUROCONTROL |
| CHECKLIST, EMERGENCY | checklisty stanowiska, procedury awaryjne EUROCONTROL |
| SYT OP | wszystkie aktywne NOTAM-y FIR EPWW i głównych lotnisk (cv.plvacc.pl) z filtrem lokalizacji i tekstu, sortowaniem i pełną treścią |
| AUP | na razie tylko informacja, że będzie dostępny w przyszłości |
| STRIP | paski postępu lotu EFES (przeniesione z AERODROME › RUCH), podzakładka dla każdego z 15 głównych lotnisk |
| OTHER | podmenu; pierwsza podzakładka DOCS: PDF-y z data/docs/ (w tym LOA EPWW z sąsiadami), adres #other/docs/<plik> (stare #docs/<plik> przekierowuje) |
| ? (HOME), ABOUT | HOME: samo przywitanie „Witaj, imię i nazwisko (CID)”; ABOUT: informacje o programie, skróty do zakładek i lista zmian |
| ADMIN | lista CID-ów z dostępem i odmowy logowania (tylko admin) |
Źródła danych: pliki EuroScope (sektorówka EPWW, navdata, pliki .ese vACC sąsiadów w data/import/neighbours/; sektory z nich
w data/seed/sectors.geojson), VATSIM (data feed, bookings), metar.vatsim.net /
aviationweather.gov, NOTAM z cv.plvacc.pl, vIFF, ECFMP, OurAirports, vacs-data, VATSpy,
VATSIM Germany Knowledgebase (data/seed/names_de.json), LOA (data/docs/LOA/, wyciąg data/seed/loa.json).
cp .env.example .env
docker compose up --buildhttp://localhost:1337 - pierwszy build trwa kilka minut (import sektorówki i navdata do bazy w obrazie).
Lokalnie domyślnie jest POLIDS_AUTH_MODE=dev, czyli formularz z dowolnym CID i ratingiem zamiast VATSIM.
Praca nad kodem (backend przeładowuje się sam, zmiany w JS/CSS po odświeżeniu):
docker compose -f docker-compose.yml -f docker-compose.dev.yml up --buildBez Dockera: pip install -r requirements.txt i
python -m uvicorn backend.app.main:app --port 1337 --reload --reload-dir backend.
Testy:
docker build --target test -t polids-test . && docker run --rm polids-testSwagger: http://localhost:1337/docs (po zalogowaniu).
Wszystko przez zmienne POLIDS_* w .env, opis w .env.example. Klucze wpisujemy tylko do .env,
repo jest publiczne.
Logowanie (POLIDS_AUTH_MODE):
none- bez logowania,dev- formularz testowy, tylko na localhost,vatsim- VATSIM Connect, na serwerze wymuszone wdocker-compose.prod.yml. WymagaPOLIDS_VATSIM_CLIENT_ID,POLIDS_VATSIM_CLIENT_SECRETiPOLIDS_SECRET_KEY(min. 32 znaki), inaczej aplikacja nie wstanie.
Kto może wejść:
- administratorzy z
POLIDS_AUTH_ADMIN_CIDS- zawsze, i tylko oni widzą zakładkę ADMIN, - CID-y dodane przez admina w zakładce ADMIN (dodaj, usuń, opis). Usunięcie odcina dostęp od razu,
- reszta dostaje "Brak dostępu dla CID ...", a próba ląduje w ADMIN -> Odmowy dostępu, skąd można ją dodać jednym klikiem.
Lista jest w osobnej bazie data/state/polids-state.db (w Dockerze wolumen state), bo polids.db jest
przebudowywana z repo przy każdym obrazie. Bez logowania dostępne jest tylko /auth/*, /healthz i pliki PWA.
Do testów VATSIM Connect bez prawdziwych kont jest sandbox https://auth-dev.vatsim.net (konta 10000000-10000010,
hasło = CID), ustawiany przez POLIDS_VATSIM_AUTH_URL.
PWA: w Chrome/Edge "Zainstaluj aplikację" w pasku adresu - otwiera się jako osobne okno.
Docker Compose na VPS + Caddy (Let's Encrypt), obraz budowany w GitHub Actions i trzymany w GHCR, deploy po pushu
do main. Instrukcja: deploy/README.md.
- nowa sektorówka: podmienić pliki w
data/import/, odświeżyć sektory (python -m backend.app.importers.sectors_geojson) i przebudować obraz (na serwerze wystarczy push) - sektory EPWW i sąsiadów (MAP, RADIO): aplikacja bierze je z
data/seed/sectors.geojson, a ten plik generujepython -m backend.app.importers.sectors_geojsonz plików.ese(--check: czy plik pasuje do plików.esei ustawień generatora; po podmianie pliku przypomina o tym test, ostrzeżenie w logu przy starcie, a build obrazu Dockera się przerywa). Ręczne poprawki w pliku działają po restarcie aplikacji, generator je nadpisze - OurAirports:
python scripts/fetch_ourairports.py(tylko lotniska i pomoce; elewacje ze źródłem, z AIP albo lotniska.dlapilota.pl, zostają; lotnisko z pasami lub częstotliwościami, którego OurAirports już nie ma, zostaje z ostrzeżeniem; pasów i częstotliwości skrypt nie nadpisuje) - pasy, częstotliwości (z godzinami pracy i uwagą), pasy preferowane i progi LVP z AIP Polska / AIP MIL (eAIP PAŻP): ręcznie
w
data/seed/runways.csv(metry),frequencies.csv,runway_config.json,lvp.json; każdy wiersz/wpis ma źródło (sekcja AIP albo serwis dla lotnisk VFR). Po zmianie CSV podbićSCHEMA_VERSIONwbackend/app/database.py(przy starcie pełny import danych) - typy samolotów:
python scripts/build_aircraft_seed.py <ścieżka do aircraft-db> - logo i ikony:
frontend/icons/(paczka logo PolIDS, opcja „FIR EPWW”) - sąsiedzi: nowszy plik
.esevACC sąsiada dodata/import/neighbours/(lista wdata/import/README.md), potem generatorsectors.geojsonjak wyżej - bez kodu:
data/seed/qnh_regions.json,lvp.json,runway_config.json,checklists.json,emergency.json,callsigns.csv
Jeśli na lotnisku nadaje ATIS, pas w użyciu bierzemy z jego tekstu. Bez ATIS-u (zasada z vatiris):
- pasy preferowane z AIP AD 2.21 (
data/seed/runway_config.json: EPWA, EPMO, EPWR, EPGD, EPPO) w swoich oknach czasowych (godziny UTC zimą, w nawiasie latem; czas letni UE liczony bez tzdata), osobno dla lądowań i startów, w kolejności z AIP („26, potem 08”); pas odpada, gdy składowa w plecy albo boczna z porywami przekracza limit z AIP albo gdy zachodzi warunek, przy którym hałas nie decyduje (podstawa chmur, widzialność, podejście bez ILS, burza); wtedy do startu pierwszy pas z listy AIP w limicie wiatru (ILS liczy się tylko przy lądowaniu: EPWA w mgle ARR 33, DEP 29); start pod prąd lądowań (ten sam pas, przeciwny kierunek) tylko na lotnisku z jednym pasem, gdzie AIP to dopuszcza (EPPO przy 100/08: ARR 10, DEP 28), na EPWA następny pas z listy (przy 190/10: ARR 11, DEP 15, nie 29); w LVP pasów preferowanych z AD 2.21 nie stosujemy: obowiązują pasy dopuszczone w LVP przez AD 2.22 (kluczlvp, EPWA: lądowania 33 albo 11, starty 29 albo 15; EPPO: lądowania 28, starty 28 albo 10), starty nigdy pod prąd lądowań (EPWA 33/29 albo 11/15, EPPO 28/28), pierwsza para z wiatrem w plecy z porywami w limicie lotniska (EPWA przy 070/10: 11/15, nie 33/29 z 7 kt w plecy), bez niej osobno pierwszy pas w limicie; lądowania tylko od minimów kategorii ILS (RWY 11 CAT II od RVR 300 m, RWY 33 CAT IIIA od 175 m; poniżej minimów na wszystkich pasach pas z najniższymi, z uwagą), a przy RVR pasa startowego < 125 m ostrzeżenie „starty niedozwolone” (bez grupy RVR widzialność, tak też nazwana); bez list z AD 2.22 kierunek z ILS, - LVP / przygotowanie LVP / IMC: kierunek z ILS, o ile wiatr w plecy nie przekracza 5 kt (przy ciszy i wietrze zmiennym pierwszy w kolejności lądowań z AIP),
- słaby wiatr (< 5 kt), tylko lotniska bez pasów preferowanych w AIP: konfiguracja preferowana lotniska (arr/dep
w
runway_config.json, obecnie żadne lotnisko jej nie ma), bez niej kierunek z ILS, - w pozostałych przypadkach największa składowa czołowa.
Wyposażenie pasów (ILS, RNP, VOR, NDB) czytane jest z nazw procedur w .ese. Pasa niesuchego i uskoku wiatru z METAR
nie oceniamy.
Progi z AIP AD 2.22 i AIP MIL AD 4.20 w data/seed/lvp.json: przygotowanie, wprowadzenie i odwołanie (RVR, widzialność,
podstawa chmur; lotniska wojskowe: widzialność z odpowiednikiem RVR, tylko odloty). LVP po wprowadzeniu trwa do spełnienia
warunków odwołania (histereza w pamięci procesu, po restarcie albo przerwie w METAR-ach ponad 90 min od zera; starszy
METAR z innego zapytania dostaje stan z nowszego), potem przez 30 min od godziny odwołania „LVP ODWOŁANE”. Lotniska, dla
których AIP nie przewiduje LVP (VFR, część wojskowych, EPRA, EPZG), mają „nie dotyczy”. EPWA i EPPO: z tekstu AD 2.22
wklejonego przez Marka (strony eAIP urywały się przy pobieraniu).
- PAŻP, om.plvacc.pl i EUROCONTROL Learning Zone blokują ramki (
X-Frame-Options) - zostaje przycisk "otwórz w nowej karcie". - Format NOTAM z cv.plvacc.pl nie jest udokumentowany, parser dzieli tekst po nagłówkach
A1234/26 NOTAMN. - Parser ATIS obsługuje typowe formaty vATIS.
- vIFF nie publikuje schematów odpowiedzi; TOBT/TSAT/TTOT są tylko, gdy ktoś prowadzi CDM na EPWA. Godziny w vIFF są bez daty, przejście przez północ liczone względem bieżącej godziny UTC.
- AWOS nie ma czujników - wiatr chwilowy, średnia 2 min i min/max są symulowane z METAR (oznaczenie SYM). RVR bez grupy w METAR jest symulowany z widzialności (zakładamy światła HI, więc w nocy na małych lotniskach może wyjść za wysoki).
- QFE liczone w przybliżeniu z QNH i elewacji.
- Rejony QNH 1-14 i obszary TMA/MTMA w
qnh_regions.jsonodrysowane ze zrzutu mapy z AIP Polska (data/import/qnh_pansa.png,scripts/trace_qnh_regions.py, ok. 0,5 km). QNH rejonu = najniższe QNH z METAR jego lotnisk (oficjalne liczy IMGW z modelu); pasy 15-17 (53°N, 51°N) = najniższe QNH z lotnisk pasa. - OVERVIEW: TL liczony z QNH 15 kontrolowanych lotnisk z METAR (lotnisko bez METAR nie jest liczone); próg 995 hPa włącznie (OM PL vACC pisze „poniżej 995”). TA 6500 ft niesprawdzone w eAIP. Część pól vIFF (przepustowość lotniska, przyloty w godzinie) odczytana z dokumentacji i odpowiedzi API. NOTAM-y wg okresu B)-C), bez harmonogramu D). ECFMP/vIFF zawsze dla całego FIR.
- LOA w RADIO to ręczny wyciąg z PDF-ów (obowiązuje PDF); LOA z Lwowem jest z 2022 r. Nazwy niemieckie z Knowledgebase (08.10.2026); CTR bez nazwy w żadnym źródle dostaje callsign wspólny dla FIR-u (szarszy, „przyjęty”).
- Kolejność przejmowania sektorów ACC z tabel om.plvacc.pl/docs/2610/ownerships (
data/seed/ownership.json, wklejone 06.10.2026, przy nowym AIRAC trzeba wkleić ponownie); B, C, D HIGH i T MID wg pliku.ese. TMA/CTR: najpierw APP/TWR z.ese, potem ACC. - Sektory sąsiadów: z każdego pliku tylko FIR-y tego vACC (z ukraińskiego tylko Lwów), sektory zależne od pasa w jednym układzie na lotnisko (kierunek najbliższy wiatrowi z ok. 250°), granice uproszczone o ok. 100 m, Białoruś (UMMV) z kopii w pliku EPWW. Zasięg stanowisk bez sektora w żadnym pliku jest przybliżony (VATSpy albo okrąg 30/10 NM).
- Paski EFES: CFL, TAXI/GATE, NR, PRV, LP/TG puste - tych danych nie ma w feedzie VATSIM ani w vIFF.
- Rezerwacje VATSIM mają tylko CID; imię widać, gdy ta osoba jest online.
- Jeden worker uvicorna (cache w pamięci). 40 osób odświeżających co 15 s to ~23 req/s przy p95 < 100 ms; sufit jednego procesu to ok. 50 req/s, wyżej trzeba Redisa i kilku workerów.
- typy samolotów: aircraft-database.com (ODC-By), progi WTC/RECAT z vatger/atciss (MIT)
- lotniska, pomoce: OurAirports (public domain)
- pasy, częstotliwości, elewacje, pasy preferowane i progi LVP: AIP Polska i AIP MIL (PAŻP, eAIP, AIRAC AMDT 10-26);
lotniska VFR spoza AIP: lotniska.dlapilota.pl, airfield.directory,
progi pasów z
EPWW-Sector.sctalbo OurAirports (źródło w kolumniesourceielevation_source) - Leaflet (BSD-2), CARTO/OpenStreetMap (ODbL), Esri World Gray Canvas
- polygon-clipping 0.15.7 (MIT, z splaytree MIT i robust-predicates
Unlicense) w
frontend/vendor/polygon-clipping/: suma sektorów jednego stanowiska na mapie - ATFCM/CDM: vIFF (Roger Puig), tylko odczyt
- granice FIR: vatspy-data-project (CC BY-SA 4.0)
- callsigny i nazwy sektorów niemieckich: VATSIM Germany Knowledgebase (tylko krótkie dane, przy każdym wpisie adres źródła)
- LOA: porozumienia PL vACC z vACC sąsiadów (
data/docs/LOA/) - mapa rejonów QNH: AIP Polska (PAŻP), zrzut
data/import/qnh_pansa.png - sektory i stanowiska FIR-ów sąsiednich: pliki
.esepakietów sektorowych vACC sąsiadów (data/import/neighbours/) - łańcuchy sektorów i etykiety sąsiadów: vacs-data
(CC BY-NC-SA 4.0, commit c5aa4bd), wyciąg
data/seed/vacs_epww.jsonna tej samej licencji - checklisty stanowiska i wybór pasa: vatiris (GPL-3.0)
- checklisty EMERGENCY: EUROCONTROL HRS/TSP-004-GUI-05 wyd. 2.0, Annex A i B
- widok AWOS i mapa QNH wzorowane na vAWOS (bez licencji, więc kod napisany od nowa)
- zdjęcia samolotów z Wikipedii, autor i licencja na stronie artykułu
- pliki EuroScope: pakiet sektorowy PL vACC / GNG
PDF-y w data/docs/ (ICAO Doc 4444, Doc 9432, RECAT-EU) są chronione prawem autorskim - na serwerze tylko po
zalogowaniu, ale w publicznym repo lepiej trzymać linki niż pliki.