Git workflow

Firemní konvence pro práci s Gitem v Etnetera.

Větve (branches)

Používáme GitFlow s těmito typy větví:

Větev	Popis	Příklad
main	Produkční kód	—
develop	Integrační větev	—
feature/*	Nová funkcionalita	feature/user-login
fix/*	Oprava chyby	fix/null-pointer-crash
hotfix/*	Kritická oprava produkce	hotfix/payment-failure
release/*	Příprava vydání	release/2.5.0

Commit zprávy

Používáme Conventional Commits:

<typ>(<oblast>): <popis>

[volitelné tělo]

[volitelné poznámky]

Typy commitů

Typ	Popis
feat	Nová funkce
fix	Oprava chyby
docs	Pouze dokumentace
style	Formátování, mezery (bez změny logiky)
refactor	Refaktoring bez nové funkce či opravy
test	Přidání nebo úprava testů
chore	Údržba, závislosti, CI

Příklady

feat(auth): přidat přihlášení přes Google OAuth

fix(api): opravit chybu při prázdném těle požadavku

docs(readme): aktualizovat instrukce pro instalaci

Merge Request (MR)

1. Větev odeberte z develop (nebo main pro hotfixy)
2. Pushněte a vytvořte MR v GitLabu
3. Přidejte popis — co a proč
4. Označte minimálně 1 reviewera z týmu
5. CI musí být zelené před mergem
6. MR merguje autor po schválení (ne reviewer)

Pravidlo

Nikdy nepushujte přímo do main nebo develop. Vždy přes MR.

Konfigurace Gitu

Nastavte si identitu před prvním commitem:

git config --global user.name "Vaše Jméno"
git config --global user.email "jmeno@etnetera.cz"
git config --global core.editor "code --wait"   # VS Code

Časté příkazy

# Nová větev
git checkout -b feature/moje-funkce develop

# Synchronizace s develop
git fetch origin
git rebase origin/develop

# Interaktivní rebase (úklid commitů před MR)
git rebase -i origin/develop