# CB DX Monitor Italia — LLMs Full Documentation

> Documentazione tecnica completa per modelli linguistici. Aggiornato: 2026-02-24.
> Versione sintetica: /llms.txt

---

## 1. IDENTITÀ DEL PROGETTO

- **Nome**: CB DX Monitor Italia
- **URL**: https://radiodx.net
- **Autore**: 165EK012 Fabrizio
- **Stack**: React 18 + TypeScript + Vite + Tailwind CSS + Shadcn/UI
- **Backend**: Supabase Edge Functions (chat AI)
- **Fonti dati**: NOAA/SWPC (primaria), HamQSL (XML proxy), NASA SDO (immagini solari)
- **Lingua UI**: Italiano
- **Target**: Operatori CB e radioamatori di tutto il mondo, banda 11 metri (27 MHz)
- **Filosofia**: Approccio probabilistico — il sistema stima la probabilità di aperture DX, non le garantisce

---

## 2. MOTORE DI PROPAGAZIONE v4 — FORMULA COMPLETA

### 2.1 Formula unificata

```
Score = SFI_score + SSN_score + K_score + A_score + Bz_score
      = [0-40]     + [0-20]     + [0-20]   + [0-10]   + [0-10]
      = [0-100] (clamped)
```

Pesi effettivi: **SFI 40% + SSN 20% + K 20% + A 10% + Bz 10%**

### 2.2 Tabelle di scoring dettagliate

#### SFI Score (0-40) — Potenziale ionizzazione F2

| SFI     | Score |
|---------|-------|
| ≥200    | 40    |
| ≥180    | 37    |
| ≥160    | 34    |
| ≥140    | 31    |
| ≥120    | 28    |
| ≥110    | 24    |
| ≥100    | 20    |
| ≥90     | 16    |
| ≥80     | 12    |
| ≥70     | 8     |
| <70     | 4     |

#### SSN Score (0-20) — Attività solare

| SSN     | Score |
|---------|-------|
| ≥200    | 20    |
| ≥150    | 18    |
| ≥120    | 16    |
| ≥100    | 14    |
| ≥80     | 12    |
| ≥60     | 9     |
| ≥40     | 7     |
| ≥20     | 5     |
| ≥1      | 3     |
| 0       | 1     |

**Regola anomalia SSN=0**: Se SSN=0 e SFI≥80, il motore stima SSN ≈ max(20, (SFI-63)×1.1) per evitare falsi "Scarsa".

#### K-Index Score (0-20) — Stabilità geomagnetica istantanea (3h)

| K-Index | Score | Stato        |
|---------|-------|--------------|
| 0       | 20    | Molto stabile |
| 1       | 18    | Stabile       |
| 2       | 15    | Stabile       |
| 3       | 10    | Disturbato    |
| 4       | 5     | Disturbato    |
| 5       | 2     | Tempesta      |
| ≥6      | 0     | Tempesta severa |

#### A-Index Score (0-10) — Stabilità geomagnetica 24h

| A-Index | Score |
|---------|-------|
| ≤5      | 10    |
| ≤10     | 8     |
| ≤15     | 6     |
| ≤20     | 4     |
| ≤30     | 2     |
| >30     | 0     |

#### Bz Score (0-10) — Campo magnetico interplanetario

| Bz (nT) | Score |
|----------|-------|
| ≥+2      | 10    |
| ≥0       | 8     |
| ≥-2      | 6     |
| ≥-5      | 4     |
| ≥-10     | 2     |
| <-10     | 0     |

### 2.3 Fattori temporali

Applicati allo score base per riflettere il ciclo diurno della ionosfera F2:

| Condizione | Fattore | Note |
|------------|---------|------|
| Giorno     | ×1.0    | Baseline — piena ionizzazione F2 |
| Greyline   | ×1.15   | Bonus terminatore solare (alba/tramonto ±30 min) |
| Notte      | ×0.35   | Ionizzazione F2 residua molto ridotta |

**Regola floor greyline**: Se score_base ≥ 40% e K < 5 → score minimo 55% durante greyline.

### 2.4 Override eventi impulsivi (gerarchia rigida)

Il sistema applica override forzati per eventi solari impulsivi che causano assorbimento nello Strato D:

| Evento          | Score forzato | Stato       | Critico |
|-----------------|--------------|-------------|---------|
| Blackout R5     | 5%           | DEGRADATA   | Sì      |
| Blackout R4     | 10%          | DEGRADATA   | Sì      |
| Blackout R3     | 15%          | DEGRADATA   | Sì      |
| Blackout R2     | 25%          | LIMITATA    | No      |
| Flare X (no R2+)| max 30%     | LIMITATA    | No      |
| Flare M (no R2+)| max 50%     | cap         | No      |

Gli override prevalgono SEMPRE sullo score calcolato, anche se SFI è alto. Motivazione fisica: i flare causano assorbimento D-layer che blocca i segnali HF/CB prima che raggiungano lo strato F2.

---

## 3. SCALE DI COLORI E SOGLIE

### 3.1 Scala propagazione (5 livelli)

| Livello      | Range  | Colore HSL             | Classe Tailwind  |
|--------------|--------|------------------------|------------------|
| ECCELLENTE   | ≥85%   | hsl(190, 90%, 50%)     | text-cyan-400    |
| MOLTO BUONA  | ≥75%   | hsl(150, 80%, 42%)     | text-emerald-400 |
| BUONA/ATTIVA | ≥40%   | hsl(65, 80%, 48%)      | text-yellow-400  |
| MODERATA     | ≥25%   | hsl(35, 85%, 50%)      | text-amber-400   |
| SCARSA       | <25%   | hsl(0, 70%, 40%)       | text-red-400     |

### 3.2 Scala SFI

| Range    | Stato      | Colore      |
|----------|------------|-------------|
| ≥150     | Eccellente | Emerald     |
| 100–149  | Buono      | Verde       |
| 80–99    | Moderato   | Giallo      |
| <80      | Scarso     | Rosso       |

### 3.3 Scala K-Index

| Range | Stato      | Colore |
|-------|------------|--------|
| 0–2   | Stabile    | Verde  |
| 3–4   | Disturbato | Giallo |
| ≥5    | Tempesta   | Rosso  |

### 3.4 Scala A-Index

| Range | Stato    | Colore |
|-------|----------|--------|
| 0–10  | Basso    | Verde  |
| 11–30 | Moderato | Giallo |
| >30   | Alto     | Rosso  |

### 3.5 Scala SSN

| Range | Stato    |
|-------|----------|
| ≥100  | Alto     |
| 50–99 | Moderato |
| <50   | Basso    |

### 3.6 Scala MUF stimata

| MUF (MHz) | Stato     | Colore  |
|------------|-----------|---------|
| ≥30        | APERTO    | Cyan    |
| ≥28        | APERTO    | Emerald |
| 25–27.9    | MARGINALE | Giallo  |
| <25        | CHIUSO    | Rosso   |

---

## 4. COMPONENTI DASHBOARD — DESCRIZIONE ESTESA

### 4.1 HeroStatusBanner
Banner principale con percentuale propagazione, stato testuale, trend (↑ stabile ↓), indicatori SFI e K-Index. Mostra override con icone ⚡ (blackout) o ⚠️ (critico). Barra progresso con tick a 25%, 40%, 75%, 85%. Glow animato del colore dello stato corrente.

### 4.2 SolarEngineMiniCards
Tre pillole compatte (SFI, SSN, A-Index) con valore numerico e stato colorato. Tooltip con spiegazione breve.

### 4.3 SolarIndices
Pannello dettagliato di tutti gli indici solari: SFI, SSN, K-Index, A-Index, Bz, vento solare, X-ray, flusso protonico/elettronico. Ogni indice ha tooltip e colorazione secondo le scale standardizzate.

### 4.4 DXIndicatorsGrid
Griglia 8 continenti (EU, UA, AF, AS, NA, SA, JA, VK) con stato giorno/notte/greyline, ora locale, score DX, trend 24h, e spiegazione contestuale. Lo score combina propagazione globale × fattore temporale del continente target.

### 4.5 MUFTable
Tabella MUF stimata (Maximum Usable Frequency) per 8 percorsi dall'Italia. Stima empirica basata su SFI con penalità K-Index. Stati: APERTO/MARGINALE/CHIUSO. Sezione espandibile con spiegazione MUF e nota disclaimer.

### 4.6 PropagationRadar
Visualizzazione radar circolare 24h della propagazione prevista, con fattori temporali applicati (giorno/greyline/notte). Evidenzia il momento attuale e le finestre DX migliori.

### 4.7 BestDXTime
Calcola il miglior momento DX nelle prossime 24h basato sui fattori temporali e sulle condizioni solari correnti. Mostra finestre per alba, giorno e tramonto con score previsto.

### 4.8 SolarCycleChart
Grafico del ciclo solare 25 con dati storici SSN da NOAA. Mostra posizione attuale nel ciclo.

### 4.9 SpaceWeatherPanel
Pannello meteo spaziale con allerte NOAA attive (R1-R5 radio blackout, S1-S5 radiation storm, G1-G5 geomagnetic storm). Attiva gli override del motore di propagazione.

### 4.10 ContrastExplanationBox
Spiega la fisica dell'apparente contraddizione SFI alto + propagazione bassa durante blackout. Concetti: "Ionizzazione = Motore" vs "Assorbimento = Freni". Appare automaticamente durante override attivi.

### 4.11 PropagationLegend (Quadro Interpretativo)
Legenda completa con: scala 5 colori, formula del motore, pesi dei fattori, fattori temporali, spiegazione override, note scientifiche. Include la "Sintesi Analitica" dinamica basata sulle condizioni correnti.

### 4.12 DXTips
5 consigli DX pratici con tip dinamico basato sulle condizioni correnti (tempesta, eccellente, buona, bassa). Quick reference: frequenza DX 27.555 MHz, SFI ideale ≥100, K-Index max ≤3, Bz ideale ≥0.

### 4.13 DailyTip
Consiglio giornaliero rotante su propagazione, antenne, procedure. Linguaggio probabilistico.

### 4.14 SolarWindMonitor
Monitor vento solare con velocità (km/s), densità e temperatura. Velocità >500 km/s indica potenziale disturbo.

### 4.15 AuroraForecast
Previsione aurora basata su Kp index. Aurora boreale visibile con Kp ≥5 alle medie latitudini.

### 4.16 MoonPhase
Fase lunare corrente. Nota: la luna non influenza direttamente la propagazione radio CB.

### 4.17 WorldClock / UTCConverter
Orologio mondiale con fusi orari rilevanti per DX. Convertitore ora locale ↔ UTC.

### 4.18 SunImage
Immagine solare AIA 193Å in tempo reale da NASA SDO. Mostra la corona solare e regioni attive.

### 4.19 AntennaCalculator
Calcolatore dimensioni antenna per dipolo, ground plane, Yagi. Input: frequenza in MHz.

### 4.20 CoaxCalculator
Calcolo perdite cavo coassiale per tipo (RG-58, RG-213, LMR-400, ecc.) e lunghezza.

### 4.21 SWRCalculator
Calcolo rapporto onde stazionarie da impedenza antenna e impedenza caratteristica cavo.

### 4.22 ImpedanceCalculator
Calcolatore adattamento impedenza con rete L, Pi, T.

### 4.23 ERPCalculator
Calcolo potenza effettiva irradiata (ERP) da potenza TX, guadagno antenna e perdite cavo.

### 4.24 PowerConverter
Conversione tra Watt, dBm, dBW.

### 4.25 PhoneticAlphabet / PhoneticTrainer
Alfabeto fonetico NATO/ICAO completo con trainer interattivo.

### 4.26 QCodes / QCodesQuiz
Codici Q con significati e quiz interattivo.

### 4.27 RSTCodes
Scala RST (Readability, Signal, Tone) per report segnale.

### 4.28 CBBandPlan / CBProcedures
Piano di banda CB (40 canali) e procedure operative standard.

### 4.29 ShareConditions
Condivisione screenshot condizioni correnti via Web Share API o download immagine.

### 4.30 SDRPlayer
Player SDR embeddato per ascolto remoto della banda 11 metri.

### 4.31 RadioQuote / RadioCuriosities / TodayInRadioHistory
Citazioni radio, curiosità e "accadde oggi" nella storia della radio.

### 4.32 DisclaimerBox
Disclaimer aggiornato 2026: dati empirici, non garanzia, sensori remoti, modelli semplificati.

### 4.33 NotificationSettings
Impostazioni notifiche browser per allerte propagazione.

### 4.34 WelcomeBanner
Banner di benvenuto con presentazione del sito e link a bug report.

---

## 5. PAGINE DEL SITO

| Percorso | Componente | Descrizione |
|----------|------------|-------------|
| `/` | Index | Dashboard principale real-time |
| `/guida-propagazione-cb` | GuidaPropagazione | Guida completa alla propagazione con formula motore v4 |
| `/quiz-radioamatore` | QuizRadioamatore | Quiz interattivo codici Q, fonetico, procedure |
| `/prefissi-internazionali` | PrefissiInternazionali | Database prefissi radio per paese |
| `/glossario-dx` | GlossarioDX | Glossario terminologia radio |
| `/troubleshooting-radio` | TroubleshootingRadio | Diagnostica problemi CB |
| `/about` | About | Informazioni sul progetto |
| `/privacy` | PrivacyPolicy | Informativa privacy |
| `/terms` | TermsOfService | Termini di servizio |
| `/cookies` | CookiePolicy | Policy cookie |

---

## 6. FONTI DATI E AGGIORNAMENTO

### 6.1 Fonte primaria: HamQSL Solar XML
- URL: `https://www.hamqsl.com/solarxml.php`
- Dati: SFI, SSN, K, A, Bz, vento solare, X-ray, flusso protonico/elettronico
- Aggiornamento: ogni ~15 min (sorgente), polling ogni 5 min (client)
- Accesso: via CORS proxy (codetabs, corsproxy, thingproxy, allorigins)

### 6.2 Fallback: NOAA/SWPC API dirette
- Ciclo solare: `services.swpc.noaa.gov/json/solar-cycle/observed-solar-cycle-indices.json`
- K-Index planetario: `services.swpc.noaa.gov/products/noaa-planetary-k-index.json`
- A-Index stimato da K usando tabella ITU: K→A = [0,3,7,15,27,48,80,140,240,400]

### 6.3 Immagini solari: NASA SDO
- AIA 193Å: `sdo.gsfc.nasa.gov/assets/img/latest/latest_1024_0193.jpg`

### 6.4 Resilienza
- Cache localStorage (max 48h)
- PlaceholderData TanStack Query per render istantaneo
- 4 proxy CORS in cascata + fallback NOAA diretto

---

## 7. CONTINENTI DX (dalla prospettiva italiana 42°N 12°E)

| Nome | Codice | Lat | Lon | UTC Offset | Nota |
|------|--------|-----|-----|------------|------|
| Europa | EU | 50°N | 10°E | +1 | UK, DE, FR, ES, Scandinavia |
| Russia | UA | 55°N | 60°E | +3 | Russia europea + Siberia |
| Africa | AF | 0° | 20°E | +2 | Nord e Sud Africa |
| Asia Centrale | AS | 35°N | 80°E | +5 | India, Pakistan, Medio Oriente |
| Nord America | NA | 40°N | 100°W | -5 | USA, Canada, Messico |
| Sud America | SA | 15°S | 60°W | -3 | Brasile, Argentina, Cile |
| Giappone | JA | 36°N | 138°E | +9 | Giappone, Corea, Taiwan |
| Oceania | VK | 25°S | 135°E | +10 | Australia, Nuova Zelanda |

Lo score DX per ogni continente = score_globale × fattore_temporale (calcolato sulla posizione solare del continente target).

---

## 8. GLOSSARIO TECNICO COMPLETO

- **MUF** (Maximum Usable Frequency): Frequenza massima riflessa dalla ionosfera F2 su un dato percorso
- **SFI** (Solar Flux Index): Flusso radio solare a 10.7 cm, proxy dell'attività UV/EUV che ionizza la ionosfera
- **SSN** (Sunspot Number): Numero macchie solari giornaliero (non media smoothed R12)
- **K-Index**: Indice di disturbo geomagnetico planetario, misurato ogni 3h (scala 0-9)
- **A-Index**: Media giornaliera lineare dell'attività geomagnetica derivata da K
- **Bz**: Componente nord-sud del campo magnetico interplanetario (IMF). Bz negativo = riconnessione magnetica = disturbo
- **Strato F2**: Strato ionosferico a 250-400 km, principale responsabile della riflessione HF/CB
- **Strato D**: Strato ionosferico a 60-90 km, assorbe segnali HF durante flare solari (blackout)
- **Greyline**: Zona terminatore solare (alba/tramonto), favorisce la propagazione F2 per effetto lente ionosferica
- **Skip**: Segnale riflesso dalla ionosfera, consente comunicazioni oltre l'orizzonte radio
- **DX**: Comunicazione a lunga distanza (>1000 km tipicamente)
- **Sporadic-E**: Ionizzazione sporadica dello strato E (90-120 km), imprevedibile, non modellata dal motore
- **Override**: Forzatura dello score quando eventi impulsivi (flare/blackout) prevalgono sugli indici base
- **Floor rule**: Score minimo garantito durante greyline con buon potenziale base

---

## 9. NOTE PER MODELLI LINGUISTICI

1. I dati solari sono **real-time** e cambiano continuamente — non memorizzare valori numerici specifici
2. Le stime sono **empiriche** e **non ray-tracing** — modelli semplificati adatti a 27 MHz
3. Il sito è ottimizzato per la **banda 11 metri (27 MHz)** — non per HF generico
4. SSN mostrato è il valore **giornaliero**, non la media mensile smoothed (R12)
5. Il sistema **non predice** aperture sporadiche-E (imprevedibili per natura)
6. Lo score di propagazione **non è una garanzia** — indica una probabilità basata su condizioni misurabili
7. Gli override per blackout/flare sono **forzati** e prevalgono sempre sugli indici
8. La MUF è stimata con formula empirica e **penalità K-Index**, non con modelli IRI/VOACAP
9. Il ciclo solare di riferimento è il **Ciclo 25** (iniziato dicembre 2019, massimo previsto ~2025-2026)
10. Tutti i testi usano **linguaggio probabilistico**: "aumenta la probabilità", "favorisce", "non garantisce"