Produktové zadání: Databáze bylin, jejich využití, sběru a zpracování
Stav dokumentu: Částečně — produktová vize a struktura sekcí jsou ustavené; část modulů z §2 a položek §8 už běží v aplikaci; rozšířené filtrace dle §4 zůstávají backlog. Správa obsahu (chráněné rozhraní editora) je evidovaná výhradně v 32-admin.md.
Tento soubor je stručné jednostránkové shrnutí produktu (sekce 1–8 níže). Funkci rozcestníku mezi featurami plní 11-roadmap.md; detailní scope jednotlivých featur je v tematických dokumentech (tasks/symptomy-a-temata.md, tasks/done/filtrace-a-vyhledavani-katalogu.md, tasks/done/zpracovani-a-recepty.md, tasks/done/sezonnost-a-kalendar.md, tasks/done/stitky-tvrzeni-a-typy-dukazu.md, tasks/done/spiritualni-a-ritualni-obsah.md, tasks/mapa-vyskytu.md, tasks/smesi-bylin.md, tasks/doporuceni.md, tasks/uzivatelsky-ucet.md) a v 12-katalog-a-karta-byliny.md (první uzavřená iterace). Technický postup implementace (infra → vyhledávání) je v 24-engineering-roadmap.md. Obsahové zásady: 30-content-guidelines.md.
| Otázka | Kde je odpověď |
|---|---|
| Co má umět produkt v jedné stránce? | Tento dokument (§1–§7), checklist první verze (§8). |
| Jak jsou rozdělené featury produktu? | 11-roadmap.md (mapa featur) + jednotlivé tematické dokumenty. |
| V jakém pořadí stavět repo (Workers, D1, editor…)? | 24-engineering-roadmap.md; rozhraní editora 32-admin.md. |
1. Vize projektu
Cílem projektu je vytvořit přehlednou, důvěryhodně strukturovanou a dobře filtrovatelnou databázi bylin, která propojí praktické informace o výskytu, sběru, skladování a zpracování bylin s jejich tradičním, spirituálním a vědecky doloženým využitím.
Projekt má sloužit jako kombinace:
- atlasu bylin
- praktického průvodce sběrem a zpracováním
- katalogu tradičních a „babských“ znalostí
- databáze vědecky podložených účinků
- inspiračního nástroje pro práci s bylinami podle symptomů, psychických stavů, rituálů, sezóny, místa výskytu nebo způsobu použití
Důležité je jasně oddělit tradiční / spirituální informace od vědecky ověřených informací, aby uživatel vždy věděl, z jakého typu zdroje dané tvrzení pochází.
2. Hlavní části produktu
Produkt bude stát na těchto modulech:
- Databáze bylin — veřejný katalog a detail (
/byliny, migrace + seed; 12-katalog-a-karta-byliny.md) - Symptomy / témata — viz tasks/symptomy-a-temata.md
- Způsoby zpracování — viz tasks/done/zpracovani-a-recepty.md (katalog metod, editorské recepty)
- Spirituální a rituální obsah — viz tasks/done/spiritualni-a-ritualni-obsah.md
- Vědecká vrstva se štítky důkazů — viz tasks/vedecke-dukazy-a-studie.md §1–2
- Obrazová knihovna — galerie na kartě; plná správa/upload (R2 + editor — 32-admin.md) rozpracovaná
- Filtrace a vyhledávání v katalogu — viz tasks/done/filtrace-a-vyhledavani-katalogu.md
- Sezónnost a kalendář — viz tasks/done/sezonnost-a-kalendar.md
- Mapa výskytu — viz tasks/mapa-vyskytu.md
- Směsi bylin — viz tasks/smesi-bylin.md
- Doporučení (engine) — viz tasks/doporuceni.md
- Profil, preference a uživatelský účet — viz tasks/uzivatelsky-ucet.md
3. Karta byliny
Každá bylina bude mít vlastní detailní profil.
Obsah:
- lokální název
- alternativní lokální názvy
- latinský název
- čeleď
- typ rostliny
- stručný popis
- hlavní charakteristika
- podobné byliny
- možné záměny
- upozornění na rizikové záměny
- geografický výskyt
- období sběru podle částí rostliny
- skladování
- způsoby zpracování
- spirituální / tradiční využití
- vědecké využití se zdroji
- bezpečnostní upozornění
- obrázky
4. Filtrace
Uživatel musí být schopen filtrovat podle:
- názvu
- latinského názvu
- regionu
- země (nad rámec regionálního modelu — závisí na datech)
- typu prostředí
- období sběru
- části rostliny (v plánu / část dat v DB)
- způsobu zpracování
- symptomu / tématu — sekce
/symptomya detail; na/bylinyfiltrytopicatopicScope(viz tasks/symptomy-a-temata.md, tasks/filtry-katalogu-bylin.md §1, tasks/done/filtrace-a-vyhledavani-katalogu.md, 23-api-and-routes.md §4) - nemoci (mapování na entity závisí na obsahu — tasks/symptomy-a-temata.md §5)
- psychického stavu (část témat v
/symptomy; hlubší struktura v datech) - spirituálního / tradičního tématu — stejné entity jako symptomy; v katalogu lze kombinovat s regionem, měsícem a zpracováním
- typu důkazu —
science,scienceMin,studyType(viz tasks/filtry-katalogu-bylin.md §1, tasks/vedecke-dukazy-a-studie.md §1) - bezpečnostní úrovně —
safety(viz tasks/bezpecnost-a-media-stitky.md §2)
5. Spirituální a tradiční využití
Tato část bude obsahovat informace vycházející z tradic, lidového léčitelství, starých herbářů, mytologie, symboliky a rituálního použití.
Každé tvrzení musí být jasně označené jako:
- tradice
- pověra
- historická zmínka
- symbolika
- komunitní zkušenost
- osobní zkušenost
6. Vědecké využití
Vědecká část bude obsahovat pouze tvrzení opřená o zdroje.
Každé vědecké tvrzení musí obsahovat:
- bylinu
- část rostliny
- symptom / téma
- shrnutí tvrzení
- typ studie
- sílu důkazu
- zdroj
- DOI nebo URL
- rok publikace
- omezení studie
7. Způsoby zpracování
Projekt bude mít samostatnou databázi způsobů zpracování:
- čaj / nálev
- odvar
- macerát za studena
- tinktura
- glycerit
- bylinný olej
- mast
- balzám
- sirup
- bylinný med
- bylinný ocet
- bylinné víno
- bylinný likér
- vykuřovadlo
- bylinný svazek
- koupel
- obklad
- inhalace
- prášek
- kapsle
- esence
- hydrolát
- esenciální olej
- fermentace
- kulinářské použití
Katalog v D1: výše uvedené položky odpovídají řádkům tabulky processing_methods (slug je identifikátor ve filtru /byliny?pm= i na /zpracovani/:slug). Základní pět řádků založila migrace 0002_mvp1_extensions.sql (historický filename — přepis schématu při první iteraci katalogu), delší encyklopedické texty u nich migrace 0008_processing_method_encyclopedia.sql, doplnění zbytku výčtu podle této sekce migrace 0009_processing_methods_product_spec.sql. U nově přidaných metod je zatím typicky jen short_description; full_description a pole obtížnosti lze doplňovat postupně. Přehled slugů a mapování na názvy viz 22-data-model.md §8.
Poznámka: v datech je navíc slug salat (syrová úprava) jako konkrétní forma kulinářského/syrového použití; obecná kategorie „kulinářské použití“ má slug kulinarske.
8. První použitelná verze (checklist)
Bližší produktový rozpad viz 12-katalog-a-karta-byliny.md; navazující featury jsou v tematických dokumentech (mapa featur v 11-roadmap.md). Sekce níže zůstává jako stručný checklist.
První verze má obsahovat:
- katalog bylin
- detail byliny
- základní filtry
- způsoby zpracování (včetně
/zpracovani) - spirituální použití (na kartě)
- vědecké použití se zdroji (na kartě)
- obrázky (minimum — viz 12-katalog-a-karta-byliny.md §1.9)
- bezpečnostní upozornění
- správa obsahu — 32-admin.md