Skip to content

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

  1. Databáze bylin — veřejný katalog a detail (/byliny, migrace + seed; 12-katalog-a-karta-byliny.md)
  2. Symptomy / témata — viz tasks/symptomy-a-temata.md
  3. Způsoby zpracování — viz tasks/done/zpracovani-a-recepty.md (katalog metod, editorské recepty)
  4. Spirituální a rituální obsah — viz tasks/done/spiritualni-a-ritualni-obsah.md
  5. Vědecká vrstva se štítky důkazů — viz tasks/vedecke-dukazy-a-studie.md §1–2
  6. Obrazová knihovna — galerie na kartě; plná správa/upload (R2 + editor — 32-admin.md) rozpracovaná
  7. Filtrace a vyhledávání v katalogu — viz tasks/done/filtrace-a-vyhledavani-katalogu.md
  8. Sezónnost a kalendář — viz tasks/done/sezonnost-a-kalendar.md
  9. Mapa výskytu — viz tasks/mapa-vyskytu.md
  10. Směsi bylin — viz tasks/smesi-bylin.md
  11. Doporučení (engine) — viz tasks/doporuceni.md
  12. 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:

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