DOKUMENTACIJA: KRITERIJI ZA DOLOČANJE PRIPOROČILA ZA LETENJE
===========================================================

1. NAMEN DOKUMENTA
------------------

Ta dokument opisuje logiko in kriterije, na podlagi katerih sistem izdela priporočilo za letenje z jadralnim padalom (paragliding) za posamezno vzletišče in posamezno uro.

Logika temelji na:
- konfiguraciji luftarWebConfig.json
- Node.js skripti za obdelavo Open-Meteo vremenskih podatkov 

Sistem predstavlja podporo pri odločanju. Končna odločitev o letenju je vedno odgovornost pilota.

---

2. MOŽNI REZULTATI PRESOJE
-------------------------

Za vsako uro in vzletišče sistem vrne:
DA  		- pogoji so primerni za letenje
POGOJNO 	- pogoji so mejni, potrebna je previdnost in izkušenost
NE  		- pogoji niso primerni za letenje
NEZNANO  	- ni dovolj podatkov za zanesljivo odločitev

Vsak rezultat ima tudi barvno oznako in razlago.

---

3. VHODNI PODATKI
----------------

3.1 Vzletišča (takeoffSites)  
Za vsako vzletišče so definirani:
- ID in ime lokacije  
- občina  
- nadmorska višina (amsl)  
- referenčni tlačni nivo (hPa)  
- geografska lega (lat, lon)  
- dovoljene smeri vetra:
  - opisno (SI: J, JZ, Z …)  
  - numerično (sektor min–max v stopinjah)  

Referenčni tlačni nivo določa, na kateri višini atmosferskega modela se preverjajo veter, temperatura in vlaga.

---

4. RAZREDI HITROSTI VETRA
------------------------
Hitrost vetra se razvrsti v razrede (m/s):

Razred        Hitrost      Pomen                Barva (UI)  
calm          0 – 1        skoraj brezvetrje     lightGreen  
light         1 – 3        šibak veter           green  
moderate      3 – 6        zmeren veter          darkGreen  
strong        6 – 7.5      močan veter           orange  
veryStrong    7.5 – 9      zelo močan veter      red  
dangerous     > 9          nevaren veter         darkviolet  

Razred vetra je ključen za končno odločitev.

---

5. DOLOČANJE SMERI VETRA
-----------------------

5.1 Pretvorba stopinj v smer  
Smer vetra (0–360°) se pretvori v eno izmed smeri:  
S, SV, V, JV, J, JZ, Z, SZ  

5.2 Preverjanje dovoljenosti  
Za vsako uro se preveri:  
- ali smer vetra leži znotraj dovoljenega sektorja vzletišča  

Rezultat: takeoffWindDirOk = true / false  

Če sektor ni definiran, se smer šteje kot dovoljena.

---

6. OSNOVNI VARNOSTNI KRITERIJI (IZLOČITVENI)
-------------------------------------------
Ti kriteriji imajo absolutno prednost. Če kateri ni izpolnjen, je rezultat vedno NE.

6.1 Dnevna svetloba  
- letenje je dovoljeno samo podnevi  
- nočni leti → NE

6.2 Vidljivost  
- minimalna vidljivost: več kot 2000 m  
- slabša vidljivost → NE

6.3 Padavine  
- dovoljeno:
  - padavine < 0.1 mm
  - verjetnost padavin < 30 %
- sicer → NE

---

7. PRESOJA VETRA NA VZLETIŠČU
----------------------------

Presoja se izvaja na referenčnem tlačnem nivoju vzletišča (hPa).

7.1 Neprimerna smer vetra  
- če smer NI dovoljena:
  - in je veter CALM → POGOJNO
  - sicer → NE  

Razlog: šibek veter z napačno smerjo je lahko še sprejemljiv, močnejši pa predstavlja tveganje.

7.2 Primerna smer vetra  
Če je smer dovoljena, odločitev temelji na hitrosti vetra:

calm        → DA  
light       → DA  
moderate    → DA  
strong      → POGOJNO  
veryStrong  → POGOJNO  
dangerous   → NE  

---

8. DIAGRAM ODLOČITVENEGA DREVESA
--------------------------------

START  
 |  
 |-- Je dan?  
 |     |-- NE  →  NE (nočni leti niso dovoljeni)  
 |     |-- DA  
 |  
 |-- Vidljivost > 2000 m?  
 |     |-- NE  →  NE (slaba vidljivost)  
 |     |-- DA  
 |  
 |-- Padavine < 0.1 mm in verjetnost < 30 %?  
 |     |-- NE  →  NE (padavine)  
 |     |-- DA  
 |  
 |-- Smer vetra dovoljena?  
 |     |-- NE  
 |     |     |-- Veter CALM? → POGOJNO  
 |     |     |-- Sicer       → NE  
 |     |  
 |     |-- DA  
 |           |-- calm        → DA  
 |           |-- light       → DA  
 |           |-- moderate    → DA  
 |           |-- strong      → POGOJNO  
 |           |-- veryStrong  → POGOJNO  
 |           |-- dangerous   → NE  

---

9. DODATNI IZRAČUNANI PODATKI (INFORMATIVNI)
--------------------------------------------
Sistem dodatno izračuna:  
- vremensko ikono (glede na kodo in dan/noč)  
- oblačnost po višinah  
- relativno vlažnost  
- sunke vetra in faktor sunkovitosti  
- LCL (višina kondenzacije)  
- višino mejne plasti  

Ti podatki niso namenjeni osnovni odločitvi, ampak služijo razširjeni analizi in prikazu uporabniku.  

---

10. KONČNA OPOMBA
----------------
Sistem LUFTAR je pripomoček za podporo odločanju.  
Ne nadomešča znanja, izkušenj in odgovornosti pilota.