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: 
    ---
title: "Název receptu"
typ: tocena    # tocena | sorbet | nanuk | kopeckova | premium
tuk_pct: 8
pac: 28
serv_teplota: "−10 až −12 °C"
varka_kg: 10
obtiznost: stredne-pokrocily
tags: [smetanova, vanilka, klasika]
ingredience: [plnotucne-mleko, smetana-33, vajecny-zloutek, sacharoza, dextroza]
description: "Krátký popis na jednu větu."
autor: "Tvé jméno"
licence: "CC BY-SA 4.0"
---
  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"
    poznamka: "balení 1 kg, ~250 Kč"

Přidat článek do knowledge base

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

---
title: "Název článku"
sekce: slozky    # slozky | chemie | procesy | reference
tags: [tag1, tag2]
poradi: 50
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