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.