Labs pratiques

Lab 1 — NestJS : API REST avec Auth JWT

Durée : 2-3 h · Niveau : intermédiaire · Prérequis : NestJS installé, Module 3 lu · Livrable : module auth avec tests E2E

Setup du contexte

<!-- CLAUDE.md pour ce lab -->
# Lab NestJS Auth

## Stack
- NestJS 10, TypeScript 5.3, TypeORM + PostgreSQL 15
- Passport.js + @nestjs/jwt, class-validator
- Tests : Jest + Supertest

## Conventions
- Architecture : Module / Controller / Service / Repository
- DTOs typés (jamais d'entité retournée directement)
- Erreurs : HttpException avec messages clairs
- IMPORTANT: bcrypt avec cost ≥ 10, jamais de password en clair en mémoire après hash

Phase EXPLORE

Phase PLAN

Phase CODE

Ne dicte pas la structure ligne par ligne. Le plan validé en phase précédente fait foi — la phase CODE applique ce plan, étape par étape, avec validation humaine entre chaque.

Phase VERIFY

Lab 2 — Next.js : Refactoring avec Context Engineering

Durée : 30-45 min · Niveau : intermédiaire · Prérequis : projet Next.js existant, Module 4 lu · Livrable : composant migré Class → Functional + hooks, tests verts

Setup CLAUDE.md

# Lab Next.js Refactoring

## Stack
- Next.js 14 (App Router), TypeScript 5, React 18
- Tailwind CSS 3
- Tests : Vitest + React Testing Library
- State : Zustand (pas de Redux)

## Conventions composants
- Functional components uniquement
- Props interface (pas de type alias) : interface ButtonProps {}
- Export named uniquement (pas de default export pour les composants)
- Fichiers : ComponentName.tsx + ComponentName.test.tsx dans le même dossier

## Anti-patterns à éviter
- Pas de useEffect pour fetch (utiliser React Query ou Server Components)
- Pas de prop drilling > 2 niveaux (utiliser Zustand)
- Pas de inline styles (Tailwind uniquement)

Workflow de refactoring

Lab 3 — Laravel : Migration et Soft Delete

Durée : 30-45 min · Niveau : intermédiaire · Prérequis : Laravel 11 installé, Module 3 lu · Livrable : migration deleted_at, modèle SoftDeletes, tests Pest verts

# CLAUDE.md Laravel

## Stack
- Laravel 11, PHP 8.3
- Eloquent ORM + MySQL 8
- Tests : Pest (pas PHPUnit)
- API Resources pour les réponses

## Conventions
- Repository Pattern (interface + implémentation)
- Form Requests pour la validation
- API Resources pour la transformation
- Soft deletes via SoftDeletes trait Eloquent

## Commandes
php artisan serve      # Dev
php artisan test       # Tests (Pest)
php artisan migrate    # Migrations
./vendor/bin/pint      # Linter

Lab : Implémenter le soft delete sur User

Lab 4 — DevOps : Pipeline CI/CD avec revue IA

Durée : 45-60 min · Niveau : intermédiaire · Prérequis : projet sur GitHub, Module 6 lu · Livrable : workflow .github/workflows/ai-review.yml avec 3 jobs (quality, ai-security-review, changelog)

Lab 5 — Python / FastAPI : endpoint async avec SQLAlchemy 2.x

Durée : 45-60 min · Niveau : intermédiaire · Prérequis : projet FastAPI, Module 3 lu · Livrable : endpoint POST /articles async + tests pytest verts

Stack : Python 3.12, FastAPI 0.115+, SQLAlchemy 2.x async, Pydantic v2

Setup du contexte

# CLAUDE.md (extrait spécifique au lab)

## Stack
- Python 3.12, FastAPI 0.115+
- SQLAlchemy 2.x **async** uniquement (pas de Session synchrone)
- Pydantic v2 pour les schémas
- pytest + pytest-asyncio + httpx pour les tests

## Conventions
- Fichiers par feature : `app/<feature>/{router,schemas,models,service}.py`
- Routes ne contiennent JAMAIS de logique métier — tout passe par `service.py`
- Dépendances FastAPI : injection via `Depends()`, jamais de globals
- Async partout : pas de `requests`, utiliser `httpx.AsyncClient`

## Tests
- Une base SQLite en mémoire par test
- Fixtures dans `conftest.py`, factory-boy pour les seeds
- Marker `@pytest.mark.asyncio` obligatoire sur les tests async

## Anti-patterns
IMPORTANT: SQLAlchemy 2.x style uniquement (`Mapped`, `mapped_column`, `select().where()`) — pas de raw SQL ni de syntaxe v1.

Phase EXPLORE

Phase PLAN

Phase CODE

Phase VERIFY

Lab 6 — Production Incident Response avec Sentry MCP

Durée : 30-45 min · Niveau : senior · Prérequis : projet en prod connecté à Sentry, MCP Sentry configuré · Livrable : PR avec fix + test + post-mortem une page

Apprendre à utiliser Claude Code en mode incident commander : récupérer les infos Sentry, formuler une hypothèse, valider, proposer un fix, documenter le post-mortem.

Setup MCP

// .claude/settings.json
{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "@sentry/mcp-server"],
      "env": {
        "SENTRY_AUTH_TOKEN": "${env:SENTRY_AUTH_TOKEN}",
        "SENTRY_ORG": "my-org",
        "SENTRY_PROJECT": "api"
      }
    }
  }
}

Phase 1 — Capture

Phase 2 — Triage

Phase 3 — Fix

Phase 4 — Post-mortem

Ressources complémentaires

Templates à reprendre

Le Starter Pack du playbook est sur la page dédiée /templates : un fichier de contexte (AGENTS.md) qui marche pour tous les outils, une configuration Claude Code avec des permissions sécurisées par défaut, un hook qui bloque l'écriture de fichiers contenant des secrets, et trois slash commands (/audit-security, /test-gen, /release-notes). Tout est aligné avec les modules 3, 4, 5 et 8.

Pour le reste — Skills spécialisés, serveurs MCP, agents prêts à l'emploi — le catalogue de référence est aitmpl.com. C'est un catalogue communautaire de plus de 1000 composants pour Claude Code, soutenu par Vercel, Neon et Anthropic. La page Templates signale les composants qu'on recommande spécifiquement.