🐙GitHub

Jouw computer                           GitHub (cloud)
──────────────────────────────────────────────────────
Working Directory                       Remote Repository
  ↓ git add                               ↑ git push
Staging Area (Index)                    Origin/main
  ↓ git commit                            ↑
Local Repository ─────────────────────────
  ← git pull (fetch + merge)
  ← git fetch (alleen downloaden, nog niet samenvoegen)

# Configureer je naam en email (eenmalig)
git config --global user.name "Jouw Naam"
git config --global user.email "jij@email.be"
git config --global core.editor "code --wait"  # VS Code als editor

# Genereer SSH sleutel (veiliger dan wachtwoord)
ssh-keygen -t ed25519 -C "jij@email.be"
# Druk Enter (accepteer standaardlocatie)

# Kopieer je publieke sleutel
cat ~/.ssh/id_ed25519.pub
# Ga naar GitHub → Settings → SSH Keys → New SSH Key
# Plak de output hierboven

# Test de verbinding
ssh -T git@github.com

# Optie A: Start lokaal, push naar GitHub
mkdir mijn-project && cd mijn-project
git init
git branch -M main  # Zorg dat hoofdbranch 'main' heet

# Optie B: Start vanuit GitHub (aanbevolen)
# Maak repo aan op github.com → "New Repository"
# Vink "Add README" aan, kies licentie
git clone git@github.com:gebruiker/mijn-project.git
cd mijn-project

# Afhankelijkheden
node_modules/
.pnp
.pnp.js

# Build output
.next/
out/
dist/
build/

# Environment variabelen — NOOIT uploaden!
.env
.env.local
.env.development.local
.env.test.local
.env.production.local
*.env

# Vercel deployment cache
.vercel

# Logs
npm-debug.log*
yarn-error.log

# OS bestanden
.DS_Store
Thumbs.db

# IDE bestanden
.vscode/settings.json
.idea/

# Voeg alle bestanden toe (behalve wat in .gitignore staat)
git add .

# Controleer wat er toegevoegd wordt
git status

# Eerste commit maken
git commit -m "feat: initieel project met basisstructuur"

# Verbind lokale repo met GitHub remote
git remote add origin git@github.com:gebruiker/mijn-project.git

# Push naar GitHub (-u instelt tracking voor toekomstige pushes)
git push -u origin main

# Daarna is gewoon 'git push' genoeg

── STAP 1: Haal altijd de laatste versie op voordat je begint ──
git checkout main
git pull origin main

── STAP 2: Maak een beschrijvende feature branch ──
git checkout -b feature/betalingssysteem-stripe
# of: git switch -c feature/betalingssysteem-stripe (moderne syntax)

── STAP 3: Werk aan de feature (meerdere kleine commits) ──
# ... code schrijven met Claude Code ...
git add .
git commit -m "feat: voeg Stripe checkout integratie toe"
# ... meer code ...
git add .
git commit -m "feat: voeg webhook handler toe voor betalingsbevestiging"

── STAP 4: Push branch naar GitHub ──
git push -u origin feature/betalingssysteem-stripe

── STAP 5: Maak Pull Request aan op GitHub (of via CLI) ──
gh pr create --title "feat: Stripe betalingssysteem" --body "Voegt Stripe toe voor..."

── STAP 6: Na review en goedkeuring: Merge naar main ──
gh pr merge --squash  # Squash: alle commits samenvoegen tot één

── STAP 7: Opruimen ──
git checkout main
git pull origin main
git branch -d feature/betalingssysteem-stripe  # Verwijder lokale branch
git push origin --delete feature/betalingssysteem-stripe  # Verwijder remote branch

# Conflict treedt op bij merge/pull:
git pull origin main
# CONFLICT (content): Merge conflict in src/app.js

# Bekijk welke bestanden conflicten hebben:
git status
# both modified: src/app.js

# Open het bestand — conflict markers zien er zo uit:
# <<<<<<< HEAD (jouw versie)
# const greeting = "Hallo wereld";
# =======
# const greeting = "Hello world";
# >>>>>>> origin/main (hun versie)

# Laat Claude Code het conflict oplossen:
> Er is een merge conflict in src/app.js. Los het op door
  de beste versie te kiezen of de twee samen te voegen.

# Nadat je het bestand hebt opgeslagen:
git add src/app.js
git commit -m "fix: los merge conflict op in greeting string"

# Maak een versie-tag (semantic versioning: major.minor.patch)
git tag -a v1.0.0 -m "Release 1.0.0: productie launch"
git push origin v1.0.0

# Alle tags zien:
git tag -l

# GitHub Release aanmaken via CLI:
gh release create v1.0.0 --title "v1.0.0 — Productie Launch" \
  --notes "Eerste stabiele release met alle core features"

name: CI/CD Pipeline

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

env:
  NODE_VERSION: '20'

jobs:
  quality:
    name: Kwaliteitscheck
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: ${{ env.NODE_VERSION }}
          cache: 'npm'  # Cache npm voor snellere runs

      - name: Installeer dependencies
        run: npm ci  # ci is sneller en deterministischer dan install

      - name: TypeScript check
        run: npx tsc --noEmit

      - name: Linting
        run: npm run lint

      - name: Unit tests
        run: npm test -- --ci --coverage

      - name: Build productie
        run: npm run build
        env:
          NEXT_PUBLIC_API_URL: ${{ secrets.NEXT_PUBLIC_API_URL }}

  security:
    name: Security Scan
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Audit npm packages
        run: npm audit --audit-level=high
      - name: Claude Code Security Review
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Review deze code wijzigingen op beveiligingsproblemen. Focus op OWASP top 10."

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
  issue_comment:
    types: [created]

jobs:
  claude-review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          direct_prompt: |
            Review deze PR op:
            - Beveiligingsproblemen (SQL injectie, XSS, auth lekken)
            - Performance issues
            - Code kwaliteit en leesbaarheid
            - Ontbrekende error handling
            Geef inline PR comments in het Nederlands.