Jak přispět

Tenhle projekt je otevřený. Pokud máš ověřený recept, víš o lepším eshopu na nějakou ingredienci, nebo jsi narazil na chybu — pošli pull request.

Přidat nový recept

  1. Forkni si repozitář na GitHubu.
  2. Vytvoř nový soubor src/content/recepty/tvuj-recept.md. Zkopíruj strukturu z některého existujícího (např. smetanovy-zaklad.md) a uprav.
  3. Vyplň frontmatter (povinná pole jsou označená, ostatní mají rozumný default): 
    ---
title: "Název receptu"            # POVINNÉ
typ: tocena                       # POVINNÉ: tocena | sorbet | nanuk | kopeckova | premium
cislo: 12                         # volitelné, pořadové číslo receptu
obtiznost: stredne-pokrocily      # zacatecnik | stredne-pokrocily | pokrocily (default: stredne-pokrocily)
tuk_pct: 8                        # volitelné, % tuku ve směsi
pac: 28                           # volitelné, anti-freezing power
serv_teplota: "−10 až −12 °C"     # volitelné
overrun: "35 %"                   # volitelné, nárůst objemu
varka_kg: 10                      # default 10
tags: [smetanova, vanilka, klasika]
ingredience: [plnotucne-mleko, smetana-33, vajecny-zloutek, sacharoza, dextroza]
souvisejici: [vanilkovy-zaklad]   # slugy souvisejících receptů
description: "Krátký popis na jednu větu."
pdf: "recepty/12-nazev.pdf"       # volitelné, vyplní build_pdfs.py
autor: "Tvé jméno"                # default: "Ranč Na Samotách"
licence: "CC BY-SA 4.0"           # default: "CC BY-SA 4.0"
aktualizovano: 2026-05-13         # volitelné, datum poslední úpravy
stav: navrh                       # navrh | testovany | odladeny (default: navrh)
publikovat: true                  # default: true. Pokud false, recept se nepublikuje na web (zůstane v Gitu).
---

    Stav vývoje: navrh = teoretický návrh, nevyzkoušený · testovany = jednou vyrobený, dolaďujeme · odladeny = ověřený v provozu.

  4. Napiš tělo receptu v Markdownu — surovinová tabulka, bilance, postup, tipy.
  5. Otevři pull request s krátkým popisem.

Přidat eshop link k ingredienci

Otevři odpovídající src/content/ingredience/*.md a přidej do frontmatter pod eshopy:: 

eshopy:
  - nazev: "Název obchodu"
    url: "https://eshop.cz/produkt"   # POVINNÉ, musí být validní URL
    poznamka: "balení 1 kg, ~250 Kč"  # volitelné

Celý frontmatter karty ingredience

---
title: "Plnotučné mléko"                  # POVINNÉ
kategorie: tuk-mlecny                    # POVINNÉ: cukr | tuk-mlecny | protein | stabilizator |
                                          # emulgator | ovoce | kakao | aroma | sul-mineral |
                                          # vlaknina | alkohol | baze-komercni | voda
nazev_alt: ["mléko 3,5 %", "whole milk"]  # alternativní názvy / synonyma
forma: kapalna                           # kapalna | sypka | pasta | polotuhe (volitelné)
sucha_latka_pct: 12.5                    # volitelné, % sušiny
pac: 0                                   # volitelné
pod: 0                                   # volitelné, POD (sweetness power)
typicke_davkovani: "40–60 % m/m"         # volitelné
tags: [mleko, baze]
knowledge_refs: [tuky-ve-zmrzline]       # slugy souvisejících knowledge článků
eshopy:
  - nazev: "Název obchodu"
    url: "https://eshop.cz/produkt"
    poznamka: "balení 1 kg, ~250 Kč"
description: "Krátký popis."
---

Přidat článek do knowledge base

Vytvoř src/content/knowledge/nazev-clanku.md s frontmatter: 

---
title: "Název článku"     # POVINNÉ
sekce: slozky             # slozky | chemie | procesy | reference (default: slozky)
tags: [tag1, tag2]
poradi: 50                # řazení v sekci, nižší = výš (default: 100)
description: "Krátký popis."
---

Použít AI asistenta (Claude, GitHub Copilot)

V repu je skill (návod pro AI agenta), který dokáže z hlavní příchuti a pár ingrediencí navrhnout celý recept, spočítat bilanci (tuk, MSNF, PAC, sušina), uložit .md do src/content/recepty/ a rovnou vygenerovat PDF. Najdeš ho v skills/zmrzlina-recept/SKILL.md.

Claude Code / Claude.ai

  1. Naklonuj repo lokálně: 
    git clone https://github.com/cmeldas/zmrzlina_nasamotach.git
cd zmrzlina_nasamotach
  2. Spusť Claude Code v rootu repa. Skill najde sám (složka skills/zmrzlina-recept/).
  3. Zadej prompt, např.:
    „Udělej recept na pistáciovou zmrzlinu se smetanou 33 %, pistáciovou pastou a žloutky. Použij skill zmrzlina-recept."
  4. Claude se případně doptá (typ, cílový tuk, suroviny), pak napíše .md, doplní karty surovin a pustí python scripts/build_pdfs.py --recipe NN.
  5. Zkontroluj výsledek, otestuj v provozu, otevři PR.

GitHub Copilot ve VS Code (agent mode)

  1. Otevři repo ve VS Code s nainstalovaným rozšířením GitHub Copilot.
  2. Přepni Copilot Chat do Agent módu (ikona Agent v hlavičce chatu).
  3. V chatu napiš požadavek a explicitně se odkaž na skill: 
    Použij skill skills/zmrzlina-recept/SKILL.md
a navrhni mangový sorbet s limetkou.
  4. Copilot načte SKILL.md, projde knowledge soubory, napočítá bilanci, vytvoří src/content/recepty/mangovy-sorbet.md a spustí build PDF.
  5. Pokud nějaká ingredience nemá kartu v src/content/ingredience/, skill ji založí podle šablony — zkontroluj hodnoty (pac, sucha_latka_pct).

Co od AI vždy zkontroluj

  • Součet ingrediencí = přesně 10 000 g a 100,00 %.
  • PAC v cílovém rozsahu (točená 28–30, sorbet 28–32, nanuk 22–26).
  • Sůl 1 g, ne víc.
  • Pro nanuk glukózový sirup v prášku (např. GL01934), ne tekutý.
  • Pro čokoládu žádná jedlá soda.
  • Čerstvé ovoce, kůra a extrakty se přidávají po pasteraci.
  • Odkazy na karty surovin (/ingredience/{slug}/) ukazují na existující soubory.

Pozor: AI ti dá kvalitní výchozí návrh, ale chuť a texturu musíš ověřit v reálné várce. Po první zkoušce klidně iteruj (uprav cukry, tuk, stabilizátor) a pošli PR s ověřenou verzí.

Pravidla pro recepty

  • Provozní velikost: všechny recepty jsou na várku 10 kg (provoz Carpigiani / Bravo). Pokud má tvůj recept jinou velikost, uveď to jasně.
  • Bilance je nutná: uveď tuk %, MSNF %, cukry %, PAC. Bez čísel je to jen babiččina kuchařka.
  • Vysvětli "proč" — proč zrovna tento poměr cukrů, proč tato teplota, proč tento postup.
  • Zdroje: pokud čerpáš z konkrétní knihy nebo článku, uveď referenci.
  • Bezpečnost: u syrových složek (vejce) uveď pasterizační režim.

Licence příspěvku

Otevřením pull requestu souhlasíš, že tvůj příspěvek bude uvolněn pod licencí CC BY-SA 4.0. Tvoje autorství zůstává, ostatní jen mohou recept sdílet a upravovat za stejných podmínek.

Co nepřijímáme

  • Recepty obsahující obchodně chráněné receptury (NDA, výrobci komerčních směsí).
  • Marketingové texty na konkrétní produkty bez technické hodnoty.
  • Opisy z knih bez přepracování (autorská práva).
Zmrzlina Na Samotách · zmrzlina.nasamotach.cz · Recepty pod licencí CC BY-SA 4.0