Rituály — knihovna (spiritual_guides) a routy /ritualy

Stav dokumentu: Částečně — tabulka spiritual_guides (migrace 0016_spiritual_guides.sql) a veřejné stránky /ritualy, /ritualy/:slug jsou v produkci; základní krokovač na detailu návodu je hotový. Admin CRUD a validace JSON jsou v 32-admin.md. Rozšíření průvodce (URL krok, animace, …) zůstává backlog.

Cíl: jedna doména — editorské strukturované návody mimo volné spiritual_uses na kartě byliny (odděleně od vědy; viz úvod na /ritualy).

Vstup: 22-data-model.md · 32-admin.md (správa návodů). Rozcestník: spiritualni-a-ritualni-obsah.md. Sekce na kartě: spiritualni-uses-karta-byliny.md.


1. Datový model

  • Tabulka spiritual_guides: slug, title, intent, category, intro, steps_json, materials_json, safety_notes, references_note, volitelně herb_id, is_published, časová razítka.
  • Seed v migraci 0016_spiritual_guides.sql (ukázkový záznam).

2. Veřejný web

  • /ritualy — seznam publikovaných návodů (listPublishedSpiritualGuides).
  • /ritualy/:slug — detail s kroky (JSON), materiály, bezpečnostní poznámka, odkaz na související bylina (pokud je herb_id).

3. Plánovaná vylepšení

  • Interaktivní průvodce (krok za krokem) — na /ritualy/:slug: krokovač pro více kroků, indikátor pozice, klávesové šipky, pozice v sessionStorage (relace prohlížeče), rozbalení celého seznamu; komponenta RitualGuideSteps v app/components/ritual-guide-steps.tsx (viz 26-ui-components.md).
  • Rozšíření průvodce (např. animace, sdílení odkazu na konkrétní krok v URL, trvalější stav) — backlog podle potřeby.

4. Akceptace

  • Nepublikované záznamy se na veřejném webu nezobrazují (is_published = 1).
  • Detail návodu má čitelné kroky a konzistentní bezpečnostní rámec (text / disclaimer).

5. Vazby na jiné dokumenty