Bezpieczeństwo

Hardware ID (HWID) — get_hwid

Celem jest uniemożliwienie nieautoryzowanego kopiowania oprogramowania.

• Mechanizm: kombinacja m.in. numeru seryjnego płyty głównej (UUID) i identyfikatora procesora, następnie haszowanie → unikalny identyfikator przypisany do licencji.
• Integracja z Firebase: przy starcie wysyłany jest hash HWID; niezgodność z kontem → tryb LIMITED / blokada kluczowych funkcji AI.
• Powiązanie 1:1: w opisie produktowym każda licencja w Firebase jest sztywno przypisana do jednego HWID; uruchomienie na innym komputerze przy tym samym loginie → blokada funkcji AI.
• Odporność na prostą manipulację: dokumentacja wspomina SHA-256 przy identyfikatorze.

Obfuskacja i dystrybucja

Wersja komercyjna jest przygotowana do kompilacji (np. PyInstaller, Nuitka) wraz z ukrywaniem konsoli (ctypes) — utrudnienie wyciągania logiki biznesowej i kluczy API.

Problem

Biblioteki niskopoziomowe (SimConnect, PyGame itd.) mogą wypisywać błędy do sys.stdout. W trybie GUI bez widocznej konsoli prowadzi to do błędu w stylu:

AttributeError: 'NoneType' object has no attribute 'write'

— z ryzykiem nagłego zamknięcia aplikacji (np. w fazie lądowania).

Rozwiązanie

• Klasa NullWriter — podmiana sys.stdout i sys.stderr na obiekt „połykający” niechciane komunikaty; aplikacja pozostaje stabilna.
• ctypes.windll.user32.ShowWindow(console_handle, 0) — alokacja konsoli w tle z natychmiastowym ukryciem („czyste GUI” przy zachowaniu procesów wymagających konsoli).

Z architektury PL: mechanizmy zapewniające brak zbędnych okien diagnostycznych dla użytkownika końcowego — komfort i mniejsze rozproszenie w kokpicie.

Mimo ukrycia konsoli dla użytkownika:

• logowanie statusów zapytań do Gemini (monitoring limitów API),
• mechanizmy testowe w kodzie (np. znaczniki typu „Julia wygenerowała…”) dla szybkiego audytu odpowiedzi.

Stripe

• Webhooks: po udanej płatności sygnał do backendu / Firebase — automatyczne odblokowanie pola isPaid dla danego HWID.
• Subskrypcja: weryfikacja isPaid w czasie rzeczywistym; odblokowanie m.in. Gemini 1.5 Pro.
• Trial: ograniczenie liczby zapytań (np. 50 zapytań / miesiąc) dla użytkowników bez subskrypcji (wartości z dokumentacji produktowej — skaluj według wdrożenia).

Make.com

• Automatyczne nadawanie uprawnień: po płatności Stripe → aktualizacja isPaid w Firebase bez zwłoki.
• Cyk życia klienta: monitoring wygaśnięcia subskrypcji, powiadomienia, limity tokenów — redukcja kosztów operacyjnych i błędu ludzkiego.
• Webhooki: bezpieczna komunikacja między systemami finansowymi a bazą; integralność licencji HWID.

Firebase — centralny rejestr

• Auth / token przy starcie — możliwość zdalnej blokady bez aktualizacji aplikacji.
• Synchronizacja ustawień (głos, interwały, mapowanie PTT) w chmurze; limit nadal powiązany z HWID.

• W miejscach krytycznych (sieć, mowa, integracje UI) błędy są obsługiwane tak, by nie zatrzymać całej aplikacji.
• Procedura awaryjna (recovery):
  • zatrzymanie aktywnych procesów mowy,
  • przywrócenie spójności stanu wejścia,
  • w razie potrzeby reset krytycznych pętli,
  • szybki powrót do działania po chwilowych problemach audio / urządzenia / sieci.

W kokpicie zamrożenie GUI lub długie blokady są ryzykiem operacyjnym. Julia realizuje rozdział:

• wątek interfejsu — tylko rysowanie i szybkie reakcje,
• ciężkie zadania w tle — STT, LLM, pobieranie METAR/planu, TTS,
• bezpieczne aktualizacje UI — wynik przygotowywany w tle, aktualizacja widgetów w momencie bezpiecznym dla Tkinter (unik „widget nie istnieje” / losowych błędów przy bezpośrednim pisaniu z wątków roboczych).

W dokumentacji źródłowej Julia (aplikacja + MSFS) opiera się na HTTPS do usług (SimBrief, CheckWX, API Gemini, Firebase itd.). Broker MQTT nie jest opisany jako magistrala tego produktu — szczegóły w pliku technical/mqtt.md.

Dla Pilot Hangar (Next.js) nadal obowiązują ogólne zasady: brak sekretów w bundle klienta, reguły Firestore, weryfikacja webhooków Stripe po stronie serwera.

• Minimalizacja pól w payloadach do chmury; retencja zgodna z polityką i umową.
• Logi bez sekretów i bez nadmiernych danych osobowych; korelacja po hwid / traceId tam, gdzie potrzebna diagnostyka.

• Aktualizacja zależności Python; dla wdrożeń kontenerowych (inne komponenty ekosystemu) — skan obrazów, pinowanie digestów baz (patrz technical/docker.md).