Rádioamatérsky svet sa neustále vyvíja a s ním aj nástroje, ktoré operátori používajú na evidenciu svojich spojení. Medzi najpopulárnejšie open-source logovacie programy pre operačný systém Linux patrí nepochybne CQRLOG.
Jego autor, Petr OK2CQR, niedawno opublikował wiadomość, która ucieszy szczególnie miłośników nadawania z terenu i użytkowników nowoczesnych urządzeń mobilnych – projekt CQRLOG for webChodzi o interfejs webowy do dziennika, który zapewnia mobilność bez konieczności skomplikowanej migracji danych lub zmiany filozofii obsługi, do której użytkownicy CQRLOGu są przyzwyczajeni.
W artykule przeczytasz
Filozofia projektu CQRLOG for web i motywacja do powstania
Główną ideą CQRLOG for web jest zapewnienie operatorom wygodnego i szybkiego interfejsu w przeglądarce, który łączy się bezpośrednio z ich istniejącą bazą danych CQRLOGu na komputerze. Petr OK2CQR stworzył ten projekt głównie dla potrzeb przenośnej pracy. Operatorzy, którzy zajmują się działaniami takimi jak WWFF, GMA lub SOTA, často riešia dilemu, aké zariadenie použiť na zápis spojení priamo v teréne. Klasický notebook môže byť v poľných podmienkach nepraktický kvôli váhe, výdrži batérie lub čitateľnosti displeja na slnku. Tablety a smartfóny sú v tomto smere ideálne, no doteraz chýbalo riešenie, ktoré by bolo plne integrované s hlavným domácim logom bez nutnosti následného exportu a importu ADIF plików.
Autor pri vývoji vychádzal z vlastnej skúsenosti. Predstavou bola jednoduchá zostava pozostávajúca z batohu, transceivra Elecraft KX2, batérie, telegrafného kľúča a antény typu EndFed. V takejto konfigurácii je tablet najlepším spoločníkom pre logovanie. Hoci sa prvý koncept webového rozhrania objavil už pred niekoľkými rokmi, vtedajšia verzia trpela viacerými chybami a nebola pripravená na širšie nasadenie. Súčasná verzia je kompletným prepísaním celého kódu Od základov a predstavuje stabilné riešenie, ktoré autor s dôverou sprístupňuje komunite.
Architektura i połączenie z wersją desktopową
Je dôležité zdôrazniť, že CQRLOG for web nie je samostatný, izolovaný logovací program. Je navrhnutý ako sprievodné rozhranie pre operátorov, ktorí už aktívne využívajú desktopovú verziu CQRLOGu. Systém pracuje priamo s databázou MariaDB, ktorú používa desktopová aplikácia. To znamená, že všetky spojenia zapísané cez tablet v teréne sa okamžite a bez ďalších krokov nachádzajú v hlavnej databáze.
Chociaż interfejs webowy oferuje pełnowartościowe możliwości zapisu i edycji połączeń, niektóre zaawansowane funkcje pozostają przywilejem aplikacji desktopowej. Chodzi przede wszystkim o przesyłanie danych do usług takich jak LoTW lub eQSL, masową edycję rekordów i generowanie szczegółowych statystyk. CQRLOG for web koncentruje się na tym, co jest najważniejsze w terenie: szybki i dokładny zapis QSO.
Používateľské rozhranie a ergonómia logovania
Pri návrhu rozhrania sa kládol veľký dôraz na to, aby sa používatelia cítili ako doma. Rozloženie polí v hlavnom formulári kopíruje logiku desktopovej verzie. Operátor má k dispozícii polia pre volaciu značku, frekvenciu, pásmo, mód, reporty RST, imię, QTH, lokator, moc, data i godzina, notatki, status QSL, IOTA, WAZ, ITU, kraj, powiat i informacje o dyplomach.
Ergonómia ovládania je optimalizovaná pre rádioamatérsku prácu. Podporovaná je navigácia pomocou šípok na klávesnici, čo urýchľuje pohyb medzi vstupnými poliami. Automatická kapitalizácia mena a QTH šetrí čas a zabezpečuje vizuálnu konzistenciu logu. Zaujímavou funkciou je správanie medzerníka, ktorý umožňuje rýchly skok z poľa volacej Tagi priamo na pole reportu RST. Pre rýchle vymazanie formulára pri neúspešnom spojení slúži dvojité stlačenie klávesy Escape.
Systém obsahuje automatické hodiny v reálnom čase, ktoré sa aktualizujú každú sekundu a zaznamenávajú čas začiatku aj konca spojenia. Pre situácie, kedy je potrebné do logu zapísať staršie spojenia, je k dispozícii offline režim, ktorý umožňuje manuálne zadávanie dátumu a času. Vývojár myslel aj na predvolené hodnoty reportov, ktoré sa dynamicky menia podľa zvoleného módu, napríklad 599 pre telegrafiu a 59 pre SSB alebo Tryby cyfrowe.
Inteligentne funkcje i wyszukiwanie danych
CQRLOG for web to nie tylko pusty formularz. Jest połączony z zewnętrznymi źródłami danych, które ułatwiają operatorowi pracę. Przy wprowadzaniu znaku wywoławczego odbywa się w czasie rzeczywistym wyszukiwanie danych o DXCC za pośrednictwem HamQTH. System natychmiast wyświetli kraj, kontynent oraz strefy WAZ i ITU.
Ak sa v databáze už nachádzajú predchádzajúce spojenia s danou značkou, rozhranie automaticky predvyplní polia ako meno, QTH, lokátor, štát lub okres. Táto funkcia je neoceniteľná pri contestoch lub pri pravidelných spojeniach s tými istými operátormi. Pod hlavným formulárom sa tiež zobrazuje tabuľka histórie predchádzajúcich spojení s aktuálne volanou stanicou.
Dla członków różnych klubów radioamatorskich dostępne jest wyświetlanie przynależności klubowej. System potrafi wyświetlić do pięciu różnych oznaczeń klubowych, przy czym konfigurację pobiera bezpośrednio z ustawień wersji desktopowej CQRLOGa. Częścią interfejsu jest również lista połączeń z możliwością stronicowania i edycji. Jeśli w trybie edycji zmieni się znak wywoławczy, system ponownie wykona wyszukiwanie danych DXCC, aby zapewnić integralność danych.
Integrácia s DX Clusterom a solárne údaje
Efektívna rádioamatérska prevádzka sa nezaobíde bez informácií o aktuálnom dianí na pásmach. Webové rozhranie obsahuje integrovaný Klaster DX, ktorý čerpá dáta zo servera HamQTH. Zoznam spotov sa automaticky obnovuje každých dvadsať sekúnd, takže operátor má neustály prehľad o tom, kde sa objavila zaujímavá stanica.
Oprócz samych spotów w interfejsie zintegrowane są również aktualne dane słoneczne. Wyświetlane są indeksy A i K, SFI (Solar Flux Index), SSN (Sunspot Number) oraz informacja o stanie pola geomagnetycznego. Te dane są kluczowe dla oceny warunków propagacji fal radiowych na falach krótkich i pomagają operatorowi w decyzji, na które pasmo w danym momencie się skoncentrować.
Połączenie ze stacją radiową przez Pico radio gateway
Jednou z najzaujímavejších technologických vlastností projektu je možnosť synchronizácie s rádiostanicou. Webové rozhranie dokáže v reálnom čase čítať frekvenciu a mód z transceivrov Elecraft KX2 a KX3. Táto funkcionalita je realizovaná za pośrednictwem ďalšieho autorovho projektu Pico radio gateway.
Sprzętowe połączenie transceivera z tabletem lub komputerem, na którym działa przeglądarka, umożliwia automatyczne przełączanie pasma i trybu w dzienniku zgodnie z tym, jak operator stroi radio. Format wyjściowy bramy jest celowo prosty, co otwiera drzwi społeczności do rozwoju własnych interfejsów dla radia, które jeszcze nie są bezpośrednio obsługiwane. W interfejsie dziennika znajduje się wskaźnik stanu połączenia online lub offline z radiem, a użytkownik może skonfigurować interwał odpytywania częstotliwości.
Projekt i opracowanie techniczne
Z punktu widzenia designu CQRLOG for web jest nowoczesną aplikacją o responsywnym wyglądzie. Urządzeniem referencyjnym dla optymalizacji był iPad Mini w trybie pionowym, co jest idealnym rozmiarem do operacji w terenie. Aplikacja jednak działa poprawnie na szerokiej gamie urządzeń od komputerów stacjonarnych po telefony komórkowe. Użytkownicy mają możliwość przełączania między trybem ciemnym i jasnym, przy czym system obsługuje również automatyczne wykrywanie zgodnie z ustawieniami systemu operacyjnego.
Interesującą funkcją dla czeskich i słowackich użytkowników jest transliteracja klawiatury. Jeśli operator omyłkowo pisze słowackie lub czeskie znaki diakrytyczne w górnym rzędzie numerycznym, system automatycznie konwertuje je na cyfry. Aplikacja zapamiętuje również ostatnio używane pasmo, tryb, częstotliwość i moc w poszczególnych sesjach, co przyspiesza ponowne uruchomienie pracy.
Z technicznego punktu widzenia backend jest zbudowany na frameworku PHP/Symfony, podczas gdy frontend wykorzystuje bibliotekę React. Komunikacja odbywa się przez REST API. Cała aplikacja jest dystrybuowana jako jeden kontener Docker, co znacznie upraszcza proces instalacji i wdrożenia w środowisku produkcyjnym.
Instalacja i konfiguracja systemu
Wdrożenie CQRLOG for web wymaga podstawowej znajomości pracy z terminalem i narzędziem Docker. Podstawowym wymogiem jest działająca baza danych MariaDB z istniejącym schematem CQRLOGu. Proces instalacji rozpoczyna się od sklonowania repozytorium z GitHuba. Następnie należy utworzyć plik konfiguracyjny z dołączonego przykładu i wypełnić w nim ważne dane, takie jak dane dostępowe do bazy danych, adres URL aplikacji i dane logowania do interfejsu webowego.
Samo uruchomienie aplikacji wykonuje się za pomocą polecenia make prod. Jeśli system działa za serwerem reverse proxy, takim jak Apache lub Nginx, możliwe jest opublikowanie aplikacji pod własną nazwą domeny. Szczegółowe instrukcje wraz z rozwiązaniami potencjalnych problemów są dostępne w pliku README.md w oficjalnym repozytorium projektu.
Końcowa ocena i dostępność kodu
Petr OK2CQR stworzył narzędzie, które wypełnia lukę w CQRLOGu. Chociaż projekt był rozwijany głównie dla osobistych potrzeb autora, jego jakość i stopień integracji czynią go atrakcyjnym wyborem dla szerokiej społeczności użytkowników Linuxa i oprogramowania open-source. CQRLOG for web przynosi swobodę ruchu bez utraty kontroli nad danymi.
Zdrojové kódy pre webové rozhranie aj pre Pico radio gateway sú voľne dostupné na platforme GitHub pod účtom ok2cqr. Autor víta spätnú väzbu Od používateľov a verí, že tento projekt uľahčí mnohým operátorom ich cesty za spojeniami z prírody. Ak hľadáte moderné, rýchle a spoľahlivé riešenie pre logovanie v teréne, ktoré bez problémov komunikuje s vaším domácim archívom spojení, CQRLOG for web jest rozwiązaniem, które nie powinno umknąć Twojej uwadze.