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.md16-mvp-5.md. Technický postup implementace (infra → vyhledávání) je v 24-engineering-roadmap.md. Obsahové zásady: 30-content-guidelines.md.

OtázkaKde 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:

  1. Databáze bylin — veřejný katalog a detail (/byliny, migrace + seed)
  2. Symptomy / témata — základní prohlížení (/symptomy, /symptomy/:slug) a vazby v D1; rozšířená filtrace v katalogu dle 13-mvp-2.md
  3. Způsoby zpracování — tabulka processing_methods, /zpracovani, filtr pm na katalogu
  4. Tradiční / spirituální vrstva — obsah na kartě (spiritual_uses); samostatná „encyklopedie“ nad rámec karty dle priorit obsahu
  5. Vědecká vrstva — scientific_evidence na kartě se zdroji (metadata DOI/autorů viz 30-content-guidelines.md §8)
  6. Obrazová knihovna — galerie na kartě; plná správa/upload (admin, R2) rozpracovaná
  7. Filtrace dle plné vize §4 — základ + téma / topicScope v katalogu hotové; typ důkazu / síla v katalogu postupně (MVP2+)
  8. 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 /symptomy a detail; na /byliny filtry topic a topicScope (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