Doporučení (recommendations) — průřezové zadání

Stav dokumentu: Plán — funkcionalita zatím nezapracovaná; jednotlivé „pohledy" (sezóna, region, téma) jsou dostupné samostatně, ale agregovaný personalizovaný feed zatím není.

Cíl: popsat doporučovací vrstvu produktu — kombinaci sezóny, regionu, témat / symptomů, profilu uživatele a kontextu (právě v terénu) do jednoho přehledu „co teď stojí za pozornost". Zahrnuje jak deterministická pravidla (filtry + váhy), tak budoucí sémantické / AI doporučování.

Vstup: 10-product-spec.md §1 · filtry-katalogu-bylin.md · filtrace-a-vyhledavani-katalogu.md · sezonnost-a-kalendar.md · symptomy-a-temata.md · uzivatelsky-ucet.md · 24-engineering-roadmap.md Fáze 8.

Tematický (feature-based) dokument napříč všemi vývojovými fázemi.

1. Stav v aplikaci (k datu údržby)

  • Jednotlivé pohledy: /sezona (měsíc), /region, /symptomy, /zpracovani.
  • Onboarding karta na /byliny (úvodní vysvětlení katalogu).
  • Personalizovaný feed napříč osami (sezóna + region + profil + téma) zatím není.

2. Cílové zobrazení

  • „Co právě v terénu / podle profilu / podle sezóny" v jedné časové ose — homepage nebo /doporuceni.
  • Kontextové bloky podle situace:
    • „Sběr právě teď" (aktuální měsíc + tvůj region z profilu),
    • „Tvá uložená témata" (z uzivatelsky-ucet.md §4),
    • „Doporučené k tvé úrovni" (začátečník / pokročilý — z profilu),
    • „Studie této bylinné rodiny" (vědecká vrstva — vazba na vedecke-dukazy-a-studie.md §1–2).

3. Pravidlový engine — návrh

3.1 Vstupy

VstupZdroj
Aktuální měsícserver time
Region uživateleprofil (uzivatelsky-ucet.md §2)
Úroveň znalostíprofil
Zájmové přepínačeprofil
Uložená témata / oblíbenéprofil (uzivatelsky-ucet.md §4)
Stav sezóny / kalendářesezonnost-a-kalendar.md
Bezpečnostní úroveň bylinybezpecnost-a-media-stitky.md §2
(volitelně) Geo poloha (krátkodobá)jen se souhlasem uživatele

3.2 Pravidla / váhy (návrh)

  • Filtr sezóny (má harvest_periods v aktuálním měsíci) — povinná podmínka pro „sběr teď".
  • Filtr regionu (má vazbu na regions z profilu) — povinná podmínka pro „v tvém území".
  • Boost podle uložených témat (+N za každé shodné téma).
  • Down-weight bylin s safety_level IN ('dangerous', 'avoid_home_use') pro úroveň „začátečník".
  • Boost bylin s podloženými vědeckými tvrzeními pro profilového „vědeckého" uživatele.
  • Boost spirituálního obsahu pro profilového „spirituálního" uživatele.

4. Sémantické / AI doporučování

Vazba na 24-engineering-roadmap.md Fáze 8.

  • Vectorize embeddings popisu bylin a textů spirituálních / vědeckých — vyhledávání „bylina podobná této" (na kartě byliny).
  • Semantické dotazy typu „chci klid mysli a lepší spánek na podzim v Beskydech" → doporučení.
  • Doporučování podobných bylin na kartě (vazba na herb_similar).
  • Embedding témat pro automatický cross-link mezi tematicky blízkými symptomy / stavy (vazba na symptomy-a-temata.md §5).

5. Privátnost a transparentnost

  • Vysvětlení proč se doporučení zobrazilo („protože máš v profilu zájem o spánek a je květen").
  • Možnost vypnout personalizaci — fallback na anonymní pohled (sezóna + obecné).
  • Nepoužívat doporučení jako náhradu lékaře — disclaimer u zdravotních témat (vazba na 11-roadmap.md průřezové principy).

6. Plánovaná vylepšení

  • Týdenní digest e-mailem (souhlas uživatele) — „co bude za týden zajímavé".
  • Doporučení směsí podle účelu + sezóny (vazba na smesi-bylin.md §5).
  • Doporučení receptů podle uložených oblíbených bylin (vazba na editorske-recepty.md).
  • A/B testování vah / pravidel — interní dashboard.

7. Akceptace

  • Doporučení vrací stabilní data z katalogu (parametry jako v filtry-katalogu-bylin.md §1; rozcestník filtrace-a-vyhledavani-katalogu.md) — žádný „ručně sestavený" obsah mimo katalog.
  • U každého doporučení je vidět proč (krátký textový důvod).
  • Lze vypnout personalizaci a vrátit se na anonymní pohled.

8. Vazby na jiné dokumenty