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/bylinyfungují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_typev 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_linksje uloženlink_type; v aplikaci a dotazech katalogu se dnes používají hodnoty typutraditional,spiritual,scientific(zobrazování na/symptomy/:slug, filtrtopicScopena/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
/bylinypřestopic+topicScope(viz 23-api-and-routes.md); rozšíření na další typylink_typea 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 ztopics) +topicScope; stejné entity jako/symptomy/:slug. - Filtry podle typu důkazu na kartě (§10.3 — základ): parametry
science(silnějšíscientific_evidencevs. bez ní) aspiritual(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
/sezonaa/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 personalizace → MVP3.
- 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_typena/symptomy/:slug; sjednocení štítků napříč celým UI může zbývat) - V katalogu
/bylinylze kombinovat region (území z MVP1), téma (topic) a zúžení typu vazby (topicScope), spolu smonth,pm,scienceaspiritual; 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í | Oblast | Proč |
|---|---|---|
| 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 obsahu | Zá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. |
| 4 | Vyhledávání v rámci /symptomy (§1.1) | UX vylepšení, neblokuje akceptované filtry v katalogu. |