Moja Serowarnia: kultury, przepisy na sery i kalkulator pasz

Szuka kultur do sera, jogurtu, kefiru i twarogu po nazwie sera albo zastosowaniu (np. "camembert", "twaróg", "jogurt grecki", "mozzarella"), z filtrami typu, temperatury pracy i sklepu. Zwraca nazwę, typ, zastosowanie, temperaturę, sklep, cenę, cenę za litr mleka i link do karty kultury. Każde słowo zapytania musi wystąpić w nazwie, zastosowaniu, typie albo składzie.

{
  "type": "object",
  "properties": {
    "zapytanie": {
      "description": "Ser albo zastosowanie, np. \"camembert\", \"twaróg\", \"feta\", \"jogurt grecki\"",
      "type": "string",
      "maxLength": 200
    },
    "typ": {
      "description": "Typ kultury, dokładnie jedna z wartości z listy",
      "type": "string",
      "enum": [
        "aromatyzujące",
        "jogurtowe",
        "kefir",
        "mezofilne",
        "mezofilno-termofilne",
        "ochronne",
        "pleśniowe",
        "probiotyczne",
        "propionowe",
        "termofilne",
        "wege",
        "zestaw"
      ]
    },
    "temperatura": {
      "description": "Temperatura pracy w °C; zwraca kultury, których zakres ją obejmuje",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "sklep": {
      "description": "Tylko kultury z tego sklepu",
      "type": "string",
      "enum": [
        "Artiser.pl",
        "GAP Poland",
        "Lactic.pl",
        "Serowar.pl",
        "Wańczykówka"
      ]
    },
    "sortuj": {
      "description": "trafnosc (domyślnie) albo cena_za_litr, czyli od najtańszej w przeliczeniu na litr mleka",
      "type": "string",
      "enum": [
        "trafnosc",
        "cena_za_litr"
      ]
    },
    "limit": {
      "description": "Ile wyników zwrócić, domyślnie 10",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Pełna karta jednej kultury po nazwie handlowej, np. "Choozit MA 4001", "ALPHA 10", "DELTA 2": skład z rozbiciem na gatunki, zastosowanie, temperatura, dawkowanie, producent, proporcje szczepów, wszystkie oferty w sklepach z ceną za litr i linkiem do produktu. Gdy nazwy nie ma, zwraca najbliższe nazwy.

{
  "type": "object",
  "properties": {
    "nazwa": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Nazwa handlowa z opakowania albo z wyników szukaj_kultur"
    }
  },
  "required": [
    "nazwa"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Kultury o identycznym składzie gatunkowym jak podana, od najtańszej w przeliczeniu na litr mleka. Zaznacza, gdy w grupie są różne przeznaczenia albo różne proporcje szczepów. Ten sam skład nie znaczy ten sam produkt, więc wynik zawiera zastrzeżenie do przekazania użytkownikowi.

{
  "type": "object",
  "properties": {
    "nazwa": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Nazwa handlowa kultury, do której szukamy zamiennika"
    }
  },
  "required": [
    "nazwa"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Opis bazy: ile kultur i sklepów, jakie typy, od kiedy ceny są sprawdzone, licencja i jak cytować. Warto wywołać raz, zanim przedstawisz bazę użytkownikowi.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Szuka przepisów na domowe sery po nazwie sera albo cesze (np. "mozzarella", "ser pleśniowy", "z mleka koziego", "twaróg"). Bez zapytania zwraca wszystkie przepisy. Zwraca nazwę, trudność, wydajność, czas dojrzewania, krótki opis i link. Pełny przepis z kulturami i sklepami zwraca narzędzie przepis.

{
  "type": "object",
  "properties": {
    "zapytanie": {
      "description": "Ser albo cecha, np. \"mozzarella\", \"camembert\", \"ser twardy\"",
      "type": "string",
      "maxLength": 200
    },
    "trudnosc": {
      "description": "Tylko przepisy o tej trudności",
      "type": "string",
      "enum": [
        "Łatwy",
        "Średni",
        "Zaawansowany"
      ]
    },
    "limit": {
      "description": "Ile wyników zwrócić, domyślnie 10",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Pełny przepis na domowy ser po nazwie albo id, np. "mozzarella", "gouda", "ser topiony": mleko, kultura startowa, koagulant, dawkowanie, kroki z temperaturami i czasami, solenie, dojrzewanie, wskazówki i ostrzeżenia, a gdy jest, dziennik warzeń autora. Do tego kultury z przepisu dopasowane do bazy (sklep, cena, cena za litr, link do karty) i inne kultury z bazy pasujące do tego sera.

{
  "type": "object",
  "properties": {
    "nazwa": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Nazwa sera albo id z wyników szukaj_przepisow"
    }
  },
  "required": [
    "nazwa"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Wyszukuje surowce paszowe z bazy 124 pozycji (zboża, śruty, strączkowe, dodatki mineralne, premiksy, gotowe mieszanki) z energią, białkiem, Ca, P, włóknem, tłuszczem i aminokwasami. Bez zapytania zwraca listę kategorii. Przy jednym trafieniu albo z pelny=true podaje pełny skład.

{
  "type": "object",
  "properties": {
    "zapytanie": {
      "description": "Nazwa albo jej początek, np. \"pszenica\", \"śruta\", \"fosforan\"",
      "type": "string",
      "maxLength": 80
    },
    "kategoria": {
      "description": "Tylko surowce z tej kategorii",
      "type": "string",
      "enum": [
        "Ziarna, nasiona i strączkowe",
        "Produkty uboczne, śruty i oleje",
        "Pasze pochodzenia zwierzęcego",
        "Susze z roślin zielonych",
        "Zielonki (pasze świeże)",
        "Kiszonki",
        "Okopowe i bulwiaste",
        "Dodatki mineralne",
        "Gotowe mieszanki (pełnoporcjowe)",
        "Aminokwasy i dodatki paszowe",
        "Premiksy",
        "Koncentraty"
      ]
    },
    "pelny": {
      "description": "true = pełny skład każdego surowca (minerały, aminokwasy, witaminy)",
      "type": "boolean"
    },
    "limit": {
      "description": "Ile surowców zwrócić, domyślnie 15",
      "type": "integer",
      "minimum": 1,
      "maximum": 40
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Normy żywieniowe dla 6 grup drobiu i ich okresów: energia, białko, Ca, P, włókno, sód, a dla stad zarodowych także K, Mg i mikroelementy. Z okresem podaje też zalecane maksymalne udziały surowców i, dla niosek w nieśności, typową dzienną dawkę paszy na sztukę ze źródłem. Bez parametrów zwraca listę gatunków i okresów.

{
  "type": "object",
  "properties": {
    "drob": {
      "description": "Gatunek, np. kury-nioski-lekkie, brojlery",
      "type": "string",
      "enum": [
        "kury-nioski-lekkie",
        "kury-nioski-ciezkie",
        "brojlery",
        "kaczki",
        "gesi",
        "indyki"
      ]
    },
    "okres": {
      "description": "Okres albo jego fragment, np. \"powyżej 45\", \"starter\", \"1-6 tygodni\"",
      "type": "string",
      "maxLength": 60
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Liczy skład mieszanki z podanych surowców i udziałów (w %) i porównuje z normą dla gatunku i okresu: co jest w normie, co za nisko, co za wysoko, koszt za kg (gdy są ceny) i sugestie, czego dodać. Udziały sumujące się do innej liczby niż 100 przelicza proporcjonalnie. Z parametrem stado liczy też, ile paszy i każdego surowca zje stado dziennie, tygodniowo i przez 30 dni.

{
  "type": "object",
  "properties": {
    "drob": {
      "type": "string",
      "enum": [
        "kury-nioski-lekkie",
        "kury-nioski-ciezkie",
        "brojlery",
        "kaczki",
        "gesi",
        "indyki"
      ],
      "description": "Gatunek drobiu"
    },
    "okres": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Okres, np. \"Niesienie (powyżej 45%)\" albo \"starter\""
    },
    "skladniki": {
      "minItems": 1,
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "nazwa": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "procent": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Udział w mieszance w %"
          },
          "cena": {
            "description": "Cena w zł za kg",
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 1000
          }
        },
        "required": [
          "nazwa",
          "procent"
        ]
      }
    },
    "stado": {
      "description": "Podaj, gdy pytanie dotyczy ilości paszy dla stada",
      "type": "object",
      "properties": {
        "sztuk": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100000,
          "description": "Liczba ptaków"
        },
        "dawka_g": {
          "description": "Pasza na sztukę dziennie w g; bez niej typowa z poradnika rasy, jeśli jest dla tego okresu",
          "type": "number",
          "minimum": 5,
          "maximum": 400
        }
      },
      "required": [
        "sztuk"
      ]
    }
  },
  "required": [
    "drob",
    "okres",
    "skladniki"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Z podanych surowców dobiera proporcje pod normę dla gatunku i okresu, tym samym algorytmem co kalkulator pasz na mojaserowarnia.pl (cel "normy"), albo szuka najtańszej mieszanki bliskiej normie (cel "najtaniej", wymaga cen). Dobiera pod energię, białko, wapń i fosfor; resztę parametrów liczy i ocenia. Każdy surowiec trzyma się zalecanego maksimum (np. kukurydza 60%, pszenica 50%), a min_procent i max_procent przy składniku pozwalają ustawić własne granice. Zwraca proporcje, wynik wobec normy, czego brakuje, sugestie i surowce, które doszły do limitu; z parametrem stado także kg paszy i surowców na dzień, tydzień i 30 dni.

{
  "type": "object",
  "properties": {
    "drob": {
      "type": "string",
      "enum": [
        "kury-nioski-lekkie",
        "kury-nioski-ciezkie",
        "brojlery",
        "kaczki",
        "gesi",
        "indyki"
      ],
      "description": "Gatunek drobiu"
    },
    "okres": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Okres, np. \"Niesienie (powyżej 45%)\" albo \"starter\""
    },
    "skladniki": {
      "minItems": 2,
      "maxItems": 15,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "nazwa": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "Nazwa surowca, najlepiej dokładnie jak w skladniki_paszy, np. \"Pszenica\", \"Śruta sojowa\", \"Kreda pastewna\""
          },
          "cena": {
            "description": "Cena w zł za kg, potrzebna do kosztu i do celu \"najtaniej\"",
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 1000
          },
          "min_procent": {
            "description": "Najmniejszy udział tego surowca w %, np. 40, gdy ma być głównym składnikiem",
            "type": "number",
            "minimum": 0,
            "maximum": 100
          },
          "max_procent": {
            "description": "Największy udział w %; zastępuje domyślne maksimum (np. kukurydza 60%)",
            "type": "number",
            "minimum": 0.1,
            "maximum": 100
          }
        },
        "required": [
          "nazwa"
        ]
      },
      "description": "Surowce do użycia, bez udziałów"
    },
    "cel": {
      "description": "normy (domyślnie) albo najtaniej",
      "type": "string",
      "enum": [
        "normy",
        "najtaniej"
      ]
    },
    "stado": {
      "description": "Podaj, gdy pytanie dotyczy ilości paszy dla stada",
      "type": "object",
      "properties": {
        "sztuk": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100000,
          "description": "Liczba ptaków"
        },
        "dawka_g": {
          "description": "Pasza na sztukę dziennie w g; bez niej typowa z poradnika rasy, jeśli jest dla tego okresu",
          "type": "number",
          "minimum": 5,
          "maximum": 400
        }
      },
      "required": [
        "sztuk"
      ]
    }
  },
  "required": [
    "drob",
    "okres",
    "skladniki"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}