Katalog /byliny a karta byliny — zadání první použitelné verze
Stav dokumentu: Hotovo — veřejná část (katalog
/byliny, detail byliny, filtrace včetně témat a vícenásobnéhopm, §7 UX, základní SEO meta) je dle tohoto dokumentu zapracovaná. Rozhraní editora do tohoto rozsahu nepatří — výhradně 32-admin.md a 24-engineering-roadmap.md Fáze 5.
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_notesnaherbs.
1.3 Geografický výskyt (§4.2 — základ)
- Evidence výskytu na úrovni vhodné pro tuto první iteraci: minimálně stát / region a typ prostředí (louka, les, zahrada…).
- V této fázi stačí globální / výchozí režim zobrazení (např. ČR + Evropa jako přednastavení), bez plného „profilu území“ uživatele — ten je v tasks/uzivatelsky-ucet.md §2.
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ě backlog nad rámec této první iterace; v aplikaci je nyní k dispozici
/zpracovanispolu s daty na kartě byliny a filtry v katalogu (pm). Viz tasks/done/zpracovani-a-recepty.md.
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+topicScopena/byliny, kde existují řádky vherb_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 této iterace)
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. Informační architektura
- Byliny (katalog + detail).
- Volitelně jedna vstupní landing stránka; sekce Symptomy / Profil / Herbář nejsou v původním výčtu této iterace.
(Rozšíření: základní výpis symptomů /symptomy a vazby je popsán v tasks/symptomy-a-temata.md.)
4. Mimo rozsah této iterace (řízeně přenechat dalším fázím)
- Samostatná databáze symptomů s procházením z symptomu na byliny → tasks/symptomy-a-temata.md (
/symptomyhotové). - Kalendář sběru na úvodní stránce → tasks/sezonnost-a-kalendar.md; uložené preference, oblíbené → tasks/uzivatelsky-ucet.md.
- Mapa → tasks/mapa-vyskytu.md; komunita → tasks/uzivatelsky-ucet.md §8; směsi → tasks/smesi-bylin.md.
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, kontrolu obsahu a budoucí zápis přes rozhraní editora (32-admin.md). Technický popis tabulek: 22-data-model.md. Stav zapracování jednotlivých druhů: 31-byliny.md.
Legenda rozsah: povinné = musí být vyplněno u referenčních bylin (akceptační kritérium); 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 | Rozsah |
|---|---|---|---|
| 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 další featury (lze je řadit do této iterace 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/topicpodle 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
pmv 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.xmlpro publikované byliny, dokumentaci a hlavní routy. -
robots.txt. - OG meta (sdílení) —
websiteSocialMetadoplňuje mimo jinéog:site_name; canonical na/bylinypodle aktuálního dotazu. - Jednotná hierarchie nadpisů (H1 nad stránkou, H2 nad blokem filtrů) a title/description pro
/bylinyvč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 této iterace): 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.