🏠Accueil

# 🐙 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éveloppements, 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

- ✓ `git commit -m "Ajout filtre catégorie CRM"`
- ✓ `git commit -m "Fix bug render() surCRM"`
- ✗ `git commit -m "modif"`
- ✗ `git commit -m "fix"`

### 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