🏠Accueil
Init Workflow Commandes Règles Résolution

🐙 Guide Git & Gitea - H3R7Tech

Ce guide détaille les bonnes pratiques pour utiliser Git avec Gitea sur le VPS H3R7Tech.

⚙️ 1. Configuration Initiale

Configurer Git

git config --global user.name "H3R7"
git config --global user.email "h3r7@tech.local"
git config --global init.defaultBranch master
git config --global pull.rebase false

Cloner un Repo

# Via HTTPS (recommandé pour automate)
git clone /gitea/admin/h3r7tech.git

# Via SSH (pour developement)
git clone git@178.18.250.53:admin/h3r7tech.git

🔄 2. Workflow Standard

💡 Règle d'or: Toujours travailler sur la branche dev pour les développe­ments, puis fusionner vers master pour la production.

Schéma du Workflow

master (production)
   ↑
   └── dev (développement)
         ↑
         └── feature/xyz (nouvelle功能)

Créer une Feature

# 1. Se placer sur dev
git checkout dev

# 2. Mettre à jour dev
git pull origin dev

# 3. Créer une branche feature
git checkout -b feature/nom-feature

# 4. Travailler sur la功能...
git add .
git commit -m "Description claire du changement"

# 5. Pousser sur Gitea
git push origin feature/nom-feature

⌨️ 3. Commandes Essentielles

Action Commande
Statut actuel git status
Voir les changements git diff
Ajouter fichiers git add .
Commit avec message git commit -m "message"
Voir historique git log --oneline -10
Basculer branche git checkout nom-branche
Fusionner dev → master git checkout master && git merge dev
Annuler dernier commit git reset --soft HEAD~1

📋 4. Règles de Bon Usage

Messages de Commit

Fréquence de Push

Push fréquent: Au moins 1x/jour ou à chaque功能 complète.

Protection Branches

Branche Règle
master lecture seule, push via merge depuis dev uniquement
dev push autorisé après tests locaux
feature/* push fréquent, supprimée après merge

🔧 5. Résolution des Conflits

⚠️ Avant un merge: Toujours pull la dernière version!

En cas de conflit

# 1. Mettre à jour dev
git checkout dev
git pull origin dev

# 2. Fusionner dans votre branche
git checkout feature/ma-branche
git merge dev

# 3. Résoudre les conflits manuellement
# (éditer les fichiers en conflit)

# 4. Ajouter les fichiers résolus
git add .
git commit -m "Résolution conflits merge dev"
git push origin feature/ma-branche

Méthode Alternative: Rebase

#Instead de merge, utiliser rebase pour historique propre
git checkout feature/ma-branche
git rebase dev

📝 6. Exemple Pratique

Modifier le CRM sur le VPS

# Connexion SSH
ssh -i /path/to/key h3r7@178.18.250.53

# Aller dans le dossier projet
cd /home/h3r7

# Bas/turf_scraperculer sur dev
git checkout dev

# Mettre à jour
git pull origin dev

# Créer branche pour la功能
git checkout -b fix/crm-filtre

# ... Faire les modifications ...

# Commit
git add crm_dashboard.html
git commit -m "Corrige filtre catégorie CRM"

# Pousser
git push origin fix/crm-filtre

Créer une Pull Request

  1. Aller sur Gitea
  2. Cliquer sur "Pull Requests" → "New Pull Request"
  3. Sélectionner: fix/crm-filtre → dev
  4. Décrire les changements
  5. Valider le merge après review

🛠️ 7. Accès Rapides

Service URL
Gitea /gitea/
Repo H3R7Tech /gitea/admin/h3r7tech
CRM Prod /crm/
CRM Dev /crm/
Dashboard Turf /turf/

Guide Git & Gitea - H3R7Tech © 2026

🐾 Version 1.0