Mapa výskytu — průřezové zadání

Stav dokumentu: Plán — funkcionalita zatím nezapracovaná; rozcestník regionů (/region, /region/:slug) plní část role „kde bylina roste" v textovém režimu.

Cíl: popsat geografickou vrstvu produktu — vizualizaci výskytu bylin na mapě (regiony / biotopy / zjednodušené polygonové vrstvy), propojení karty byliny ↔ mapa, a vazby na filtrování podle regionu / prostředí.

Vstup: 10-product-spec.md §4 · 22-data-model.md (herb_regions, případně budoucí herb_environments) · 23-api-and-routes.md §1 (/region).

Tematický (feature-based) dokument napříč všemi vývojovými fázemi. Uživatelské vlastní lokality / poznámky na mapě jsou v uzivatelsky-ucet.md §8.

1. Stav v aplikaci (k datu údržby)

  • Tabulka regions + vazba herb_regions (kde bylina roste).
  • /region — seznam regionů s počty publikovaných bylin.
  • /region/:slug — detail regionu se seznamem bylin, stejná logika jako /byliny?region=<slug>.
  • V hlavičce: položka „Regiony".
  • Filtr region v /byliny.
  • Mapová vizualizace — zatím není.

2. Plán mapové vrstvy

2.1 Datová strana

  • Volba úrovně podrobnosti podle dostupnosti dat a licence:
    • A) Region-based — barevně zvýrazněné regiony (existující regions + herb_regions); minimální nároky na geodata.
    • B) Biotop-based — pole „typ prostředí" (les, louka, břeh vody, skály, …) s tabulkou herb_environments (návrh).
    • C) Polygonová vrstva — zjednodušené polygony výskytu (vyžaduje GIS data; pozor na licenci, např. AOPK ČR / OSM).
  • Datová licence — vždy uvádět zdroj.

2.2 UI / UX

  • /mapa — hlavní mapová stránka (přehled).
  • /mapa/:bylina-slug — mapa konkrétní byliny (alternativně blok na kartě byliny).
  • Propojení z karty byliny na mapu a zpět.
  • Legenda + filtrování (region, prostředí, sezóna jako vrstvy mapy).
  • Mobile UX — mapa s rozumnou výchozí pozicí pro ČR.

2.3 Performance

  • Tile / vector tile přístup (např. Cloudflare R2 + statické MBTiles nebo PMTiles), aby se neposílaly těžké geo soubory na klienta.
  • KV cache pro agregované výskyty (vazba na 24-engineering-roadmap.md Fáze 7).

3. Vztah k filtrům

  • Filtr region v /byliny se sjednotí s filtrem mapy (vazba na filtrace-a-vyhledavani-katalogu.md).
  • Filtr environment (prostředí) — společný pro mapu i /byliny.
  • Filtr country — pro mapu a katalog.
  • Souběh sezóna + mapa: vrstva „co kvete v dubnu v ČR" (vazba na sezonnost-a-kalendar.md).

4. Plánovaná vylepšení

  • Vrstvy biotopů (les, louka, voda, skály, ruderál) jako separátní volitelná vrstva.
  • Tepelné mapy podle hustoty publikovaných bylin v regionu.
  • Plánovač trasy — vybrat několik bylin a vidět, kde je možné je společně najít (v rámci jednoho regionu / biotopu).
  • Export do GPX vybraných míst (pro uživatele s vlastními lokalitami — vazba na uzivatelsky-ucet.md §8).

5. Akceptace

  • Z /region/:slug je dostupný seznam bylin pro daný region.
  • Mapová vrstva je prokazatelně použitelná pro cílové území projektu (minimálně ČR).
  • Karta byliny obsahuje odkaz na mapu výskytu.

6. Vazby na jiné dokumenty