Food Tracer

Aplikace pro evidenci snědených jídel a útraty za jídlo. Ke každému jídlu se dá vedle názvu a zdroje uložit i cena a kalorie, takže jde zpětně zjistit, kolik člověk za jídlo utratil za den, měsíc nebo rok.

Umí naimportovat měsíční přehled vyexportovaný ze stránky statistik Luncheru — ve formátu XLSX, CSV i JSON.

Struktura

types/    → Sdílené TypeScript typy generované z OpenAPI (zdroj pravdy: types/api.yml)
server/   → Express 5 backend (Node.js 22, ts-node)
client/   → React 19 frontend (Vite 7, React Bootstrap)

Package manager: Yarn Classic. Každá složka má vlastní package.json.

Rozjetí

cd types  && yarn install && yarn openapi-ts   # typy je nutné vygenerovat první
cd ../server && yarn install
cd ../client && yarn install

Do server/.env.development patří JWT_SECRET o délce alespoň 32 znaků (šablona je v server/.env.template).

Vývoj

./run_dev.sh          # vše naráz v tmuxu (Linux/macOS)
.\run_dev.ps1         # dvě PowerShell okna (Windows)

Nebo ručně ve dvou terminálech:

cd server && NODE_ENV=development yarn startReload   # port 3001
cd client && yarn start                              # port 3000, proxy /api → 3001

Testy a build

cd server && yarn test     # Jest, in-memory úložiště
cd server && yarn build    # tsc → server/dist
cd client && yarn build    # tsc --noEmit + vite build → client/dist

Nasazení

JWT_SECRET=... docker compose up --build

Produkčně běží aplikace nad Redisem, ve vývoji nad JSON souborem (server/data/db.json). Viz server/.env.template.

Datový model

Úložiště je klíč–hodnota (JSON soubor ve vývoji, Redis v produkci). „Tabulka" je tedy typ klíče a hodnotou je pod ním buď celé pole záznamů, nebo jeden objekt. Klíče začínají typem a přihlašovacím jménem uživatele, data jednotlivých uživatelů se nemíchají.

Klíč	Hodnota
meals:<login>:<datum>	pole jídel dne (MealEntry)
mealTemplates:<login>	pole receptů (MealTemplate)
mealPhotos:<login>	rejstřík fotek: klíč jídla (název + zdroj) → pole náhledů
mealPhoto:<login>:<id>	plný obrázek jedné fotky (data URL)
calorieLibrary:<login>	vlastní knihovna kalorií: znormalizovaný název → záznam
settings:<login>	nastavení, tělesné údaje a cíle
weights:<login>	vážení: datum → hmotnost v gramech
sleep:<login>:<datum>	délka spánku v minutách
activities:<login>:<datum>	pole aktivit dne (ActivityEntry)
workouts:<login>	pole šablon tréninků — volné šablony i plány
workoutPlans:<login>:<datum>	pole záznamů o použití šablon a dnů plánu v daném dni

Výchozí hodnoty se do úložiště nezapisují (jedna série, násobek 1, volný typ šablony, slaná chuť receptu) a dopočítávaná pole (součty, odhady kalorií, ukazatele) se počítají při čtení.

erDiagram
    MEAL_ENTRY {
        string id PK
        date date
        enum mealType "SNIDANE, OBED, ..."
        string name
        string source "podnik / obchod"
        int price "haléře"
        int weight "g"
        int pricePer100g "haléře"
        int calories "kcal za porci"
        int caloriesPer100g
        object nutrientsPer100g "g na 100 g, na desetiny"
        decimal multiplier
        string note
        string templateId FK "recept"
        string importSource
        string importKey "duplicity importu"
        datetime createdAt
        datetime updatedAt
    }
    MEAL_TEMPLATE {
        string id PK
        string name
        string source
        string category "typ: polévka, omáčka..."
        enum flavor "SLANE, SLADKE"
        int servings
        int cookedWeight "g"
        int prepMinutes
        int weight "porce, dopočteno"
        int calories "porce, dopočteno"
        int price "porce, dopočteno"
        string note "postup v Markdownu"
        array sideDishIds FK "přílohy"
        array similarIds FK "podobné"
    }
    RECIPE_INGREDIENT {
        string name
        decimal amount "v jiné jednotce než g"
        enum unit "KS, ML, L, LZICE..."
        int weight "g"
        int caloriesPer100g
        int calories
        int price
    }
    MEAL_PHOTO_INDEX {
        string mealKey PK "název + zdroj"
        string id FK
        string thumbnail "data URL ~240 px"
        datetime createdAt
    }
    MEAL_PHOTO {
        string id PK
        string image "data URL ~1600 px"
    }
    CALORIE_LIBRARY {
        string normalizedName PK
        string name
        int caloriesPer100g
        int uses
        datetime updatedAt
    }
    SETTINGS {
        array sourceRates "podnik a sazba za 100 g"
        int basalCalories "ručně zadaný klidový výdej"
        object profile "pohlaví, rok narození, výška, obvody"
        object goals "tempo, cílová hmotnost, bílkoviny/kg"
    }
    WEIGHTS {
        date date PK
        int weightGrams
    }
    SLEEP {
        date date PK
        int minutes
    }
    ACTIVITY_ENTRY {
        string id PK
        date date
        string name
        enum unit "KROKY, MINUTY, SEKUNDY, KM, OPAKOVANI"
        int quantity "na sérii"
        int sets
        int caloriesPer100Units
        int calories "za jedno provedení"
        int extraWeightGrams
        decimal multiplier
        string note
        string templateId FK "šablona / plán"
        string planDayId FK "den plánu"
        date replacesDate "nahrazuje vynechaný cvik z tohoto dne"
        datetime createdAt
        datetime updatedAt
    }
    WORKOUT_TEMPLATE {
        string id PK
        string name
        enum type "VOLNY (výchozí), FIXNI, PLOVOUCI"
        int replaceWithinDays "jen plán"
        date startDate "jen plán"
    }
    WORKOUT_PLAN_DAY {
        string id PK
        string name
        int weekday "1-7, jen fixní plán"
    }
    WORKOUT_TEMPLATE_ITEM {
        enum kind "CVIK, SABLONA"
        string name
        enum unit
        int quantity
        int sets
        int caloriesPer100Units
        int extraWeightGrams
        string templateRefId FK "volná šablona"
    }
    WORKOUT_PLAN {
        string id PK
        string templateId FK
        string templateName "v době použití"
        string planDayId FK
        string planDayName "v době použití"
        int replaceWithinDays "v době použití"
        datetime appliedAt
    }
    WORKOUT_PLAN_ITEM {
        string entryId FK "chybí = vynecháno"
        string name
        enum unit
        int quantity
        int sets
        int caloriesPer100Units
        int calories
        object replacement "date + entryId náhrady"
    }

    MEAL_ENTRY }o--o| MEAL_TEMPLATE : "templateId"
    MEAL_TEMPLATE ||--|{ RECIPE_INGREDIENT : "ingredients"
    MEAL_TEMPLATE }o--o{ MEAL_TEMPLATE : "přílohy, podobné"
    MEAL_PHOTO_INDEX ||--|| MEAL_PHOTO : "id"
    MEAL_PHOTO_INDEX }o..o{ MEAL_ENTRY : "název + zdroj"
    CALORIE_LIBRARY }o..o{ MEAL_ENTRY : "znormalizovaný název"
    WORKOUT_TEMPLATE ||--o{ WORKOUT_TEMPLATE_ITEM : "items (volná)"
    WORKOUT_TEMPLATE ||--o{ WORKOUT_PLAN_DAY : "days (plán)"
    WORKOUT_PLAN_DAY ||--|{ WORKOUT_TEMPLATE_ITEM : "items"
    WORKOUT_TEMPLATE_ITEM }o--o| WORKOUT_TEMPLATE : "templateRefId"
    ACTIVITY_ENTRY }o--o| WORKOUT_TEMPLATE : "templateId"
    ACTIVITY_ENTRY }o--o| WORKOUT_PLAN_DAY : "planDayId"
    WORKOUT_PLAN }o--|| WORKOUT_TEMPLATE : "templateId"
    WORKOUT_PLAN }o--o| WORKOUT_PLAN_DAY : "planDayId"
    WORKOUT_PLAN ||--|{ WORKOUT_PLAN_ITEM : "items"
    WORKOUT_PLAN_ITEM |o--o| ACTIVITY_ENTRY : "entryId (odcvičeno)"
    WORKOUT_PLAN_ITEM |o--o| ACTIVITY_ENTRY : "replacement (náhrada)"

Vazby na šablony a plány jsou volné — smazaná šablona v historii zůstane pod názvem uloženým v WORKOUT_PLAN. Záznam použití (workoutPlans) je u plánu zároveň evidence, který den plánu se kdy odcvičil; podle ní se počítá, co je na řadě.

Den: příjem a výdej

Přehled dne má dvě záložky:

• Příjem — co jste snědli, s cenou, gramáží a kaloriemi.
• Výdej — pohyb. Kroky, minuty, sekundy, kilometry nebo opakování; z množství a spotřeby na 100 jednotek se dopočtou spálené kalorie (10 000 kroků ≈ 400 kcal). U silových cviků jde zadat i počet sérií — 3 × 40 kliků se tak neplete se 120 v kuse, i když kalorie vyjdou stejně.

Volitelně se dá k dni zapsat i délka spánku. Slouží jako kontext — do energetické bilance nevstupuje, protože klidový výdej už pokrývá celých 24 hodin včetně spánku a žádná standardní rovnice s délkou spánku nepočítá.

Nahoře je bilance dne: příjem − (klidový výdej + pohyb).

Tréninky a plány

Na stránce Tréninky jsou tři typy:

• Plovoucí plán — sekvence tréninkových dnů (Den 1, Den 2, Den 3…), po které následuje den volna a cyklus se opakuje. Na kalendář navázaný není: další den přijde na řadu, až se splní předchozí. Den volna jde v rámci cyklu jednou posunout dopředu — když uprostřed cyklu den necvičíte, bere se to jako volno a po posledním dni se pokračuje rovnou od začátku (Den 1, Den 2, volno, Den 3, Den 1…). Další necvičený den trénink jen odsune.
• Fixní plán — pevné dny v týdnu (pondělí nohy, středa běh…), ostatní dny jsou volno.
• Volný trénink — seznam cviků na kdykoli (rozcvička, protažení). Jde ho vložit do dne plánu i do jiného volného tréninku; vkládání je jen na jednu úroveň.

Plán se založí jednou a přehled dne pak sám navrhne, co je ten den na řadě. Po odcvičení stačí návrh potvrdit; co se nestihlo, se odškrtne a zapíše jako vynechané. Nad rámec plánu se ručně přidávají jen „unikátnosti" — chůze, kroky, jednorázový běh. Jiný den plánu, než který je na řadě, nebo volný trénink jde založit tlačítkem Z tréninků.

U plánu jde nastavit Nahraditelné během N dní: vynechaný cvik (odškrtnutý při potvrzení nebo smazaný ze dne) se pak v následujících N dnech nabízí v přehledu dne k náhradě. Ve statistikách výdeje se u takového dne místo vykřičníku ukáže šipka na den náhrady. Dny volna ani necvičené dny se ve statistikách nijak nezapisují — zobrazuje se jen to, co proběhlo.

Plán i trénink jde kdykoli vylepšit — přidat cviky, dny, zvýšit zátěž nebo počet opakování. Historie zůstává, jak byla: každé použití si pamatuje, co plán v ten den sliboval.

Založené položky jsou samostatné aktivity, takže je jde v dni doupravit, aniž by se změnil plán. Volný trénink jde vytvořit i opačným směrem — z toho, co už máte v dni zapsané, tlačítkem Uložit jako trénink v záložce Výdej.

Recepty (vařená jídla se surovinami a postupem) jsou rozšířením jídla v seznamu jídel na stránce Jídla.

Osobní údaje

Na stránce Osobní údaje se z pohlaví, roku narození, výšky a hmotnosti spočítá klidový výdej (bazální metabolismus) rovnicí Mifflin–St Jeor. Kdo má hodnotu změřenou přesněji, může ji zadat ručně — ta pak má přednost.

Výpočet se záměrně nenásobí koeficientem fyzické aktivity, jak to dělají kalkulačky TDEE: pohyb si aplikace eviduje zvlášť a přičítá ho, takže vynásobení by ho započítalo dvakrát.

Kalorie a gramáž

Ke každému jídlu jde vyplnit cenu za 100 g a z ní se dopočítá gramáž (u TechToweru typicky 44 Kč/100 g). Gramáž jde kdykoli přepsat ručně a každá položka má vlastní sazbu — hlavní jídlo a salát s jiným cenováním se nepletou. Sazby podniků se nastavují v Nastavení a při výběru zdroje se předvyplní.

Z gramáže a energie na 100 g se pak dopočítají kalorie. Hodnotu nabídne tlačítko Najít kalorie:

• z vlastní knihovny — co jste jednou zadali, aplikace si pamatuje pod názvem jídla a příště nabídne sama,
• z Open Food Facts (otevřená databáze, bez klíče),
• odkazem na KalorickéTabulky.cz, které veřejné API nemají — otevřou se v novém panelu a název jídla se zkopíruje do schránky, hodnotu opíšete ručně.

Když je externí databáze nedostupná, hledání nespadne — zůstane vlastní knihovna.

Import z Luncheru

Na stránce Statistiky je tlačítko Import z Luncheru. Stačí nahrát soubor stažený ze statistik Luncheru:

• Záznamy se rozdělí do dnů, ke kterým patří (export je typicky za celý měsíc).
• Zakládají se jako oběd, protože Luncher řeší výběr obědů. Chod jde při importu změnit a jednotlivá jídla pak upravit v přehledu dne.
• Před uložením se ukáže náhled toho, co se založí.
• Opakovaný import stejného měsíce data nezduplikuje.