Türk Röle Exporter

Türkiye amatör telsiz röle verilerini cihazına özel CSV formatına dönüştüren web uygulaması. Filtrele, harita üzerinde gör, telsizine yükle.

İçindekiler

• Ne işe yarar?
• Canlı versiyon
• Veri kaynakları
• Mimari
• Proje yapısı
• Geliştirme
• Veri güncelleme script'leri
• Ziyaretçi istatistikleri
• Deploy
• Test
• Lisans ve katkı

Ne işe yarar?

CHIRP / üretici CPS yazılımıyla uyumlu CSV üretir. Şu cihazlar için hazır profil var:

• Quansheng UV-K5 (F4HWN v4.3 firmware)
• Quansheng UV-K5 v3 / UV-K1 (F4HWN v5.3.1 firmware, 1000 kanal)
• Baofeng K5 Plus
• OpenGD77 (Radioddity GD-77, TYT MD-380, Baofeng DM-1801, Radioddity RD-5R)
• TYT MD-UV390 Plus
• TYT MD-UV390 (GPS'siz)

Temel özellikler:

• TA bölgesi, şehir, ilçe, bant (VHF/UHF), mod (analog/dijital), aktiflik, lisans, QRZ skoruna göre filtre
• Ek kanallar: PMR, dPMR, FM Radyo, FM simplex, dijital simplex (kanal-kanal seçilebilir)
• Leaflet harita, sürüklenebilir röle pinleri
• Önizleme tablosu, hücre editi, undo/redo, arama
• Önayar (preset) kaydetme/yükleme (v2 şema: airband/marine seçimleri dahil)
• 4 tema seçici (Pure Dark, Navy, Kömür, Açık) — sağ alt köşede FAB
• Mevcut CSV'yi içe aktarıp birleştirme, JSON export, RX-only mod, boş kanal eklenmesi

Korunan kanallar (parola gerektirir)

Parola arkasında 4 grup — tek parola ile dördü birden açılır:

• Airband — il → havalimanı → tür (ATIS / Tower / Ground / Approach / Clearance / Departure / Ramp / Center / …) kademeli seçim. ~65 TR havalimanı, ~180 frekans; OurAirports.com CC0 dataset'inden otomatik çekilir.
• Marine — 3 bölüm akordiyon: VHF Marine Band (ta1dx canlı scrape, ~60 kanal), SAR Frekansları, Türk Sahil Radyoları. Her bölüm içinde frekans başına checkbox + "Hepsi / Hiçbiri" kısayolu ve [tikli/toplam] sayaç.
• PMR + dPMR — PMR446 analog ve dijital kanallar. Kilit açıldıktan sonra RX-only alt seçimi serbest çalışır.

Canlı versiyon

Statik site docs/ klasöründen GitHub Pages üzerinden yayınlanır:

• Site: http://kaandikec.com/turk-role-exporter/
• Hakkında: /hakkinda.html (README'den otomatik üretilir)
• Repo: dikeckaan/turk-role-exporter
• Worker API: https://telsizrole.kaandikec.com

Veri kaynakları

Mimari

                       ┌─────────────────────────────────────┐
                       │           Tarayıcı                  │
                       │   docs/ (vanilla ES modules)        │
                       └────────────────┬────────────────────┘
                                        │ fetch
                                        ▼
                       ┌─────────────────────────────────────┐
                       │     Cloudflare Worker               │
                       │     telsizrole.kaandikec.com        │
                       │     worker/index.js                 │
                       │  ┌────────┬──────────┬───────────┐  │
                       │  │ proxy  │ scrapers │ stats KV  │  │
                       │  └────────┴──────────┴───────────┘  │
                       └─────┬─────────┬─────────┬───────────┘
                             │         │         │
                             ▼         ▼         ▼
            amatortelsizcilik.com.tr  ta-role.com  ta1dx.qsl.net
             + (gömülü fallback-data.js: röle, airband, marine snapshot)

Frontend (docs/) — vanilla ES modules, statik. Önemli dosyalar:

Backend (worker/) — Cloudflare Worker:

API endpoint'leri

Proje yapısı

.
├── docs/                      # Statik frontend (GitHub Pages)
│   ├── index.html
│   ├── hakkinda.html          # README'den üretilir
│   ├── css/style.css
│   ├── js/                    # ES modules — yukarıdaki tabloya bakın
│   └── sw.js                  # Service worker (offline cache)
├── worker/
│   ├── index.js               # Cloudflare Worker
│   ├── fallback-data.js       # Airband + Marine gömülü snapshot
│   ├── scrapers.js            # HTML parsers
│   ├── stats.js               # KV istatistik endpoint'leri
│   └── SCRAPER-NOTES.md
├── scripts/
│   ├── update-fallback.js     # backup.json → docs/js/fallback-data.js
│   ├── update-airband.js      # OurAirports.com → worker/fallback-data.js
│   └── build-hakkinda.js      # README.md → docs/hakkinda.html
├── tests/                     # node --test
│   ├── airband.test.js
│   ├── marine.test.js
│   ├── csv.test.js
│   ├── filtreler.test.js
│   ├── utils.test.js
│   ├── scrapers.test.js
│   ├── protected-unlock.test.js
│   └── fixtures/              # scraper test fixtures
├── docs/superpowers/          # Design spec + implementation plan
├── backup.json                # (opsiyonel) en son röle data.json snapshot'ı
├── wrangler.toml              # KV binding + site bucket
└── package.json

Geliştirme

Gereksinimler: Node.js 20+, npm, Wrangler CLI.

Kurulum:

npm install

Air/Marine/PMR parolasını yerelde test etmek için repo köküne .dev.vars:

PROTECTED_PASSWORD=secret-değerin

Komutlar:

Veri güncelleme script'leri

Röle verisi (npm run update-fallback)

amatortelsizcilik.com.tr /roleler/data.json endpoint'i login gerektirdiği için CF Worker anonim olarak 500 alıyor. Röle verisi gömülü docs/js/fallback-data.js'ten geliyor ve elle yenilenmesi gerek:

1. Tarayıcıda amatortelsizcilik.com.tr'ye giriş yap
2. https://amatortelsizcilik.com.tr/roleler/data.json URL'sini aç → JSON çıktısını olduğu gibi kaydet
3. Repo köküne backup.json olarak yapıştır
4. npm run update-fallback
5. Üretilen docs/js/fallback-data.js'i commit'le

Airband verisi (npm run update-airband)

OurAirports.com'un açık (CC0) CSV dataset'inden TR havalimanları + VHF airband frekansları (108-137 MHz) çekilir, ISO 3166-2:TR plaka kodlarına göre illere göre gruplanır, worker/fallback-data.js'teki AIRBAND_FALLBACK'i günceller. Script internet erişimi gerektirir, sonra commit + npm run deploy.

Hakkında sayfası (npm run build-hakkinda)

README.md → docs/hakkinda.html. README'yi her güncellediğinizde çalıştırın; dosyayı commit edin.

Ziyaretçi istatistikleri

Ana sayfada ve hakkında sayfasında "Ziyaretçi İstatistikleri" kartı: çalışma süresi, toplam/bugün ziyaretçi, "Sen N. ziyaretçisin", toplam/bugün indirme, cihaza göre indirme dağılımı (yatay bar).

Gizlilik: Hiçbir PII saklanmaz — IP, user-agent, referrer, fingerprint hiçbiri yok. Ziyaret kimliği yalnızca tarayıcı sessionStorage flag'iyle belirlenir; session başına 1 ping. CSV indirmesinde recordDownload(cihazId) fire-and-forget POST atar.

Depolama: Cloudflare KV namespace STATS. Anahtarlar:

• site:firstLaunch — ilk ziyaretin ISO tarihi
• site:visits:total, site:visits:day:YYYY-MM-DD
• site:downloads:total, site:downloads:day:YYYY-MM-DD, site:downloads:device:<cihaz>

KV namespace bir kereliğine oluşturulur:

npx wrangler kv namespace create STATS

Dönen id'yi wrangler.toml'daki [[kv_namespaces]] bloğuna yapıştır.

Deploy

Frontend: Herhangi bir branch'e push → GitHub Actions (.github/workflows/deploy-pages.yml) otomatik olarak docs/'u GitHub Pages'e deploy eder.

Worker:

npm run deploy

Production parola sırrı:

wrangler secret put PROTECTED_PASSWORD

CI'da: GitHub secret PROTECTED_PASSWORD deploy workflow'una env olarak geçirilir.

Test

npm test

Mevcut suite'ler (56 test):

• tests/airband.test.js — seçim filtresi, dedup, preset roundtrip
• tests/marine.test.js — 3-bölüm seçim semantiği
• tests/csv.test.js — CSV format + seçim-temelli airband/marine export
• tests/scrapers.test.js — ta1dx parser + fallback merge + fallback shape
• tests/protected-unlock.test.js — 4 grubun protected-group class'ı + *-unlocked wrapper invariant
• tests/filtreler.test.js — filtre mantığı
• tests/utils.test.js — Türkçe normalizasyon, bant tespiti, TX hesabı, puanlama

Lisans ve katkı

Repo'da LICENSE dosyası yok; lisans henüz belirtilmemiştir. OurAirports verisi CC0, ta1dx içeriği qsl.net kullanım şartlarına tabidir — canlı scraping ilgili sitelerin ToS'una saygılı cache süreleriyle (4 saat) yapılır.

Katkı için:

1. Branch aç
2. Değişikliklerini yap
3. npm run lint && npm test geçtiğinden emin ol
4. README'yi etkileyen değişiklikler için npm run build-hakkinda
5. PR aç