GitHub Actions : les bases

# .github/workflows/ci.yml
name: CI                          # Nom du workflow (affiché dans GitHub)

on:                               # QUAND déclencher
  push:
    branches: [main]              # A chaque push sur main
  pull_request:
    branches: [main]              # A chaque PR vers main

jobs:                             # QUOI exécuter
  build:                          # Nom du job
    runs-on: ubuntu-latest        # Machine virtuelle

    steps:                        # Étapes séquentielles
      - uses: actions/checkout@v4 # 1. Récupérer le code
      - uses: actions/setup-node@v4
        with:
          node-version: 20        # 2. Installer Node.js
      - run: npm ci               # 3. Installer les dépendances
      - run: npm run lint         # 4. Linter
      - run: npm run build        # 5. Build

# Triggers les plus utilisés :
on:
  push:                    # A chaque push
    branches: [main, dev]  # Sur ces branches uniquement

  pull_request:            # A chaque PR
    branches: [main]

  workflow_dispatch:       # Déclenchement manuel (bouton dans GitHub)

  schedule:                # Planifié (cron)
    - cron: '0 0 * * 1'   # Chaque lundi à minuit

jobs:
  lint:                    # Job 1 : lint
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm run lint

  build:                   # Job 2 : build (parallèle au lint)
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm run build

  deploy:                  # Job 3 : déployer APRES lint et build
    needs: [lint, build]   # Attend que les 2 jobs précédents passent
    runs-on: ubuntu-latest
    steps:
      - run: echo "Déploiement..."

steps:
  # Step avec une action GitHub (uses:)
  - uses: actions/checkout@v4     # Action pré-faite par GitHub
    with:
      fetch-depth: 0              # Paramètre de l'action

  # Step avec une commande (run:)
  - name: Installer les dépendances  # Nom affiché dans les logs
    run: npm ci

  # Step multi-lignes
  - name: Build et vérification
    run: |
      npm run build
      echo "Build terminé avec succès"

# Mettre en cache node_modules pour gagner du temps
steps:
  - uses: actions/checkout@v4
  - uses: actions/setup-node@v4
    with:
      node-version: 20
      cache: 'npm'           # Cache automatique de npm
  - run: npm ci              # Utilise le cache si disponible

# Statuts possibles :
# Vert (success) : tout est passé
# Rouge (failure) : un step a échoué
# Jaune (in progress) : en cours d'exécution
# Gris (cancelled) : annulé manuellement

# Chaque PR affiche le statut de la CI :
# "All checks have passed" ou "Some checks were not successful"