docs: Makefile autodocumenté et README simplifié

L'installation du projet nécessitait plusieurs commandes manuelles et
le Makefile listait les commandes dans un bloc help statique, difficile
à maintenir et susceptible de devenir obsolète.

Le Makefile utilise maintenant le pattern "## description" qui génère
automatiquement l'aide à partir des commentaires inline. Le README
est simplifié avec un `make install` unique qui orchestre tout le setup.

Makefile

@@ -1,176 +1,158 @@
-.PHONY: help up down restart rebuild logs ps test lint phpstan arch cs-fix warmup frontend-lint frontend-test e2e clean shell bash console token token-alpha token-beta
-
-# Default target
-help:
-	@echo "Classeo - Commandes disponibles"
-	@echo ""
-	@echo "Docker:"
-	@echo "  make up        - Lancer tous les services"
-	@echo "  make down      - Arreter tous les services"
-	@echo "  make restart   - Redemarrer tous les services"
-	@echo "  make rebuild   - Reconstruire et relancer les services"
-	@echo "  make build     - Reconstruire les images"
-	@echo "  make logs      - Voir les logs (Ctrl+C pour quitter)"
-	@echo "  make ps        - Statut des services"
-	@echo "  make clean     - Supprimer volumes et images"
-	@echo ""
-	@echo "Shell:"
-	@echo "  make shell     - Shell bash dans le container PHP"
-	@echo "  make bash      - Alias pour make shell"
-	@echo "  make console   - Console Symfony (ex: make console c='debug:router')"
-	@echo "  make shell-frontend - Shell dans le container frontend"
-	@echo ""
-	@echo "Backend:"
-	@echo "  make phpstan   - Analyse statique PHPStan"
-	@echo "  make arch      - Tests d'architecture (PHPat)"
-	@echo "  make cs-fix    - Correction code style PHP"
-	@echo "  make test-php  - Tests PHPUnit"
-	@echo "  make warmup    - Warmup du cache Symfony"
-	@echo ""
-	@echo "Frontend:"
-	@echo "  make lint      - ESLint frontend"
-	@echo "  make test-js   - Tests Vitest"
-	@echo "  make e2e       - Tests Playwright"
-	@echo ""
-	@echo "All:"
-	@echo "  make test      - Tous les tests"
-	@echo "  make check     - Tous les linters"
-	@echo ""
-	@echo "Setup:"
-	@echo "  make jwt-keys  - Generer les cles JWT (requis apres clone)"
-	@echo ""
-	@echo "Dev:"
-	@echo "  make token       - Creer un token d'activation (interactif)"
-	@echo "  make token-alpha - Token sur ecole-alpha (+ email=, role=, minor=1)"
-	@echo "  make token-beta  - Token sur ecole-beta (+ email=, role=, minor=1)"
+.DEFAULT_GOAL := help
 
 # =============================================================================
 # Docker
 # =============================================================================
 
-up:
+.PHONY: up
+up: ## Lancer tous les services
 	docker compose up -d
 
-down:
+.PHONY: down
+down: ## Arrêter tous les services
 	docker compose down
 
-restart:
+.PHONY: restart
+restart: ## Redémarrer tous les services
 	docker compose down
 	docker compose up -d
 
-rebuild:
+.PHONY: rebuild
+rebuild: ## Reconstruire et relancer les services (sans cache)
 	docker compose down
 	docker compose build --no-cache
 	docker compose up -d
 
-build:
+.PHONY: build
+build: ## Reconstruire les images Docker (sans cache)
 	docker compose build --no-cache
 
-logs:
+.PHONY: logs
+logs: ## Voir les logs de tous les services (Ctrl+C pour quitter)
 	docker compose logs -f
 
-ps:
+.PHONY: ps
+ps: ## Afficher le statut des services
 	docker compose ps
 
-clean:
+.PHONY: clean
+clean: ## Supprimer volumes et images locales
 	docker compose down -v --rmi local
 
 # =============================================================================
 # Shell
 # =============================================================================
 
-shell:
+.PHONY: shell
+shell: ## Ouvrir un shell dans le container PHP
 	docker compose exec php sh
 
-bash: shell
+.PHONY: bash
+bash: shell ## Alias pour 'make shell'
 
-console:
+.PHONY: console
+console: ## Exécuter une commande Symfony (ex: make console c='debug:router')
 	docker compose exec php php bin/console $(c)
 
-shell-frontend:
+.PHONY: shell-frontend
+shell-frontend: ## Ouvrir un shell dans le container frontend
 	docker compose exec frontend sh
 
 # =============================================================================
-# Backend
+# Backend - Qualité
 # =============================================================================
 
-phpstan:
+.PHONY: phpstan
+phpstan: ## Analyse statique PHPStan (level 9)
 	docker compose exec php composer phpstan
 
-arch:
+.PHONY: arch
+arch: ## Tests d'architecture PHPat
 	docker compose exec php composer arch
 
-cs-fix:
+.PHONY: cs-fix
+cs-fix: ## Corriger le code style PHP (PHP-CS-Fixer)
 	docker compose exec php composer cs-fix
 
-cs-check:
+.PHONY: cs-check
+cs-check: ## Vérifier le code style PHP sans corriger
 	docker compose exec php composer cs-check
 
-test-php:
+.PHONY: test-php
+test-php: ## Lancer les tests PHPUnit
 	docker compose exec php composer test
 
-warmup:
+.PHONY: warmup
+warmup: ## Préchauffer le cache Symfony
 	docker compose exec php php bin/console cache:warmup
 
 # =============================================================================
-# Frontend
+# Frontend - Qualité
 # =============================================================================
 
-lint:
+.PHONY: lint
+lint: ## Lancer ESLint sur le frontend
 	docker compose exec frontend pnpm run lint
 
-check-types:
+.PHONY: check-types
+check-types: ## Vérifier les types TypeScript (svelte-check)
 	docker compose exec frontend pnpm run check
 
-test-js:
+.PHONY: test-js
+test-js: ## Lancer les tests Vitest
 	docker compose exec frontend pnpm run test
 
-e2e:
+.PHONY: e2e
+e2e: ## Lancer les tests E2E Playwright
 	docker compose exec frontend pnpm run test:e2e
 
 # =============================================================================
-# All
+# Tout-en-un
 # =============================================================================
 
-test: test-php test-js
+.PHONY: test
+test: test-php test-js ## Lancer tous les tests (PHPUnit + Vitest)
 
-check: phpstan cs-check lint check-types
+.PHONY: check
+check: phpstan cs-check lint check-types ## Lancer tous les linters et checks
 
 # =============================================================================
 # Scripts
 # =============================================================================
 
-check-bc:
+.PHONY: check-bc
+check-bc: ## Vérifier l'isolation des Bounded Contexts
 	./scripts/check-bc-isolation.sh
 
-check-naming:
+.PHONY: check-naming
+check-naming: ## Vérifier les conventions de nommage
 	./scripts/check-naming.sh
 
-check-tenants:
+.PHONY: check-tenants
+check-tenants: ## Vérifier que les tenants répondent
 	./scripts/check-tenants.sh
 
+# =============================================================================
+# Setup initial
+# =============================================================================
+
+.PHONY: install
+install: up jwt-keys warmup ## Installation complète après clone
+
+.PHONY: jwt-keys
+jwt-keys: ## Générer les clés JWT (requis après clone)
+	@echo "Génération des clés JWT..."
+	@docker compose exec php mkdir -p config/jwt
+	@docker compose exec php openssl genpkey -out config/jwt/private.pem -aes256 -algorithm rsa -pkeyopt rsa_keygen_bits:4096 -pass pass:$${JWT_PASSPHRASE:-classeo_jwt_passphrase_change_me}
+	@docker compose exec php openssl pkey -in config/jwt/private.pem -out config/jwt/public.pem -pubout -passin pass:$${JWT_PASSPHRASE:-classeo_jwt_passphrase_change_me}
+	@echo "Clés JWT générées dans backend/config/jwt/"
+
 # =============================================================================
 # Dev helpers
 # =============================================================================
 
-# Generer les cles JWT (a faire une seule fois apres clone)
-# Les cles sont gitignored pour la securite
-jwt-keys:
-	@echo "Generation des cles JWT..."
-	@docker compose exec php mkdir -p config/jwt
-	@docker compose exec php openssl genpkey -out config/jwt/private.pem -aes256 -algorithm rsa -pkeyopt rsa_keygen_bits:4096 -pass pass:$${JWT_PASSPHRASE:-classeo_jwt_passphrase_change_me}
-	@docker compose exec php openssl pkey -in config/jwt/private.pem -out config/jwt/public.pem -pubout -passin pass:$${JWT_PASSPHRASE:-classeo_jwt_passphrase_change_me}
-	@echo "Cles JWT generees dans backend/config/jwt/"
-
-# Creer un token d'activation de test (mode interactif par defaut)
-# Usage:
-#   make token                    - Mode interactif (pose des questions)
-#   make token tenant=ecole-beta  - Sur le tenant beta
-#   make token role=PROF          - Creer un prof
-#   make token email=x@y.com role=ADMIN tenant=ecole-beta minor=1
-#
-# Options: email, role (PARENT|ELEVE|PROF|ADMIN), tenant (ecole-alpha|ecole-beta), minor
-token:
+.PHONY: token
+token: ## Créer un token d'activation (interactif). Options: email=, role=, tenant=, minor=1
 	docker compose exec php php bin/console app:dev:create-test-activation-token \
 		$(if $(email),--email=$(email),) \
 		$(if $(role),--role=$(role),) \
@@ -178,17 +160,30 @@ token:
 		$(if $(minor),--minor,) \
 		--base-url=http://localhost:5174
 
-# Raccourcis pour creer rapidement des tokens sur chaque tenant (non-interactif)
-token-alpha:
+.PHONY: token-alpha
+token-alpha: ## Créer un token sur ecole-alpha. Options: email=, role=, minor=1
 	docker compose exec -T php php bin/console app:dev:create-test-activation-token -n \
 		--tenant=ecole-alpha --base-url=http://ecole-alpha.classeo.local:5174 \
 		$(if $(email),--email=$(email),--email=alpha@test.com) \
 		$(if $(role),--role=$(role),) \
 		$(if $(minor),--minor,)
 
-token-beta:
+.PHONY: token-beta
+token-beta: ## Créer un token sur ecole-beta. Options: email=, role=, minor=1
 	docker compose exec -T php php bin/console app:dev:create-test-activation-token -n \
 		--tenant=ecole-beta --base-url=http://ecole-beta.classeo.local:5174 \
 		$(if $(email),--email=$(email),--email=beta@test.com) \
 		$(if $(role),--role=$(role),) \
 		$(if $(minor),--minor,)
+
+# =============================================================================
+# Help
+# =============================================================================
+
+.PHONY: help
+help: ## Afficher cette aide
+	@echo ""
+	@echo "  Classeo - Commandes disponibles"
+	@echo ""
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2}'
+	@echo ""