Kompletní seznam Markdown souborů ze složky docs/: /dokumentace

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 fázemi dodání. Detailní zadání je v souborech MVP1–MVP5; níže je jen kontext a odkazy. Úplný přehled dokumentace v nadřazené složce: README.md.

Mapa dokumentace

Potřebuji…Dokument
Stručné produktové zadání na jedné stránce10-product-spec.md
Tato stránka — kontext, uživatelé, tabulka MVP1–MVP511-roadmap.md (tato složka done/)
Detailní scope MVP1–MVP512-mvp-1.md, 13-mvp-2.md, 14-mvp-3.md, 15-mvp-4.md, 16-mvp-5.md
Technické fáze vývoje (Fáze 1–8: Workers, D1, admin, SEO…)24-engineering-roadmap.md
Datový model a routy22-data-model.md, 23-api-and-routes.md
Obsah, zdroje, oddělení věda × tradice30-content-guidelines.md
Stav zapracování konkrétních bylin31-byliny.md
Stack, doména, autodeploy20-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í)

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

Průřezová infra

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

  1. Tradiční / spirituální informace jsou jasně oddělené od vědecky ověřených — uživatel vždy ví typ zdroje tvrzení.
  2. Bezpečnost — jedovatost, záměny, kontraindikace, děti, těhotenství, interakce s léky (viz jednotlivá MVP).
  3. Žá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-mvp-1.md — §7.
  • MVP1 (veřejná část) — dle 12-mvp-1.md hotové; admin zůstává další fáze.
  • Dokumentace má jasný směr (MVP1–MVP5) a technickou roadmapu včetně SEO, adminu, cache a vyhledávání (24-engineering-roadmap.md).
  • Datová vrstva (D1 + is_published) je praktická pro režim koncept vs. veřejný obsah.

Fáze dodání (MVP1–MVP5)

FázeDokumentHlavní přínos
MVP112-mvp-1.mdPrvní použitelná verze: katalog, detail byliny (identifikace, výskyt, sběr, skladování, zpracování), tradiční + vědecké vrstvy se zdroji u vědy, základní filtry, obrázky, bezpečnost
MVP213-mvp-2.mdSymptomy a témata jako struktura, vazby na byliny, rozšířené a sezónní filtry, katalog způsobů zpracování jako samostatná část
MVP314-mvp-3.mdProfil, preference (území, zájmy), personalizace, oblíbené / „můj herbář“, jemná filtrace podle profilu
MVP415-mvp-4.mdSezóna / kalendář sběru, uložená témata, recepty a postupy u zpracování, rozšířený obsah pro praktickou práci
MVP516-mvp-5.mdMapa výskytu, komunitní vrstva, směsi bylin, pokročilá doporučení a propojení receptur

Doporučený další technický krok po uzavření veřejného MVP1: admin / CMS a obsah podle šablony karty v 12-mvp-1.md — §6 Šablona pole (DB ↔ UI).

Informační architektura (cílový stav napříč fázemi)

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, Můj herbář, Profil — ne všechny musí existovat od MVP1; rozpad je v jednotlivých MVP souborech.

Hlavní datové entity (přehled)

Bylina, Část rostliny, Lokalita, 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í po částech podle MVP1–MVP5.

Engineering roadmap — technické fáze implementace

Stav dokumentu: Živý checklist — checkboxy sledují stav v repu k datu údržby dokumentu; po dokončení fáze aktualizujte.

Tento dokument popisuje technické kroky vývoje (infra, data, veřejný web, admin, SEO, výkon, vyhledávání). Nejedná se o produktové „MVP1–MVP5“ — ty jsou v 11-roadmap.md a v souborech 12-mvp-1.md až 16-mvp-5.md. Stručné produktové shrnutí: 10-product-spec.md.

Fáze 1: Základ projektu

  • založit React Router v7 app na Cloudflare Workers,
  • nastavit TypeScript,
  • nastavit Tailwind,
  • nastavit shadcn/ui,
  • nastavit Wrangler,
  • nastavit D1,
  • nastavit R2 (binding + čtení /media/…; bucket v účtu + volitelně admin upload později),
  • nastavit KV (binding zatím ne — viz 20-tech-stack.md),
  • vytvořit první deployment.

Fáze 2: Datový základ

  • vytvořit D1 migrace,
  • vytvořit základní tabulky,
  • vytvořit seed pro regiony,
  • vytvořit seed pro části rostlin,
  • vytvořit seed pro způsoby zpracování,
  • vytvořit seed pro symptomy a témata,
  • vložit 10–20 testovacích bylin.

Fáze 3: Veřejný katalog

  • vytvořit /byliny,
  • vytvořit /byliny/:slug,
  • vytvořit detail byliny,
  • vytvořit galerii,
  • vytvořit blok sběru,
  • vytvořit blok zpracování,
  • vytvořit blok spirituálního použití,
  • vytvořit blok vědeckých důkazů,
  • vytvořit blok bezpečnosti.

Fáze 4: Filtry

  • filtrovat podle regionu,
  • filtrovat podle měsíce sběru,
  • filtrovat podle části rostliny,
  • filtrovat podle způsobu zpracování,
  • filtrovat podle symptomu / tématu (v katalogu — výpis /symptomy částečně),
  • filtrovat podle typu důkazu,
  • filtrovat podle bezpečnostní úrovně.

Fáze 5: Admin

  • ochránit /admin přes Cloudflare Access,
  • vytvořit admin dashboard,
  • vytvořit CRUD bylin,
  • vytvořit CRUD vědeckých důkazů,
  • vytvořit CRUD spirituálního použití,
  • vytvořit CRUD zpracování,
  • vytvořit upload obrázků,
  • vytvořit publikování / drafty,
  • vytvořit cache invalidaci.

Fáze 6: SEO

Priorita: základní SEO patří mezi „low hanging fruit“ — ideálně brzy po veřejném katalogu a detailech (Fáze 3), protože vyhledávače začnou routy indexovat hned; nebrzdit to za adminem nebo pokročilými filtry. Produktový kontext (title/description, H1/H2): 12-mvp-1.md — §7.5.

  • základ: dynamický /sitemap.xml (publikované byliny, dokumentace docs/*.md, hlavní routy) a /robots.txt (Disallow: /__internal/),
  • úvod, katalog, detail byliny, /roadmap a /dokumentace: canonical URL, Open Graph (og:title, og:description, og:url, og:type, og:locale; u detailu byliny volitelně og:image z prvního obrázku karty) a Twitter Card — částečně (meta helper v repu; doladit konzistenci),
  • výchozí OG obrázek pro stránky bez vlastního náhledu (globální asset),
  • jednotná hierarchie H1/H2 a smysluplné meta popisy na /byliny a /byliny/:slug — částečně,
  • vytvořit stránky pro symptomy (/symptomy, /symptomy/:slug),
  • vytvořit stránky pro způsoby zpracování (/zpracovani, /zpracovani/:slug),
  • vytvořit sezónní stránky — částečně (/sezona, /sezona/:month; rozšíření „co sbírat“ viz MVP4)

Fáze 7: Výkon a cache

  • přidat KV cache pro detail byliny,
  • přidat KV cache pro filtry,
  • přidat KV cache pro homepage,
  • přidat cache invalidaci,
  • optimalizovat D1 dotazy,
  • přidat indexy,
  • měřit pomalé routy.

Fáze 8: Pokročilé vyhledávání

Později:

  • vytvořit search index,
  • přidat Vectorize,
  • generovat embeddings,
  • přidat semantické vyhledávání,
  • přidat doporučování podobných bylin,
  • přidat AI asistenci pro admin.