Workflow: PR, review, Conventional Commits
GitHub Flow, pull request-uri bune, mesaje standard și semver.
Actualizat
Ce este un workflow
Un workflow e felul în care o echipă își organizează branch-urile, review-ul și livrarea. Cel mai folosit azi pentru aplicații web — și cel pe care îl folosește Vercel nativ — e GitHub Flow.
GitHub Flow, pas cu pas
maine mereu deployabil.- Pentru orice schimbare, creezi un branch din
main. - Faci commit-uri și push.
- Deschizi un Pull Request (PR).
- CI rulează automat (lint, teste, build) + Vercel creează un preview deploy cu URL propriu.
- Colegii fac review.
- Merge în
main→ deploy automat în producție.
Tipuri de workflow — comparație
| Workflow | Cum arată | Când |
|---|---|---|
| GitHub Flow | main + branch-uri scurte + PR |
aplicații web cu deploy continuu — implicit |
| Trunk-based | toți fac commit-uri mici direct (sau aproape) pe main, cu feature flags |
echipe mature, CI foarte bun |
| Git Flow | main, develop, release/*, hotfix/* |
produse cu versiuni lansate rar (aplicații desktop, librării) — greoi pentru web |
Un Pull Request bun
- Mic — sub ~400 de linii modificate; review-urile mari devin superficiale.
- Titlu clar + descriere: ce, de ce, cum ai testat, capturi de ecran pentru UI.
- Un singur subiect — nu amesteca un refactor cu un feature.
- CI verde înainte de a cere review.
Conventional Commits
Un format standard pentru mesaje, citibil de oameni și de unelte:
<tip>(<zonă opțională>): <descriere>
feat(cart): adaugă cupoane de reducere
fix: rotunjește corect totalul cu TVA
docs: actualizează README
refactor(auth)!: elimină sesiunile vechi ← ! = breaking change
| Tip | Pentru |
|---|---|
feat |
funcționalitate nouă |
fix |
bug rezolvat |
docs |
documentație |
refactor |
cod restructurat, fără schimbare de comportament |
test |
teste |
chore |
dependențe, configurări, unelte |
perf |
performanță |
Bonus: din ele se poate genera automat changelog-ul și versiunea (semver): fix → patch (1.0.1), feat → minor (1.1.0), ! → major (2.0.0).
Unelte care țin calitatea
- CI (GitHub Actions): rulează lint, typecheck, teste, build la fiecare PR.
- Branch protection pe
main: interzice push direct, cere review + CI verde. - Pre-commit hooks (lefthook, husky): rulează lint/format înainte de commit.
Pe scurt
- GitHub Flow: branch → PR → CI + preview → review → merge → deploy.
- PR-uri mici, cu context; Conventional Commits pentru mesaje.
- Protejează
main: CI + review obligatorii.