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, admin a rozšířené filtrace dle §4 zůstávají backlog.
Tento soubor je stručné jednostránkové shrnutí produktu (sekce 1–8 níže). Funkci rozcestníku mezi produktovými fázemi plní 11-roadmap.md; detailní scope jednotlivých dodávek je v 12-mvp-1.md … 16-mvp-5.md. 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é produktové MVP1–MVP5? | 11-roadmap.md + mvp-*.md. |
| V jakém pořadí stavět repo (Workers, D1, admin…)? | 24-engineering-roadmap.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) - Symptomy / témata — základní prohlížení (
/symptomy,/symptomy/:slug) a vazby v D1; rozšířená filtrace v katalogu dle 13-mvp-2.md - Způsoby zpracování — tabulka
processing_methods,/zpracovani, filtrpmna katalogu - Tradiční / spirituální vrstva — obsah na kartě (
spiritual_uses); samostatná „encyklopedie“ nad rámec karty dle priorit obsahu - Vědecká vrstva —
scientific_evidencena kartě se zdroji (metadata DOI/autorů viz 30-content-guidelines.md §8) - Obrazová knihovna — galerie na kartě; plná správa/upload (admin, R2) rozpracovaná
- Filtrace dle plné vize §4 — základ + téma /
topicScopev katalogu hotové; typ důkazu / síla v katalogu postupně (MVP2+) - Profil a preference — MVP3+
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 13-mvp-2.md, 23-api-and-routes.md §4) - nemoci (mapování na entity závisí na obsahu)
- 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 (plná vize §10 — část v MVP2 přes
topicScope; filtry síly / „má studie“ viz 13-mvp-2.md §1.3) - bezpečnostní úrovně
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, 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. MVP
Bližší produktový rozpad první použitelné verze a návazných MVP viz 12-mvp-1.md a tabulka 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 MVP1)
- bezpečnostní upozornění
- admin pro správu obsahu