MVP2 — Zadání: symptomy, témata a hlubší filtrace

Stav dokumentu: Částečně — veřejná část MVP2 je z větší části hotová: /zpracovani, /symptomy, /sezona, /region, na /byliny fungují topic + topicScope, pm (více hodnot = OR), region, měsíc sběru a základní filtry podle evidence na kartě (science, spiritual); viz 23-api-and-routes.md §4. Zbývá především: jednotné štítky tvrzení v celém UI (§1.5), případné rozšíření link_type v datech a sjednocení karty byliny; jemnější práh „síly důkazu“ v katalogu dle potřeby obsahu.

Cíl fáze: zavést strukturu symptomů, nemocí, psychických stavů a témat (§7), vazby na byliny s rozlišením typu použití (tradiční / spirituální / vědecké / kulinárie / kosmetika / aromaterapie), rozšířit filtrování (§10) a katalog způsobů zpracování jako samostatnou prohlídku (§8).

Vstup: 11-roadmap.md · předpoklad dokončeného 12-mvp-1.md.


1. Rozsah funkcí

1.1 Symptomy a témata (§7)

  • Katalog entit: fyzické symptomy, psychické a emoční stavy, spirituální / symbolická témata.
  • Stránka / sekce „Symptomy a témata“: výpis a detail s navázanými bylinami (/symptomy, /symptomy/:slug). Vyhledávání v rámci výpisu zatím ne (plán).

1.2 Vazba bylina ↔ symptom/téma

  • Při vazbě v herb_topic_links je uložen link_type; v aplikaci a dotazech katalogu se dnes používají hodnoty typu traditional, spiritual, scientific (zobrazování na /symptomy/:slug, filtr topicScope na /byliny).
  • Plné pokrytí všech kategorií z §7.2 (kulinářské / kosmetika / aromaterapie / …) — rozšíření schématu nebo obsahu + jednotné štítky / přepínače na kartě byliny (sjednotit dle obsahu).
  • Umožní dotazy typu: „byliny na spánek podle tradice“ vs „se studiemi“ — v /byliny přes topic + topicScope (viz 23-api-and-routes.md); rozšíření na další typy link_type a bohatší obsah může zbývat.

1.3 Rozšířené filtry (§10.2–10.5 — podmnožina)

  • Fyzický symptom, psychický stav, spirituální téma — v katalogu jako jeden filtr topic (slug z topics) + topicScope; stejné entity jako /symptomy/:slug.
  • Filtry podle typu důkazu na kartě (§10.3 — základ): parametry science (silnější scientific_evidence vs. bez ní) a spiritual (publikované spiritual_uses) na /byliny, kombinovatelné s ostatními filtry; viz 23-api-and-routes.md §4. Jemnější práh podle konkrétní síly / typu studie může následovat.
  • Filtry podle způsobu zpracování (čaj, tinktura, mast…)
  • Sezónní filtry základní: měsíc sběru v katalogu; přehledové stránky /sezona a /sezona/:month (stejná logika jako ?month=). Dedikovaný „kalendář“ s uživatelským uložením spíš MVP4.

1.4 Způsoby zpracování — samostatná část (§8)

  • Prohlížecí databáze způsobů s popisem (např. rozdíl čaj vs odvar).
  • Odkaz z způsobu na byliny, kde je způsob relevantní.

Stav v aplikaci (hotovo): veřejné routy /zpracovani (seznam) a /zpracovani/:slug (detail z processing_methods, navázané publikované byliny a odkaz na /byliny?pm=…). Na kartě byliny se u každé vazby zobrazuje krátký i volitelně plný popis metody a odkaz na detail způsobu. Katalog slugů je sladěn s výčtem v 10-product-spec.md §7 (migrace 0009_processing_methods_product_spec.sql); delší encyklopedické texty zatím typicky jen u původních pěti metod z 0008_processing_method_encyclopedia.sql. Sitemap zahrnuje /zpracovani a jednotlivé slugy metod.

1.5 Štítky tvrzení (§12 — pro konzistenci UI)

  • Jednotné označení u záznamů: vědecky doložené, částečně, tradiční, spirituální, pověra, historická zmínka, symbolika, komunitní zkušenost, nedostatek důkazů — použít tam, kde to dává smysl u existujících dat.

2. IA (rozšíření oproti MVP1)

  • Symptomy a témata (nová hlavní sekce).
  • Způsoby zpracování — v aplikaci položka „Zpracování“ v hlavičce → /zpracovani (dříve jen plánovaná podsekce).
  • Sběr podle sezóny — v hlavičce „Sezóna“ → /sezona, /sezona/:month (odkaz na ekvivalentní filtr v /byliny).
  • Regiony výskytu — v hlavičce „Regiony“ → /region, /region/:slug (odkaz na ekvivalentní filtr v /byliny).

3. Mimo rozsah MVP2

  • Uživatelský profil a personalizaceMVP3.
  • Osobní herbář, kalendář jako uživatelský nástroj → MVP3 / MVP4.

4. Akceptace

  • Z detailu symptomu/tématu dojdu k relevantním bylinám s viditelným typem vazby (link_type na /symptomy/:slug; sjednocení štítků napříč celým UI může zbývat)
  • V katalogu /byliny lze kombinovat region (území z MVP1), téma (topic) a zúžení typu vazby (topicScope), spolu s month, pm, science a spiritual; viz 23-api-and-routes.md §4. Jemnější práh síly důkazu (např. min. „moderate“) může následovat.
  • Katalog způsobů zpracování je dohledatelný a propojený s bylinami (splněno — viz §1.4 výše).

5. Doporučená priorita další práce (uzávěr MVP2)

Pořadí je návrh pro nejrychlejší dopad při stávající DB; lze měnit podle obsahového plánu.

PořadíOblastProč
1§1.5 Štítky tvrzení — jednotné označení tam, kde už data typ/sílu mají (spirituální záznamy, vědecké řádky, vazba téma–bylina)Sjednocuje důvěru a čitelnost bez nutnosti nových tabulek; přímo navazuje na princip „uživatel ví typ zdroje“.
2§1.3 Filtry typu důkazu — na /byliny parametry science / spiritual (základ hotový); další rozšíření (min. síla, typ studie jako filtr) podle obsahuZáklad splňuje §10.3 pro kombinaci s katalogem; jemnější práh až po validaci dat.
3§1.2 Rozšíření link_type a karty byliny pro další kategorie (kulináře, kosmetika…)Až je jasné, které kategorie chcete skutečně evidovat v obsahu.
4Vyhledávání v rámci /symptomy (§1.1)UX vylepšení, neblokuje akceptované filtry v katalogu.