Roadmap: databáze bylin (Soul of Herbs)

Stav dokumentu: Hotovo — rozcestník a odkazy jsou aktuální; checkboxy níže jsou „jasně řečené principy / fakta o projektu", ne detailní engineering checklist.

Tento soubor je rozcestník mezi featurami produktu. Po reorganizaci 2026-05 je hlavní produktové členění podle featur (témat) v tematických dokumentech (docs/tasks/); zadání první uzavřené iterace katalogu zůstává v 12-katalog-a-karta-byliny.md. Úplný přehled dokumentace: README.md.

Mapa dokumentace

Potřebuji…	Dokument
Stručné produktové zadání na jedné stránce	10-product-spec.md
Tato stránka — kontext, uživatelé, principy, mapa featur	`11-roadmap.md` (tento soubor)
Katalog `/byliny` a karta byliny (hotová první iterace)	12-katalog-a-karta-byliny.md
Symptomy a témata (modul `/symptomy`)	tasks/symptomy-a-temata.md
Filtrace a vyhledávání v katalogu	tasks/done/filtrace-a-vyhledavani-katalogu.md
Způsoby zpracování — rozcestník (`/zpracovani`, `pm`, recepty)	tasks/done/zpracovani-a-recepty.md
→ katalog metod (`/zpracovani`, encyklopedie)	tasks/done/katalog-zpracovani.md
→ editorské recepty (`herb_method_recipes`, `/recepty`)	tasks/editorske-recepty.md
Sezónnost a kalendář sběru (`/sezona`)	tasks/done/sezonnost-a-kalendar.md
Štítky tvrzení a typy důkazů (claim labels)	tasks/done/stitky-tvrzeni-a-typy-dukazu.md
Spirituální a rituální obsah	tasks/done/spiritualni-a-ritualni-obsah.md
Mapa výskytu	tasks/mapa-vyskytu.md
Směsi bylin (blends)	tasks/smesi-bylin.md
Doporučení (recommendations)	tasks/doporuceni.md
Uživatelský účet, profil, herbář, komunita	tasks/uzivatelsky-ucet.md
Technické fáze vývoje (Fáze 1–8: Workers, D1, SEO…)	24-engineering-roadmap.md
Rozhraní editora (plánované `/admin`, média, Access)	32-admin.md
Datový model a routy	22-data-model.md, 23-api-and-routes.md
Obsah, zdroje, oddělení věda × tradice	30-content-guidelines.md
Stav zapracování konkrétních bylin	31-byliny.md
Stack, doména, autodeploy	20-tech-stack.md

Vize (jednou větou)

Strukturovaný atlas bylin, který propojuje praktické informace o sběru a zpracování s tradičním, spirituálním a vědecky doloženým využitím — s filtrováním podle území, sezóny, symptomů, způsobu použití, bezpečnosti a typu důkazu.

Cíloví uživatelé (shrnutí)

Segment	Stručně
Začátečník	Poznávání, kde roste, kdy sbírat, skladování, bezpečné zpracování
Praktický uživatel	Hledání podle potřeby (zdraví, spánek, stres, trávení, rituály…)
Spiritualita / tradice	Symbolika, rituály, lidová magie — odděleně od vědy
Vědecký přístup	Účinky podložené studiemi, odkazy na zdroje
Tvůrce obsahu	Strukturovaný zdroj pro články, kurzy, herbáře

Průřezová infra

CI/CD a autodeploy z main (GitHub → Cloudflare) — postup, dvě varianty nasazení a odškrtávací checklist: 20-tech-stack.md — sekce Deployment.

Průřezové principy (platí pro všechny fáze a featury)

Tradiční / spirituální informace jsou jasně oddělené od vědecky ověřených — uživatel vždy ví typ zdroje tvrzení.
Bezpečnost — jedovatost, záměny, kontraindikace, děti, těhotenství, interakce s léky (viz tasks/bezpecnost-a-media-stitky.md §2).
Žádné náhrady lékaře — pouze informační charakter; u zdravotních témat odkaz na odbornou péči kde je to vhodné.

Co už funguje dobře (katalog a dokumentace)

Katalog /byliny — vyhledávání, filtry (měsíc sběru, region, více způsobů zpracování pm, téma + typ vazby), onboarding a karty v seznamu dle 12-katalog-a-karta-byliny.md — §7.
Katalog /byliny a karta byliny — veřejná část — dle 12-katalog-a-karta-byliny.md hotové; rozhraní editora zbývá (32-admin.md).
Tematické dokumenty popisují celé featury (mapa, symptomy, zpracování, sezóna, štítky, spirituální obsah, směsi, doporučení) napříč fázemi, bez svázání s číslovanou řadou fází.
Datová vrstva (D1 + is_published) je praktická pro režim koncept vs. veřejný obsah.

Featury napříč produktem (cílový stav)

Feature	Stav v aplikaci	Dokument
Katalog a karta byliny — katalog, detail byliny, šablona karty	hotovo (veřejná část)	12-katalog-a-karta-byliny.md
Symptomy a témata (`/symptomy`, `link_type`, `topicScope`)	hotovo	tasks/symptomy-a-temata.md
Filtrace a vyhledávání (`q`, `region`, `month`, `pm`, `topic`, `science`, `safety`, …)	hotovo (základ)	tasks/done/filtrace-a-vyhledavani-katalogu.md
Způsoby zpracování a recepty (`/zpracovani`, `pm`, recepty)	hotovo (katalog metod); částečně (rozšíření edit. receptů)	tasks/done/zpracovani-a-recepty.md → katalog-zpracovani.md, editorske-recepty.md
Sezónnost a kalendář sběru (`/sezona`)	hotovo (jádro; ICS / připomínky v navazujících úkolech)	tasks/done/sezonnost-a-kalendar.md
Štítky tvrzení a typy důkazů (claim labels)	hotovo (validace plán)	tasks/done/stitky-tvrzeni-a-typy-dukazu.md
Spirituální a rituální obsah	částečně (knihovna plán)	tasks/done/spiritualni-a-ritualni-obsah.md
Mapa výskytu	plán (regiony hotové)	tasks/mapa-vyskytu.md
Směsi bylin (blends)	plán	tasks/smesi-bylin.md
Doporučení	plán	tasks/doporuceni.md
Uživatelský účet, profil, herbář, komunita	plán	tasks/uzivatelsky-ucet.md

Doporučený další technický krok po uzavření veřejného katalogu a karty byliny: rozhraní editora (32-admin.md) a obsah podle šablony karty v 12-katalog-a-karta-byliny.md — §6 Šablona pole (DB ↔ UI).

Informační architektura (cílový stav napříč featurami)

Hlavní sekce směřují k: Byliny, Symptomy a témata, Sběr podle sezóny, Způsoby zpracování, Spirituální využití, Vědecké poznatky, Bezpečnost, Obrázkový atlas, Mapa, Směsi, Doporučení — rozpad je v jednotlivých feature dokumentech (viz tabulka výše). Můj herbář a Profil (uživatelské sekce) jsou popsány v průřezovém dokumentu tasks/uzivatelsky-ucet.md, nezávisle na pořadí dodávek.

Hlavní datové entity (přehled)

Bylina, Část rostliny, Lokalita / Region, Období sběru, Způsob zpracování, Symptom / stav / téma, Spirituální použití, Vědecké tvrzení, Studie / zdroj, Obrázek, Bezpečnostní upozornění — zavedené v rámci 12-katalog-a-karta-byliny.md; rozšiřování (směsi, mapové vrstvy, recepty, uživatelské entity) je popsáno v jednotlivých feature dokumentech.