Git & GitHub

Gitflow Harambee

Script 1 — Initialisation du dépôt

Exécuter une seule fois pour initialiser le projet Harambee sur GitHub.

# ── INIT Harambee GIT ──────────────────────────────────────────
# Prérequis : Git installé, GitHub CLI (gh) configuré
# Exécuter depuis : C:\xampp\htdocs\WARA\laravel\

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

# Naviguer dans le dossier Laravel
cd C:\xampp\htdocs\WARA\laravel

# Initialiser git et configurer l'identité
git init
git config user.name  "Blesh Harambee"
git config user.email "serilo@looky.org"

# Créer .gitignore Laravel standard
Add-Content .gitignore "/vendor`n/node_modules`n.env`n.env.*`n!.env.example`n/storage/*.key`n/public/build"

# Premier commit sur main
git add .
git commit -m "chore(init): initialisation projet Harambee Laravel 11"

# Créer et pousser vers GitHub
gh repo create Blesh-Lab/Harambee --private --source=. --remote=origin --push

# Créer la branche develop
git checkout -b develop
git push origin develop

Write-Host "✅ Dépôt Harambee initialisé avec succès !" -ForegroundColor Green

Script 2 — Workflow quotidien (feature)

# ── NOUVELLE FEATURE ───────────────────────────────────────
# Usage : .\new_feature.ps1 auth-kyc

param(
  [Parameter(Mandatory=$true)]
  [string]$FeatureName
)

cd C:\xampp\htdocs\WARA\laravel

# S'assurer d'être à jour sur develop
git checkout develop
git pull origin develop

# Créer la branche feature
git checkout -b "feature/$FeatureName"
Write-Host "✅ Branche feature/$FeatureName créée" -ForegroundColor Cyan

# ... développement ...
# Quand la feature est prête :

git add .
git status

$msg = Read-Host "Message de commit (type(scope): description)"
git commit -m $msg
git push origin "feature/$FeatureName"

# Ouvrir une Pull Request sur GitHub
gh pr create --base develop --title "[$FeatureName] $(git log -1 --pretty=%s)" --body "## Changements

- [ ] Tests passants
- [ ] Charte graphique respectée
- [ ] OWASP vérifié

## Comment tester"

Write-Host "✅ Pull Request créée sur GitHub !" -ForegroundColor Green

Script 3 — Release

# ── RELEASE Harambee ───────────────────────────────────────────
# Usage : .\release.ps1 1.0.0

param([string]$Version = "1.0.0")

cd C:\xampp\htdocs\WARA\laravel

# Créer la branche release
git checkout develop
git pull origin develop
git checkout -b "release/v$Version"

# Mettre à jour le numéro de version
(Get-Content config/app.php) -replace "'version' => '.*'", "'version' => 'v$Version'" |
  Set-Content config/app.php

git add config/app.php
git commit -m "chore(release): bump version to v$Version"

# Merger dans main et taguer
git checkout main
git merge "release/v$Version" --no-ff -m "chore(release): merge release/v$Version into main"
git tag -a "v$Version" -m "Release v$Version"
git push origin main --tags

# Synchroniser develop
git checkout develop
git merge "release/v$Version" --no-ff -m "chore(release): back-merge v$Version to develop"
git push origin develop

# Créer la GitHub Release
gh release create "v$Version" --title "Harambee v$Version" --generate-notes

Write-Host "🚀 Release v$Version publiée !" -ForegroundColor Green

Conventional Commits

Format : type(scope): description courte

Pipeline GitHub Actions

name: Harambee CI

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [develop]

jobs:
  test:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_DB: wara_test
          POSTGRES_USER: wara
          POSTGRES_PASSWORD: secret
        ports: ["5432:5432"]

    steps:
      - uses: actions/checkout@v4
      - uses: shivammathur/setup-php@v2
        with:
          php-version: '8.2'
          coverage: xdebug

      - name: Install dependencies
        run: composer install --no-interaction --prefer-dist

      - name: Copy .env
        run: cp .env.testing .env && php artisan key:generate

      - name: Run tests with coverage
        run: php artisan test --coverage --min=80

      - name: PHP CS Fixer (PSR-12)
        run: vendor/bin/php-cs-fixer fix --dry-run --diff