Przepływ danych

1. Aktywacja PTT — klawisz lub przycisk kontrolera (Pygame / win32api).
2. Nagranie — zapis audio do pliku wejściowego (chunkowo pyaudio).
3. Zwolnienie PTT — zamknięcie nagrania; start Whisper.
4. Whisper — tekst; klasyfikacja intencji (pogoda, nawigacja, wyliczenia, procedury).
5. Dobór danych — przygotowanie METAR / kontekstu trasy+planu / modułu obliczeń.
6. SimBrief (tle) — DEP/ARR, elementy OFP dla spójności odpowiedzi.
7. METAR (tle) — CheckWX dla wybranego ICAO (bez kodu: heurystyka plan+pozycja).
8. Gemini — generacja odpowiedzi w języku i stylu z ustawień + reguły komunikacji.
9. TTS — wypowiedź; kontrola nakładania się z nowym PTT (stop_julia_mowy / flagi).
10. Aktualizacja GUI — panel ZULU, log tekstowy, kafelki trasy (gdy dotyczy).

SimConnect → telemetria + pozycja
     ↓
Interfejs aktualizuje kafelki trasy (kolory: najbliższy / kolejny / dalsze / TOC-TOD)
     ↓
Kontekst pozycji wspiera dobór lotniska METAR, gdy pilot nie podał ICAO

SimBrief → DEP/ARR (kontekst planistyczny)
     ↓
Heurystyka lotniska (plan + pozycja SimConnect), o ile brak jawnego ICAO w mowie
     ↓
CheckWX → METAR
     ↓
Panel ZULU (raw + wyróżnienia) + kontekst dla Gemini

Ta mapa pokazuje, że odpowiedzi nie są „czystą AI” — to połączenie mowy, lotu i METAR w ustalonej kolejności.

• UI może aktualizować się tuż po zakończeniu pobrania HTTP; SimConnect może być szybszy niż odpowiedź LLM — log i ZULU pokazują faktyczne dane źródłowe, a LLM je interpretuje.
• Pilot Hangar (Firestore) może być opóźniony względem aplikacji desktopowej — nie jest „źródłem prawdy” w tej samej milisekundzie co SimConnect w locie.

Pilot --PTT+audio--> [Julia Audio Thread]
[Julia Audio Thread] --wav--> Whisper --text--> Intent Router
Intent Router --HTTP--> SimBrief / CheckWX
Intent Router --read--> SimConnect (telemetria już w tle w Data Thread)
Intent Router --prompt+context--> Gemini --text--> TTS --> Pilot
Intent Router --state--> GUI (ZULU, log, kafelki)
Parallel: [Data Thread] <--loop-- SimConnect
Parallel: HWID / isPaid <--HTTPS--> Firebase (start / cykl życia)

• Czy METAR w odpowiedzi pochodzi z CheckWX dla właściwego ICAO (ślad w logu)?
• Czy plan w promptcie odpowiada ostatniemu pobraniu SimBrief?
• Co dzieje się przy utracie SimConnect — czy wątek danych przechodzi w oczekiwanie bez zatrzymania UI?
• Czy duplikaty żądań HTTP (retry) nie powodują podwójnego TTS (idempotencja po stronie aplikacji)?

• Opóźnienie zwolnienie PTT → start TTS (percentyle).
• Wskaźnik błędów CheckWX / SimBrief / Gemini / Firebase.
• Czas pętli SimConnect vs docelowy interwał (np. 500 ms z dokumentacji).

• MQTT — patrz mqtt.md; poza PDF Julii (MSFS).
• Hangar — odczyt Firestore dla mapy; inna ścieżka niż przepływ w czasie rzeczywistym w kokpicie.