| [FORMATS.md](FORMATS.md) | `.hrz`, Stellarium spherical/polygonal pontos formátuma |
| [design/](design/) | Tokenek, képernyő-PNG-k (390×844 @2x), HTML forrás |
| [examples/](examples/) | Minta kimenetek és minta session; a core golden tesztjei ezekhez mérnek |
Ez a fájl csak a projekt-szintű döntéseket, az aktuális állapotot és a nyitott kérdéseket tartja nyilván.
## Döntések (változások a v1.0 spechez képest)
1.**Felvétel módja.** A célkeresztes kézi pontfelvétel helyett automatikus exponálás: 24 kép, 15°-onként, +10°-os dőlésnél, stabil tartásnál. Képenként ég/akadály-felismerés, a horizont az oszloponkénti legmagasabb nem-ég pixel. A kézi exponálás tartalékként megmarad.
2.**Észak.** Iránytű + deklináció (WMM, a magban) + a felhasználó kézi észak-eltolása a Review képernyőn. A Nap- vagy csillag-alapú igazítás **elvetve**; a pontatlanságot a biztonsági ráhagyás nyeli el (alapból +2°, 0–5°).
3.**Stellarium export.**`type = spherical`, 8192×2048-as sáv `maptex_top`/`maptex_bottom` értékekkel (nem teljes gömb). A kép bal széle Kelet (90°). Az észak-eltolás a képbe van beégetve, `angle_rotatez = 0`. Mellé jön a csak körvonalas `polygonal` változat is.
4.**Orientáció.** Hosszabb távon kvaternió (ENU). A jelenlegi kód alpha/beta/gamma forgatásmátrixa (`core/src/projection.rs`) már teljes 3D-s, a régi `beta − 90` képlet nincs használatban.
5.**Platform.** A webes UI fut böngészőben és az app WebView-jában is. A Flutter csak vékony natív héj (Android kész). Natív kamera-adapter csak akkor lesz, ha a webes korlátok (pl. expozíció-zár) miatt muszáj. A v1.0 flutter_rust_bridge-terve ezzel **kikerült**.
6.**Fejlesztési mód.** A telefonon felvett session (`session.json` + `sensors.jsonl` + képkockák) asztali böngészőben és unit tesztekben visszajátszható. A felismerés és a varrás finomhangolása így telepítés nélkül megy.
7.**Név és azonosító** (2026-10-24): az app neve **SkyContour** (a „Horizon(s)” név mindkét áruházban túlzsúfolt, és két közvetlen iOS-versenytárs is használja). App-azonosító: Android `com.sagifer.skycontour`, iOS `com.sagifer.skycontour.ios` (a sima azonosítót egy korábbi ingyenes Personal Team-es telepítés lefoglalta). iOS-aláírás: egyéni fejlesztői fiók, Team ID `8EQZ487TY9`. A kódnév (sfzenith) belül marad: Dart-csomag, Rust crate, tárolókulcsok.
- **FOV-források sorrendje**: mért (élő kalibráció két átfedő képből, már működik) → eszköztábla → kézi → alapérték. A forrás a sessionben `device.camera.fovSource` néven tárolódik.
- **Secure origin**: kamera és szenzor csak HTTPS vagy `localhost` alól érhető el. Fejlesztéshez marad a `wasm/serve.py` / Vite basic-ssl; a natív héj `http://localhost:47391`-et szolgál ki (lib/local_server.dart). A port a tárolási origin része: a helyszínek a localStorage/IndexedDB-ben ehhez kötődnek, kiadás után nem szabad változtatni.
-`skymask`: ég/akadály-maszk a varrt sávon (ég-növesztés a fotók tetejéről, illesztési varratok és lebegő „felhők” kiszűrése), ecsetes javítások, ebből a horizontprofil, a lefedettség és a top-touch jelzés.
-`projection`, `fov`: a korábbi wasm crate-ből átköltöztetve.
- Golden tesztek: a kimenet bájtra egyezik a `docs/examples/` fájljaival.
-`wasm/`: vékony wasm-bindgen adapter (kamera, canvas, szenzorok) és a core exportjainak JS-felülete (`export_hrz`, `parse_hrz`, `export_stellarium_spherical`, `export_stellarium_polygonal`, `landscape_ini`, `profile_from_points`, …).
-`wasm/frontend/`: az új UI mind az 5 képernyővel a design tokenekkel, plusz Settings (FOV, szerző) és FOV-kalibráló képernyő.
- Capture: célzópont, automatikus exponálás, 24 cellás haladásjelző a varrt sávból, visszavonás, „Add higher shot”, ébren tartott képernyő.
- Flutter iOS-héj: engedély-szövegek, álló tájolás, iOS 15+, mentés a Fájlok appba (natív csatorna), telepítés: `scripts/install_ios.sh`.
- Flutter Android-héj (`lib/main.dart`): WebView, kamera- és helyengedély, GPS a WebView-nak, mentés a Letöltések mappába (natív csatorna), megosztás (share_plus), álló tájolás, a rendszersávok mellett marad (SafeArea), a Vissza gomb a webes navigációt lépteti. Emulátoron (Pixel 9a, Android 16) végigpróbálva.
- Többnyelvűség: a felület a rendszer nyelvét követi (angol, spanyol, arab – jobbról balra –, német, magyar, lengyel, francia, olasz, szlovák), a Settingsben kézzel is választható; a natív tab bar és az iOS-engedélyszövegek is fordítva. Az exportált fájlok angolok maradnak.
- Közös natív szolgáltatások mindkét héjban: képernyő ébren tartása felvétel közben (wakelock_plus), rezgés exponáláskor, app-ikon (A · Skyline) és natív nyitókép.
**Még nincs**
- Képenkénti ég-felismerés és élő égvonal a kameraképen: most a felismerés a kész, varrt sávon fut.
- Varrás erősítés-kiegyenlítéssel (a mostani sáv vetítés alapú, „utolsó nyer”).
- Dőlés (roll) ellenőrzése az automatikus exponálásnál.
| 6 | Fordítások (en, es, ar, de, hu, pl, fr, it, sk – kész), polírozás (az iOS-héj előrehozva, kész) | |
## Nyitott kérdések
- **Stellarium zip telepítés**: a zip egy almappában (`<id>/landscape.ini`) tartalmazza a fájlokat. Egyszer ki kell próbálni a Stellarium „Add/remove landscapes” telepítőjével.
- **NINA**: el kell fogadnia a `# Az Alt` fejlécet és a `.` tizedesjelet nem angol nyelvű Windowson is. Kiadás előtt egyszer tesztelni kell.
- **Panoráma memória**: a 8192×2048-as RGBA kép ~64 MB a wasm memóriában. Gyenge telefonon kellhet egy 4096×1024-es opció (az exporter már paraméterezhető).