flowdeck/BRANCHING.md

Stratégie de branches — FlowDeck

Structure

main       ──●────────────●────── production (tags vX.Y.Z)
              \          /
develop       ●──●──●──●────── intégration continue
                  \  \  \
feat/xxx          ●  ●  ●──── feature branches
fix/xxx           ●─────────── hotfix branches

Branches

Branche	Rôle	Déploiement	Protection
main	Production	Docker auto sur :8080	Push direct interdit, PR only
develop	Intégration	Staging (optionnel)	Push direct interdit, PR only
feat/<nom>	Nouvelle feature	Aucun	Libre
fix/<nom>	Correctif urgent	Aucun	Libre

Workflow quotidien

1. Démarrer une feature

git checkout develop
git pull origin develop
git checkout -b feat/ma-feature

2. Travailler

# Coder, commit souvent
git add -A
git commit -m "feat: description claire de ce qui est fait"
git push origin feat/ma-feature

3. Créer une Pull Request

Aller sur https://git.dracodev.net/bruno/flowdeck/pulls

• Base : develop
• Head : feat/ma-feature
• Titre : descriptif
• Assigner un reviewer si applicable

4. Après merge

git checkout develop
git pull origin develop
git branch -d feat/ma-feature  # supprimer la branche locale

Release (develop → main)

# 1. S'assurer que develop est prêt
git checkout develop
git pull origin develop

# 2. Créer une PR develop → main sur Gitea
#    (ou merger localement si admin)
git checkout main
git merge develop
git tag v4.0.1
git push origin main --tags

Hotfix urgent

git checkout main
git checkout -b fix/urgence
# ... corriger ...
git commit -m "fix: description"
git push origin fix/urgence
# PR fix/urgence → main
# PUIS merger main → develop pour synchroniser
git checkout develop
git merge main
git push origin develop

Conventions de commits

Préfixe	Usage	Exemple
feat:	Nouvelle fonctionnalité	feat: landing page for visitors
fix:	Correction de bug	fix: redirect loop on /
refactor:	Restructuration sans changement fonctionnel	refactor: extract sidebar_data
test:	Ajout/modification de tests	test: onboarding flow e2e
docs:	Documentation	docs: update ROADMAP.md
style:	Formatage, CSS	style: mobile sidebar fixes
chore:	Tâches de maintenance	chore: bump version to 4.0.1

Règles

1. Jamais de push direct sur main — toujours via PR depuis develop ou fix/*
2. Jamais de push direct sur develop — toujours via PR depuis feat/* ou fix/*
3. Une branche = une feature / un fix — éviter les branches fourre-tout
4. Tests passent avant merge — CI Gitea Actions doit être verte
5. Commit + push après chaque modification significative
6. Nom de branche en kebab-case : feat/landing-page, fix/login-redirect
7. Supprimer la branche après merge (sauf main et develop)