Axe 11 — Qualité & tests

🎯 Objectif global : produire un code lisible, testé, maintenable que d’autres pourront reprendre sans douleur.

Tests dans les axes précédents — où est la frontière

Tu as déjà vu des tests dans les axes 7 (Vitest+Testing Library), 8 (pytest, Pest, Vitest+supertest) et 6.1 (premiers Vitest sans framework).

• Axes 6-7-8 : tests comme outil quotidien — assert simple, golden path, 1-2 edge cases.
• Axe 11 (ici) : tests comme discipline — pyramide testing, TDD, mocks/stubs/fakes, contract testing, mutation testing, golden set, coverage significatif.

Si tu n’as jamais écrit un test, va d’abord faire 1.1 et 6.1 — reviens ici quand tu as 5–10 tests à ton actif.

Prérequis

Axes 6 et 8.

Objectifs

À l'issue de cet axe, tu sauras :

• Appliquer Clean Code, SOLID, DRY/KISS/YAGNI sans dogmatisme
• Écrire des tests unitaires avec Vitest/Jest et Testing Library
• Mettre en place des tests d'intégration sur DB éphémère (Testcontainers)
• Couvrir un parcours critique en E2E avec Playwright
• Configurer ESLint v9, Prettier, TypeScript strict en équipe
• Rédiger un README, CHANGELOG, ADR de qualité professionnelle

Contenu de l’axe

11.1 — Bonnes pratiques Clean Code, SOLID, DRY/KISS/YAGNI, naming, code smells, code review, conventional commits.

11.2 — Tests Pyramide, TDD/BDD, Vitest, Pest, Playwright, mocks, fixtures, couverture, Testcontainers.

11.3 — Outils statiques ESLint v9, Prettier, Biome, TypeScript strict, PHPStan, Ruff, mypy, pre-commit hooks.

11.4 — Documentation README, ADR, CHANGELOG, OpenAPI auto, Storybook, Mermaid, Diátaxis.

Projet de l’axe

Refactor + tests — tasky-pricing — un module de calcul de prix volontairement catastrophique (80 lignes spaghetti, magic numbers, any, 0 test) que tu refactores en suivant la démarche pro : caractériser, outiller, découper en 6 modules cohérents, tester à 100 %, documenter par ADR.

📁

Exercice · Refactor + tests — démarche professionnelle

Pré-requis : Node ≥ 20. Tu apprends la discipline qui distingue un dev junior d'un senior : Characterization Tests d'abord, refactor par étapes, jamais sans filet de sécurité. La correction atteint 31/31 tests + 100 % coverage + 0 erreur lint/typecheck.

📥 Télécharger le canevas squelette à compléter — commence ici 📦 Télécharger la correction solution complète + walkthrough pédagogique

💡 Comment l'utiliser : dézippe le canevas, suis son README.md pour démarrer et tente l'exercice. Quand tu bloques (ou quand tu as fini pour comparer), télécharge la correction — son README.md contient un walkthrough détaillé qui t'explique chaque choix de la solution.

Ressources clés

• Clean Code — Robert C. Martin
• A Philosophy of Software Design — John Ousterhout
• Refactoring — Martin Fowler
• Vitest Docs — vitest.dev
• Playwright Docs — playwright.dev
• Diátaxis — diataxis.fr