Hřiboradar

Appka pro houbaře v ČR - pravděpodobnost růstu konkrétních druhů hub na konkrétním místě, kombinující počasí, půdní vlhkost a druhovou skladbu lesa.

Struktura repa

• mobile/ - Expo (React Native + TypeScript) mobilní appka
• api/ - Vercel serverless funkce (backend)
• api/data/species.json - species-condition tabulka pro 15 klíčových druhů
• dev-server.mjs - lokální náhrada za vercel dev (viz níže)

Jsou to dva nezávislé projekty ve stejném repu. mobile/ má vlastní package.json, kořenový package.json je jen pro api/ (Vercel).

Backend

• GET /api/forecast?lat=&lon= - hlavní endpoint. Pro všech 15 druhů a pro každý den od včerejška do +6 dní dopředu spočítá pravděpodobnost růstu ze čtyř faktorů:

  • sezóna - season_months/season_peak_months v species.json, odvozené empiricky z GBIF pozorování pro ČR (ne odhad)
  • teplota - průměr posledních dní vs. temp_range_c druhu
  • dny od deště - najde poslední den s dostatečným srážkovým úhrnem a porovná s days_after_rain oknem druhu
  • vlhkost půdy - skutečné % vody v půdě z Open-Meteo (soil_moisture_3_to_9cm), ne odhad
  • shoda s lesem - dřeviny v okolí z OpenStreetMap/Overpass (kde je naimportovaná ÚHÚL typologie, čte se přímo; jinak hrubší jehličnatý/listnatý/smíšený) vs. host_trees druhu

  Sezóna a shoda s lesem fungují jako tvrdé brány (dubová houba ve smrkovém lese nebo mimo sezónu spadne skoro na nulu); teplota/déšť/vlhkost se váženě zprůměrují, aby "dobré, ale ne dokonalé" počasí nekolabovalo.

• GET /api/predict?lat=&lon= - starší/jednodušší endpoint, jen vlhkostní API30 index. forecast ho nahrazuje, zůstává pro referenci.

Co v modelu chybí

• pH půdy - VÚMOP/SOWAC-GIS nemá žádnou přímo dotazovatelnou pH vrstvu, jen odvozené charakteristiky (hloubka, skeletovitost, sklonitost, kód BPEJ). Reálné pH by šlo získat jen dekódováním BPEJ kódu přes tabulku hlavních půdních jednotek (HPJ) - to je samostatný výzkumný úkol.
• Grid pro celou mapu ČR - /api/forecast počítá jeden bod na dotaz. Na mapu s barevnými oblastmi po celé ČR potřeba buď grid předpočítaný cronem, nebo on-demand podle viditelného výřezu mapy.
• Konstanty (temp_range_c, days_after_rain, min_rain_mm) jsou zatím literatura-based odhady, ne kalibrované - časem doladit proti reálným NDOP/GBIF nálezům.

Vývoj

# 1) backend lokálně (z kořene repa) - plain Node server, ne Vercel CLI,
#    protože ta chce interaktivní `vercel login`
npm run dev:api          # http://localhost:3001

# 2) mobilní appka (v mobile/, v druhém terminálu)
cd mobile
npm run web              # nebo `npm start` pro Android/iOS/Expo Go

mobile/src/api.ts teď volá natvrdo http://localhost:3001 - až bude appka mluvit s reálným Vercel nasazením, tenhle base URL se přepne.

Nasazení

• Vercel: v nastavení projektu na vercel.com stačí připojit tenhle GitHub repo, Root Directory nechat na kořeni (Vercel si /api najde sám).
• Expo/EAS: cd mobile && npx eas build (potřebuje účet na expo.dev).

Externí závislosti (všechno zdarma, bez klíče)

• Open-Meteo - počasí + půdní vlhkost (CC BY 4.0, nutná atribuce)
• Overpass API (OpenStreetMap) - dřevinná skladba lesa. overpass.kumi.systems byl v testování nejspolehlivější; veřejné instance chtějí smysluplný User-Agent, jinak vrací 406/429. Pozor: tohle je pro prototypování v pořádku, ale pro produkční provoz s reálným provozem by to chtělo vlastní Overpass instanci nebo předpočítaný extrakt - veřejné instance nejsou spolehlivé pod zátěží.
• GBIF - použito jednorázově k odvození season_months v species.json (api/data/gbif_phenology_raw.json), za běhu appky se nevolá

Design systém (mobile/src/theme.ts)

Přestavěno 2026-08-05 podle explicitního product/design briefu. Jeden zdroj pravdy pro barvy/typografii/spacing/radius - obrazovky z něj čerpají, nevymýšlí si vlastní hex hodnoty ani odsazení.

• Barvy: papírové pozadí, lesní zelená (primary), mechová/olivová (secondary), zemitý terakotový akcent, tlumená červená (danger), přírodní zelená (success) - žádná čistá černá/bílá, ~8 barev
• Písmo: Fraunces (display/editorial) + Manrope (UI) - Nunito bylo nahrazeno, znělo moc "generic SaaS", ne editorial/field-guide
• Komponenty (mobile/src/components/): Card, PageHeader, SectionHeader, ProbabilityBadge, Chip, PrimaryButton, EmptyState, CardSkeleton, MushroomCard, LocationCard, WeatherSummary, IndexCard, LocationSheet (bottom sheet), BrandMark, BottomNav - postavené jednou, používané všude, ne po obrazovkách zvlášť
• Ikony: lucide-react-native - jedna konzistentní knihovna místo ručně kreslených SVG

Informační architektura

Spodní navigace: Domů / Mapa / Houby / Moje

• Domů - houbový index (agregát dnešních top-5 % s animovaným počítáním), "Kam dnes?" (reálně seřazený žebříček 8 skutečných mykologických oblastí ČR - Brdy, Šumava, Krkonoše, Jizerky, Beskydy, České Švýcarsko, Křivoklátsko, Žďárské vrchy - podle živě spočítané pravděpodobnosti, ne vymyšlená čísla), "Co roste dnes", skutečné počasí (teplota/vlhkost půdy/dny od deště)
• Mapa - reálný Leaflet, klepnutím na bod se otevře funkční bottom sheet (most Leaflet → postMessage → React Native/web) s houbovým indexem, top druhy a "proč"
• Houby - atlas všech 15 druhů
• Moje - uložená místa (zatím empty state, ukládání přijde s notifikacemi)

Stav

Funguje end-to-end, ověřeno v Expo web (tsc --noEmit čistý v mobile/ i v kořeni): všechny 4 obrazovky se přepínají a načítají reálná data, mapa s bottom sheetem otestována simulovaným kliknutím na marker.

Vědomě odloženo (viz brief - "nejde blindly following, preserve co je lepší"): search/filtry na mapě, notifikace, ukládání míst, verze pro tablet/desktop layout, víc než jemné animace (počítadlo indexu, pulse skeletony, spring na bottom sheetu).

Další logické kroky: pH půdy (nebo obejít bez něj), grid pro celou mapu ČR (teď jeden bod na dotaz), detail obrazovka druhu, nasazení na Vercel/EAS, fotky pro zbylých 5 druhů (rate limit na Wikimedia Commons zastavil dřívější batch).