Programátorský slovníček

Git je program, který si pamatuje každou uloženou verzi kódu — jako kdyby automaticky ukládal celou historii dokumentu, ke které se lze kdykoliv vrátit.

repozitář repository, „repo“

Celý projekt i s historií změn. dailyMat je jeden repozitář — obsahuje frontend, backend i každou verzi, kterou kdy měl.

commit

Jedno uložené „zastavení“ v historii — balíček změn s popiskem, co a proč se změnilo. Jako záložka v knize s poznámkou na okraji.

Příklad„fix(ai): vyhnout se DeepSeek peak-valley cenám ve schedulerech (v1.5.4)“ — jeden commit, jedna uzavřená myšlenka.

branch větev

Paralelní kopie projektu, na které lze zkoušet věci, aniž by se sáhlo na tu „živou“ verzi. Až je změna hotová, větev se spojí zpátky.

PříkladNež se mazaly staré větve, měl repozitář jich 27. Po úklidu zůstala jen main.

main

Konvenční název pro tu „hlavní“, oficiální větev — to, co reálně běží na produkci.

checkout

Přepnutí na jinou větev — soubory na disku se přepíšou na verzi, jaká na té větvi je.

HEAD

Ukazatel na to, „kde právě jsi“ v historii — obvykle na špičce rozkliknuté větve.

staging git add

Krok před commitem: „tyhle změny chci zahrnout do dalšího uloženého bodu.“ Umožňuje uložit jen část rozdělané práce.

Tahle část si dnes zasloužila nejvíc detektivní práce — GitHub totiž větve „schovává“ jinak, než jak je git standardně pozná.

merge

Spojení dvou větví do jedné — git vezme změny z obou a poskládá je dohromady.

konflikt merge conflict

Nastane, když dvě větve upravily ten samý řádek jinak a git si sám neumí vybrat správnou verzi — musí to rozhodnout člověk.

PříkladKonflikt v version.ts — jedna větev chtěla „1.5.3“, druhá „1.5.4“. Zůstalo vyšší číslo.

fast-forward

Nejjednodušší merge: jedna větev je jen „napřed“ oproti druhé, takže git nemusí nic slévat — jen posune ukazatel dopředu.

squash merge

Funkce GitHubu: při mergnutí Pull Requestu slije všechny jeho commity do jednoho nového commitu na main. Git pak neumí poznat, že práce z původní větve už je „uvnitř“ — vypadá jako cizí, nesouvisející historie.

PříkladProto git branch --merged ukázal jen 14 z 26 větví jako hotové — zbytek byl smazaný skrz squash a git to bez ruční kontroly nepoznal.

cherry-pick

„Vezmi jeden konkrétní commit odjinud a přehraj ho na mou současnou větev.“ Použito k dotažení dvou starých rozpracovaných funkcí bez nutnosti řešit zbytek zastaralé historie té větve.

Příkladgit cherry-pick origin/claude/determined-ptolemy-f748e9 — přeneslo komponentu iOS banneru na aktuální main.

společný předek merge-base

Poslední commit, který mají dvě větve ještě společný — bod, kde se jejich historie „rozdvojila“.

Počítač má vlastní, lokální kopii historie. GitHub drží druhou, sdílenou kopii. Tyto pojmy popisují, jak se ty dvě kopie sesynchronizují.

remote origin

Přezdívka pro vzdálenou kopii repozitáře — v tomto případě GitHub.

push

Odeslání lokálních commitů na GitHub, aby je viděl i někdo/něco jiného (třeba deploy robot).

fetch

Stažení nejnovějších informací z GitHubu — bez zásahu do souborů. Jen „podívej se, co je nového“.

pull

fetch + rovnou i merge do aktuální větve v jednom kroku.

worktree

Další, samostatná složka na disku napojená na stejný repozitář, ale s jinou větví rozkliknutou — aby mohlo víc „session“ pracovat na různých větvích současně.

PříkladV .claude/worktrees/ zbylo 6 opuštěných složek ze starších session — po ověření, že v nich nic nechybí, byly smazané.

patch .patch soubor

Obyčejný textový soubor popisující „tohle přesně se změnilo“ — dá se kdykoliv znovu použít, i mimo git.

PříkladNež se smazala rozdělaná práce ve worktree, zazálohovala se jako .patch soubor — nic se tak nemohlo ztratit.

Pull Request PR

Formální návrh „prosím, spoj tuhle větev do main“ na GitHubu, s prostorem pro komentáře a review.

PříkladPR #79 a #66 čekaly nedotčené od května — po dokončení je GitHub sám zavřel, jakmile zmizely jejich zdrojové větve.

GitHub Actions

Robot GitHubu, který umí automaticky spouštět skripty při určité události — třeba „pokaždé, když někdo pushne do main“.

workflow CI/CD

Konkrétní automatizovaný „recept“, který Actions spouští — u DailyMatu se jmenuje Deploy a stará se o vydání nové verze na server.

deploy nasazení

Skutečné vydání nové verze kódu na živý server, aby ji reálně používali uživatelé — automaticky po každém pushnutí do main.

systemd

Systém ve Linuxu, který hlídá běžící programy na serveru — spustí je, restartuje po pádu, drží je „vždy zapnuté“.

SSH

Zabezpečený způsob, jak se z počítače vzdáleně přihlásit na server a spouštět tam příkazy.

funkce function

Pojmenovaný kousek kódu, který dělá jednu konkrétní věc a dá se odkudkoliv zavolat, kolikrát je potřeba.

PříkladisPeakPricingHour() — funkce, co vrátí ano/ne podle toho, jestli je zrovna drahá hodina u DeepSeeku.

proměnná / konstanta const

Pojmenovaná „přihrádka“ na hodnotu. const znamená, že se do ní jednou něco uloží a pak už se nepřepíše.

import / export

Jak si soubory s kódem mezi sebou půjčují funkce. export = smí to používat i ostatní soubory, import = chci si to od nich vypůjčit.

TypeScript

Vylepšený JavaScript, který navíc hlídá, jaký typ dat (text, číslo, ano/ne…) smí být kde použitý — spoustu chyb tak odhalí dřív, než se kód vůbec spustí.

typecheck tsc --noEmit

Spuštění TypeScriptové kontroly „sedí to všechno na sebe?“ bez reálného sestavení spustitelné aplikace — rychlý test po každé úpravě.

interface / typ

Popis „tvaru“ dat — např. objekt, který má vždy pole text a číslo promptTokens.

try / catch

„Zkus tohle udělat; pokud to selže, neshoď celou aplikaci, ale ošetři to.“ Používá se všude, kde může něco reálně selhat — třeba volání na cizí server.

API

Dohodnutý způsob, jak spolu dva programy „mluví“. Backend DailyMatu používá DeepSeekovo API, aby mu poslal zadání a dostal zpátky napsaný text.

endpoint

Jedna konkrétní „adresa“, kterou API nabízí pro jednu konkrétní věc.

Příklad/suggest-keywords — endpoint, který AI požádá o návrh tagů pro web.

scheduler

Kus kódu, který sám, bez zásahu člověka, spouští nějakou úlohu pravidelně dokola.

PříkladEditorial scheduler běžel každou hodinu 24/7 — proto ho zasáhly i drahé DeepSeek hodiny, které se opravovaly.

interval / tick

Technický způsob „spouštěj tohle každých N sekund“. Jedno spuštění se běžně říká „tick“.

proměnná prostředí environment variable, .env

Citlivá hodnota (třeba API klíč) nebo nastavení, které se drží mimo samotný kód a dodá se programu až při spuštění — aby se klíč nikdy neocitl v gitu.

databáze / SQL dotaz

Místo, kde appka trvale ukládá data (články, uživatele…). SQL je jazyk, kterým se jí říká, co se má uložit, najít nebo změnit.

komponenta component

Samostatný, znovupoužitelný kousek uživatelského rozhraní — má vlastní vzhled i chování.

PříkladIosBanner.tsx — celá bublina „přidej si nás na plochu“ je jedna komponenta.

hook useState, useEffect

Vestavěné nástroje Reactu. useState = komponenta si něco pamatuje. useEffect = spusť tenhle kód, když se stránka načte nebo něco změní.

state

Data, která si komponenta pamatuje a která se mohou v čase měnit — při jejich změně se rozhraní samo překreslí.

props

Data, která komponenta dostane „zvenčí“, od té komponenty, co ji používá.

localStorage

Malé úložiště přímo v prohlížeči, které přežije i zavření záložky — díky němu si třeba banner pamatuje, že ho uživatel už jednou zavřel.

token

Malý kousek textu, ve kterém AI model čte i píše. DeepSeek účtuje podle počtu tokenů, ne podle znaků nebo slov.

model AI model

Konkrétní „mozek“, který se volá — má své jméno, cenu a schopnosti.

clustering

Automatické seskupení podobných článků podle tématu, aby AI napsala jeden vyčerpávající článek místo pěti skoro stejných.

embedding

Způsob, jak převést text na řadu čísel, díky kterým počítač umí matematicky poměřit, jak moc si dva texty „významově“ odpovídají — základ pro clustering.

pipeline

Pevná posloupnost kroků zpracování za sebou: sběr → clustering → psaní článků → briefing.

peak-valley pricing

Konkrétní cenový model, kdy je ve „špičkových“ hodinách stejné volání API dvakrát dražší než mimo špičku.

version bump semver

Zvýšení čísla verze podle vzorce major.minor.patch (např. 1.5.4 → 1.5.5). Poslední číslo se zvedá u drobných oprav.

konvenční commity feat:, fix:, chore:

Domluvený způsob psaní zpráv u commitů, který na první pohled řekne, o jaký typ změny jde.