MVP1 — Zadání: první použitelná verze

Stav dokumentu: Hotovo — veřejná část MVP1 (katalog /byliny, detail byliny, filtrace včetně témat a vícenásobného pm, §7 UX, základní SEO meta) je dle tohoto dokumentu zapracovaná. Admin / CMS nepatří do MVP1 a řeší se v dalších fázích (23-api-and-routes.md §2, 24-engineering-roadmap.md).

Cíl fáze: nasadit prohlížečný katalog bylin s důvěryhodnou kartou byliny, kde jsou praktické údaje (výskyt, sběr, skladování, zpracování) vedle oddělených bloků tradičního/spirituálního a vědeckého využití, se základní filtrací, obrázky a bezpečnostními informacemi.

Vstup z roadmapy: 11-roadmap.md

1. Rozsah funkcí (must-have)

1.1 Katalog bylin

Seznam bylin s vyhledáváním podle názvu (český / alternativní / latinský).
Přechod na detail byliny.

1.2 Detail byliny — identifikace (náhled na §4.1 původního zadání)

Lokální název, alternativní názvy, latinský název, čeleď, typ rostliny (kategorie).
Stručný popis, hlavní charakteristika.
Podobné byliny — navázané publikované byliny přes tabulku herb_similar (volitelná poznámka u vazby); mapování polí viz §6.
Možné záměny, upozornění na rizikové záměny — texty identification_notes, confusion_risk_notes na herbs.

1.3 Geografický výskyt (§4.2 — základ)

Evidence výskytu na úrovni vhodné pro MVP1: minimálně stát / region a typ prostředí (louka, les, zahrada…).
Pro MVP1 stačí globální / výchozí režim zobrazení (např. ČR + Evropa jako přednastavení), bez plného „profilu území“ uživatele — ten je ve MVP3.

1.4 Sběr (§4.3)

U každé byliny: sbíraná část, měsíce / období, stručné poznámky (ideální fáze, počasí volitelně).
Forma tabulky nebo strukturovaných záznamů.

1.5 Skladování (§4.4)

Doporučené metody (sušení, tinktura, med, chlad… dle databáze).
U každé metody kde má smysl: orientační trvanlivost, citlivost na světlo/vlhkost, základní bezpečnostní upozornění.

1.6 Způsoby zpracování (§8 — jádro pro kartu)

U byliny uvedeno, které způsoby zpracování jsou vhodné (čaj, odvar, tinktura, mast, sirup, koupel, vykuřovadlo… — podmnožina podle obsahu).
Struktura typu: bylina × způsob × vhodnost × část rostliny × tradiční ano/ne × vědecky podloženo ano/ne × bezpečnostní poznámka.
Samostatná prohlížečná sekce „Způsoby zpracování“ byla původně plánována až do MVP2; v aplikaci je nyní k dispozici /zpracovani spolu s daty na kartě byliny a filtry v katalogu (pm). Viz 13-mvp-2.md §1.4.

1.7 Tradiční / spirituální využití (§5)

Každý záznam označen jako tradiční / spirituální / nevědecký.
Minimální struktura záznamu: název použití, kategorie (ochrana, očista, spánek…), popis, forma (čaj, koupel…), volitelně síla tvrzení (tradice / historická zmínka / symbolika…), zdroj (textově).

1.8 Vědecké využití (§6)

Oddělená sekce od tradiční.
Každé tvrzení: vazba na bylinu, část rostliny, oblast/symptom, shrnutí, typ důkazu (viz §6.2 — alespoň hrubé členění), odkaz na zdroj, rok, poznámka k omezením.

1.9 Obrázky (§9 — minimum)

Minimálně jeden identifikační typ (celková rostlina nebo detail listu/květu).
Optimalizace formátu a výkonu webu.

1.10 Základní filtrace (§10 — podmnožina)

Název / latinsky / část země / období sběru / způsob zpracování.
Rozlišení tradiční vs vědecké vazby u témat v katalogu (topic + topicScope na /byliny, kde existují řádky v herb_topic_links).

Stav v aplikaci: katalog /byliny podporuje vyhledávání (q), region (region), měsíc sběru (month), způsob zpracování (pm — opakovatelný parametr, OR), téma (topic = topics.slug) a rozsah typu vazby (topicScope = all | tradition | science). Témata a symptomy jsou dál procházejí na /symptomy a /symptomy/:slug. Přehled sezóny a regionů: /sezona, /region. Ukázkové vědecké vazby v migracích 0012_herb_topic_scientific_link_sample.sql, 0013_herb_topic_scientific_expand.sql.

1.11 Bezpečnost (§13)

Položky dle priority: jedovatost, záměna, těhotenství/kojení/děti, alergie, základní úroveň bezpečnosti (např. tabulka z §13.2).
Interakce s léky a fotosenzitivita — pole připravit, vyplnit tam, kde je obsah k dispozici.

Implementace v DB/UI: strukturované řádky safety_warnings (typ, závažnost, titulek, popis, volitelný zdroj) + orientační herbs.safety_level v hlavičce karty. Doplňkové volné textové poznámky herbs.drug_interactions_note a herbs.phototoxicity_note pro souhrnné upozornění (např. u třezalky); prázdné = sekce se na webu nezobrazí. Mapování viz §6.

2. Datové entity (minimum MVP1)

Bylina, Část rostliny, Lokalita (zjednodušeně), Období sběru, Způsob zpracování (katalog + vazba na byl), Spirituální použití, Vědecké tvrzení, Zdroj studie, Obrázek, Bezpečnostní upozornění.

3. IA (MVP1)

Byliny (katalog + detail).
Volitelně jedna vstupní landing stránka; sekce Symptomy / Profil / Herbář nejsou v původním výčtu MVP1.

(Rozšíření: základní výpis symptomů /symptomy je popsán v 13-mvp-2.md.)

4. Mimo rozsah MVP1 (řízeně přenechat dalším fázím)

Samostatná databáze symptomů s procházením z symptomu na byliny → MVP2 (základ /symptomy rozšiřuje 13-mvp-2.md).
Kalendář sběru na úvodní stránce, uložené preference, oblíbené → MVP3 / MVP4.
Mapa, komunita, směsi → MVP5.

5. Akceptace (shrnutí)

Uživatel najde bylinu podle názvu nebo hrubého filtru a na detailu vidí jasné oddělení tradice a vědy.
U vědeckých tvrzení je zdroj (odkaz nebo citace).
U byliny jsou bezpečnostní informace a záměny tam, kde jsou relevantní.
Základní galerie obrázků funguje.

6. Šablona pole karty byliny (DB ↔ UI)

Tato tabulka je jednotný referenční přehled pro seed, migrace, admin/CMS a kontrolu obsahu. Technický popis tabulek: 22-data-model.md. Stav zapracování jednotlivých druhů: 31-byliny.md.

Legenda MVP1: povinné = musí být vyplněno u referenčních bylin (akceptace MVP1); volitelné = může zůstat prázdné; podmíněné = zobrazí se jen při datech.

Blok na webu (detail)	Pole / vazba	Tabulka · sloupce / vazba	MVP1
Název (H1)	Lokální název	`herbs.local_name`	povinné
Latinský název		`herbs.latin_name`	povinné
Další názvy	Alternativy	`herb_names.name`, `language`, `type`	volitelné
Úvodní text	Stručný + plný popis	`herbs.short_description`, `herbs.full_description`	stručný povinný; plný volitelný
Čeleď, typ rostliny		`herbs.family`, `herbs.plant_type`	volitelné (doporučené)
Úroveň bezpečnosti (orientačně)	Souhrnný stupeň	`herbs.safety_level`	doporučené
Identifikace	Poznámky k určení	`herbs.identification_notes`	volitelné
Záměny	Rizika záměny	`herbs.confusion_risk_notes`	podmíněné (doplnit u rizikových druhů)
Podobné byliny	Odkazy + poznámka u vazby	`herb_similar` → `herbs` (`related_herb_id`, `note`, `sort_order`)	volitelné
Léky / fotosenzitivita	Souhrnné texty	`herbs.drug_interactions_note`, `herbs.phototoxicity_note`	volitelné
Výskyt	Region, stav, poznámky	`herb_regions` + `regions`	podmíněné
Sběr	Část, měsíce, region, poznámky, sezóna	`harvest_periods` + `plant_parts`, `regions`	podmíněné
Skladování	Metoda, část, trvanlivost, světlo/vlhkost, pozn. bezpečnosti	`herb_storage` + `storage_methods`, `plant_parts`	podmíněné
Způsoby zpracování	Metoda, část, vhodnost, tradiční/vědecké, poznámka	`herb_processing_methods` + `processing_methods`	podmíněné
Spirituální / tradiční	Název, kategorie, popis, forma, síla tvrzení, typ tvrzení (`claim_nature`), štítky (`facets`), zdroj	`spiritual_uses` (`is_published`)	podmíněné
Vědecká tvrzení	Shrnutí, úroveň důkazu, typ studie, zdroj (URL/titul), DOI, autoři, časopis, rok, omezení, forma, účinná látka, pozn. k dávce (informativně)	`scientific_evidence` (`is_published`)	podmíněné; u vědy zdroj doporučen vždy, kde jde
Obrázky	URL nebo R2, alt, titulek, typ	`images.public_url` / `images.r2_key`, `alt_text`, `caption`, `image_type`	podmíněné (min. jeden identifikační u referenčních bylin)
Bezpečnostní upozornění	Typ, závažnost, titulek, popis, zdroj	`safety_warnings`	podmíněné

Katalog /byliny: řádky s herbs.is_published = 1; filtry q, month, region, pm, topic, topicScope — viz 23-api-and-routes.md.

Migrace související s touto šablonou: 0001–0006 základ + R2 smoke; 0007_herb_similar_and_safety_notes.sql — herb_similar, sloupce drug_interactions_note / phototoxicity_note na herbs, ukázkový seed vazeb a text u třezalky; 0010_spiritual_nature_facets.sql — spiritual_uses.claim_nature, facets (30-content-guidelines.md §8.1–8.2); 0011_herb_topic_links_seed.sql + 0012_herb_topic_scientific_link_sample.sql + 0013_herb_topic_scientific_expand.sql — témata a typy vazeb včetně ukázek scientific.

7. UX katalogu `/byliny` a detailu byliny (doporučení)

Cíl: rychle zvednout použitelnost katalogu, čitelnost „co tu najdu“ a připravit základ pro SEO a obsahové škálování. Níže jsou vylepření, která nejsou vázaná na MVP2+ (lze je řadit do MVP1 jako UX vrstva nad existujícími daty a filtry).

7.1 „První dojem“ nad seznamem

Krátké vysvětlení jak katalog používat + 2–3 věty s příklady dotazů (např. hledání česky i latinsky; filtrování podle měsíce sběru a způsobu použití).
Rychlé zástupce (chips) na jeden klik pro typické záměry — přednastavení stávajících filtrů / vyhledávání, např.: „Na čaj“, „Tinktura“, „Jarní sběr“, „Stres — vědecká vazba“ (mapování na month / pm / topic podle obsahu DB).
Okamžitý tip (~10 min): nad filtry jedna věta „Tip:“ + 2 konkrétní příklady hledání (např. „heřmánek“, „Melissa officinalis“).

7.2 Filtry — drobnosti s velkým dopadem

Stavové shrnutí typu „Zobrazuji X z Y“ (po aplikaci filtrů a vyhledávání).
Tlačítko Vyčistit filtry (reset q, month, region, pm, topic, topicScope).
U filtru Měsíc sběru doplnit krátký mikrotext, že jde o zahrnutí období podle dat sběru v kartě (uživatel často přehlédne meta popis stránky).
Způsob zpracování: více hodnot pm v dotazu (OR) + zaškrtávání v UI na /byliny; multi-select ve smyslu „čaj i tinktura jako jeden filtr“ je tím pokrytý.

7.3 Karty v seznamu — „decision friendly“

Kromě názvu, latiny a krátké věty doplnit na kartě dva rozhodovací mikro-atributy:

Sběr: kompaktní období z agregace harvest_periods (římské měsíce, např. „VI–VIII“).
Použití: až 2 názvy způsobů z herb_processing_methods (řazeno podle záznamu v datech).

7.4 Detail byliny — vrstvy v UI

Oddělení v duchu 30-content-guidelines.md: na detailu dva jasně označené bloky nebo záložky — Tradiční / spirituální (explicitní label) a Vědecké poznatky (včetně zdrojů u tvrzení).
Bezpečnost vždy viditelně nahoře na kartě (kontraindikace, záměny, děti, těhotenství, odkazy na strukturovaná upozornění).

7.5 SEO — „low hanging fruit“

Patří technicky do 24-engineering-roadmap.md — Fáze 6, ale doporučená priorita je brzká: po zveřejnění rout začíná indexace.

sitemap.xml pro publikované byliny, dokumentaci a hlavní routy.
robots.txt.
OG meta (sdílení) — websiteSocialMeta doplňuje mimo jiné og:site_name; canonical na /byliny podle aktuálního dotazu.
Jednotná hierarchie nadpisů (H1 nad stránkou, H2 nad blokem filtrů) a title/description pro /byliny včetně počtu výsledků — detail byliny dle stávajících rout.

7.6 Doporučené pořadí práce (orientační)

Nejlepší next step (cca 1–2 dny):

Nad seznam krátký onboarding + rychlé chips (přednastavené filtry / dotazy).
Do filtrů „Zobrazuji X/Y“ + „Vyčistit filtry“.
Upravit karty: „Sběr“ + „Zpracování“ z dat.

Volitelné další kroky (nad rámec MVP1): rozšířené chips podle obsahu; doladění canonical strategie pro /byliny s query; kontinuální doplňování herb_topic_links a obsahu dle 31-byliny.md.