fix: the bugs and vulnerabilities SonarCloud reports on PR #216

pr-reviews/PR-227.md

@@ -0,0 +1,15 @@
+# Review PR #227 — simulationenvironment: Adjust turbidity values
+
+Autor: @dos1 · base: `master` · 1 plik, +6/−6
+https://github.com/MaSzyna-EU07/maszyna/pull/227
+
+**Werdykt: Approve po uzupełnieniu opisu**
+
+## Podsumowanie
+Zmiana mapowania zachmurzenia (`Global.Overcast`) na mętność atmosfery (`fTurbidity`): minimum 3 → 4 (bo 3 psuje model w nocy) i wyższe wartości w środkowym/wysokim zakresie.
+
+## Uwagi
+1. **Pierwsze dwa progi są teraz identyczne** (`<= 0.10 ? 4` i `<= 0.20 ? 4`), podobnie `0.30/0.40 → 5`, `0.50/0.60 → 6` i `0.90/else → 9`. Drabinka 10 zagnieżdżonych `?:` z powtórzonymi wartościami to dobry moment, żeby ją uprościć — np. tablica `std::array` progów albo krótka funkcja. Przy okazji zniknie zgłoszenie Sonara S3358 (zagnieżdżony operator `?:`), które i tak dotyczy zmienianych linii.
+2. **„Turbidity 3 breaks the model at night”** — warto w opisie dodać 1–2 zdania, *jak* się psuje (NaN? czarne/świecące niebo?) i ewentualnie zrzut ekranu. Jeśli problem jest w samym modelu Preetham (znane ograniczenie dla T < ~2–3 przy słońcu pod horyzontem), lepszym miejscem na poprawkę może być clamp w modelu nieba, a nie w mapowaniu pogody — wtedy wartość 3 zostałaby dostępna w dzień.
+3. **Zmiana wyglądu istniejących scenerii** — przy bezchmurnej pogodzie niebo będzie bardziej mgliste niż dotąd. To uzasadniona poprawka, ale wg `CLAUDE.md` należy to wprost opisać w PR (najlepiej porównanie przed/po dla 0.0, 0.5 i 0.9 overcast, dzień i noc).
+4. Do przetestowania razem z #228 (sRGB) i #230 (rozmiar Słońca/Księżyca) — wszystkie trzy zmieniają odbiór nieba.