.DEFAULT_GOAL := help # Permet d'utiliser un .env.docker.local pour override ENV_DEFAULT = infra/dev/.env.docker ENV_LOCAL = infra/dev/.env.docker.local ENV_FILE := $(if $(wildcard $(ENV_LOCAL)),$(ENV_LOCAL),$(ENV_DEFAULT)) # Permet d'avoir les variables du fichier .env.docker.local include $(ENV_DEFAULT) -include $(ENV_LOCAL) PHP_CONTAINER = php-$(DOCKER_APP_NAME)-fpm SYMFONY_CONSOLE = $(EXEC_PHP) php bin/console DOCKER_COMPOSE = docker compose --env-file $(ENV_FILE) DOCKER = docker EXEC_PHP = $(DOCKER) exec -t -u $(APP_USER) $(PHP_CONTAINER) EXEC_PHP_CS_FIXER = $(EXEC_PHP) php vendor/bin/php-cs-fixer EXEC_PHP_ROOT = $(DOCKER) exec -t -u root $(PHP_CONTAINER) EXEC_PHP_INTERACTIVE = $(DOCKER) exec -it -u $(APP_USER) $(PHP_CONTAINER) EXEC_PHP_INTERACTIVE_ROOT = $(DOCKER) exec -it -u root $(PHP_CONTAINER) FILES = #======================================================================================== # Affiche l'aide — cible par defaut (make ou make help) help: @printf "\n \033[1mColtura — Commandes make\033[0m\n\n" @printf " \033[1;33mContainers\033[0m\n" @printf " \033[36m%-28s\033[0m %s\n" "start" "Demarrer les containers Docker" @printf " \033[36m%-28s\033[0m %s\n" "stop" "Arreter les containers" @printf " \033[36m%-28s\033[0m %s\n" "restart" "Redemarrer les containers" @printf " \033[36m%-28s\033[0m %s\n" "shell" "Shell bash dans le container PHP (user app)" @printf " \033[36m%-28s\033[0m %s\n" "shell-root" "Shell bash dans le container PHP (root)" @printf " \033[36m%-28s\033[0m %s\n" "logs-dev" "Tail des logs Symfony (var/log/dev.log)" @printf "\n \033[1;33mInstallation\033[0m\n" @printf " \033[36m%-28s\033[0m %s\n" "install" "Install complet (composer, migrations, fixtures, build Nuxt)" @printf " \033[36m%-28s\033[0m %s\n" "reset" "Tout supprimer et reinstaller (ATTENTION : drop la BDD)" @printf " \033[36m%-28s\033[0m %s\n" "composer-install" "Composer install + generation cles JWT" @printf " \033[36m%-28s\033[0m %s\n" "build-nuxtJS" "npm install + build Nuxt (prod)" @printf " \033[36m%-28s\033[0m %s\n" "build-without-cache" "Rebuild des images Docker sans cache" @printf " \033[36m%-28s\033[0m %s\n" "copy-git-hook" "Copie les hooks git (pre-commit, commit-msg)" @printf " \033[36m%-28s\033[0m %s\n" "node-use" "Force la version Node via nvm" @printf "\n \033[1;33mFrontend (Nuxt)\033[0m\n" @printf " \033[36m%-28s\033[0m %s\n" "dev-nuxt" "Serveur dev Nuxt avec hot reload (port 3004)" @printf " \033[36m%-28s\033[0m %s\n" "nuxt-lint" "Lint TypeScript/Vue" @printf " \033[36m%-28s\033[0m %s\n" "nuxt-lint-fix" "Lint + auto-fix" @printf "\n \033[1;33mBase de donnees\033[0m\n" @printf " \033[36m%-28s\033[0m %s\n" "migration-migrate" "Lancer les migrations Doctrine" @printf " \033[36m%-28s\033[0m %s\n" "fixtures" "Charger les fixtures" @printf " \033[36m%-28s\033[0m %s\n" "sync-permissions" "Synchroniser le catalogue RBAC" @printf " \033[36m%-28s\033[0m %s\n" "db-reset" "Reset BDD (drop + migrate + fixtures + perms)" @printf " \033[36m%-28s\033[0m %s\n" "db-restart" "Restart du container BDD" @printf " \033[36m%-28s\033[0m %s\n" "test-db-setup" "Cree et initialise la BDD de test" @printf " \033[36m%-28s\033[0m %s\n" "cache-clear" "Vider le cache Symfony" @printf "\n \033[1;33mTests\033[0m\n" @printf " \033[36m%-28s\033[0m %s\n" "test" "PHPUnit (tests back)" @printf " \033[36m%-28s\033[0m %s\n" "nuxt-test" "Vitest (tests unitaires front)" @printf " \033[36m%-28s\033[0m %s\n" "test-all" "PHPUnit + Vitest" @printf " \033[36m%-28s\033[0m %s\n" "test-e2e" "Playwright (tests E2E front)" @printf " \033[36m%-28s\033[0m %s\n" "test-e2e-ui" "Playwright UI interactive (debug)" @printf " \033[36m%-28s\033[0m %s\n" "seed-e2e" "Seed les 6 personas E2E" @printf " \033[36m%-28s\033[0m %s\n" "install-e2e-deps" "One-time : Chromium + libs systeme (sudo)" @printf "\n \033[1;33mQualite code\033[0m\n" @printf " \033[36m%-28s\033[0m %s\n" "php-cs-fixer-allow-risky" "Fix code style PHP (utilise par le pre-commit)" @printf "\n Plus de details : \033[4mREADME.md\033[0m, \033[4mCLAUDE.md\033[0m\n\n" env-init: @cp --update=none $(ENV_DEFAULT) $(ENV_LOCAL) # Lance le container start: env-init @echo "**** START CONTAINERS ****" CURRENT_UID=$(shell id -u) CURRENT_GID=$(shell id -g) $(DOCKER_COMPOSE) up -d # Éteint le container stop: $(DOCKER_COMPOSE) stop restart: env-init $(DOCKER_COMPOSE) down CURRENT_UID=$(shell id -u) CURRENT_GID=$(shell id -g) $(DOCKER_COMPOSE) up -d install: copy-git-hook composer-install cache-clear node-use build-nuxtJS migration-migrate sync-permissions test-db-setup # Supprime tout est réinstalle tout (Attention ça supprime la bdd aussi) reset: delete_built_dir remove_orphans build-without-cache start wait install composer-install: $(EXEC_PHP_ROOT) mkdir -p /var/www/html/var/cache /var/www/html/var/log $(EXEC_PHP_ROOT) chown -R www-data:www-data /var/www/html/var $(EXEC_PHP) composer install $(SYMFONY_CONSOLE) lexik:jwt:generate-keypair --skip-if-exists build-nuxtJS: $(EXEC_PHP_ROOT) chown -R $(APP_USER):$(APP_USER) /var/www/html/frontend $(EXEC_PHP) sh -lc "cd frontend && npm install && npm run build:dist" dev-nuxt: $(EXEC_PHP) sh -c "cd frontend && npm run dev" nuxt-lint: $(EXEC_PHP) sh -c "cd frontend && npm run lint" nuxt-lint-fix: $(EXEC_PHP) sh -c "cd frontend && npm run lint:fix" # Lance les tests unitaires frontend (Vitest) nuxt-test: $(EXEC_PHP) sh -c "cd frontend && npm run test" # Seed les 6 personas E2E (idempotent). A relancer des que le catalogue # permissions bouge (sync-permissions) ou avant chaque run test-e2e. seed-e2e: $(SYMFONY_CONSOLE) app:seed-e2e # Bootstrap one-time pour les tests E2E sur un nouveau poste : # 1. Telecharge Chromium dans ~/.cache/ms-playwright # 2. Installe les deps systeme (libnss3, libasound, libatk, etc.) : # - Ubuntu/Debian : `playwright install-deps` (officiel) # - Fedora/RHEL : liste dnf equivalente (playwright ne gere pas dnf) # - Autre : avertissement, a faire a la main. # # Le `sudo env "PATH=$$PATH"` est necessaire car avec NVM, `sudo npx` ne # trouve pas npx (le PATH de sudo est vide par defaut). On preserve # explicitement le PATH courant pour que npx resolve. # # A relancer uniquement si tu upgrade @playwright/test (les deps peuvent # bouger entre versions majeures). install-e2e-deps: cd frontend && npx playwright install chromium @if command -v apt-get >/dev/null 2>&1; then \ echo ">> Detected apt-get — using playwright install-deps"; \ cd frontend && sudo env "PATH=$$PATH" npx playwright install-deps chromium; \ elif command -v dnf >/dev/null 2>&1; then \ echo ">> Detected dnf — installing Chromium deps via dnf"; \ sudo dnf install -y \ nss nspr dbus-libs atk at-spi2-atk at-spi2-core cups-libs \ libdrm libX11 libXcomposite libXdamage libXfixes libXrandr \ libXext libXtst libxkbcommon mesa-libgbm alsa-lib \ pango cairo libwayland-client; \ else \ echo ">> No supported package manager detected (apt-get / dnf)."; \ echo ">> Install Chromium system libs manually, then re-run test-e2e."; \ exit 1; \ fi # Lance les tests E2E Playwright sur l'host. Pre-requis : # - `make install-e2e-deps` (une fois par poste) # - `make start` (containers en vie) # - `make dev-nuxt` dans un autre terminal (serve frontend sur :3004) # - `make seed-e2e` (personas crees) test-e2e: cd frontend && npm run test:e2e # UI interactive Playwright (debug facile) test-e2e-ui: cd frontend && npm run test:e2e:ui delete_built_dir: CURRENT_UID=$(shell id -u) CURRENT_GID=$(shell id -g) $(DOCKER_COMPOSE) up -d $(DOCKER) exec -u root $(PHP_CONTAINER) rm -rf vendor/ $(DOCKER) exec -u root $(PHP_CONTAINER) rm -rf frontend/node_modules remove_orphans: $(DOCKER_COMPOSE) kill $(DOCKER_COMPOSE) down --volumes --remove-orphans build-without-cache: $(DOCKER_COMPOSE) build \ --build-arg="DOCKER_PHP_VERSION=$(DOCKER_PHP_VERSION)" \ --build-arg="DOCKER_NODE_VERSION=$(DOCKER_NODE_VERSION)" \ --build-arg="CURRENT_UID=$(shell id -u)" \ --build-arg="CURRENT_GID=$(shell id -g)" \ --no-cache migration-migrate: $(SYMFONY_CONSOLE) doctrine:migrations:migrate --no-interaction # Cree et initialise la base de test utilisee par PHPUnit # (le suffixe "_test" est applique automatiquement par Doctrine en APP_ENV=test) # # Ordre : # 1. migrations : crees le schema metier reel. # 2. schema:update : cree les tables mappees en `when@test` uniquement # (ex: fake_site_aware_entity du ticket 4) qui n'ont pas de migration. # `--force` sans `--complete` : ajoute les tables manquantes aux # mappings sans drop les tables DB non mappees (no-op sur un schema # deja aligne avec les migrations). Necessaire car le purger # doctrine:fixtures:load essaie de DELETE toutes les tables connues # via les mappings — si fake_site_aware_entity est mappe mais absent # en DB, le purger crash. # 3. fixtures -> sync-permissions : fixtures:load purge la table permission, # donc sync doit passer apres. test-db-setup: $(SYMFONY_CONSOLE) doctrine:database:create --env=test --if-not-exists $(SYMFONY_CONSOLE) doctrine:migrations:migrate --env=test --no-interaction $(SYMFONY_CONSOLE) doctrine:schema:update --env=test --force $(SYMFONY_CONSOLE) --env=test --no-interaction doctrine:fixtures:load $(SYMFONY_CONSOLE) --env=test --no-interaction app:sync-permissions fixtures: $(SYMFONY_CONSOLE) --no-interaction doctrine:fixtures:load # Synchronise le catalogue de permissions RBAC avec les declarations # des modules actifs (CoreModule::permissions() etc.). Idempotent. sync-permissions: $(SYMFONY_CONSOLE) --no-interaction app:sync-permissions # Attention, supprime votre bdd local db-reset: $(DOCKER_COMPOSE) down -v $(DOCKER_COMPOSE) up -d $(MAKE) wait $(SYMFONY_CONSOLE) doctrine:database:create --if-not-exists $(MAKE) migration-migrate $(MAKE) fixtures $(MAKE) sync-permissions $(MAKE) test-db-setup # Restart la bdd db-restart: $(DOCKER_COMPOSE) down $(DOCKER_COMPOSE) up -d cache-clear: $(SYMFONY_CONSOLE) cache:clear copy-git-hook: $(EXEC_PHP) cp pre-commit .git/hooks/ $(EXEC_PHP) cp commit-msg .git/hooks/ $(EXEC_PHP) chmod a+x .git/hooks/pre-commit $(EXEC_PHP) chmod a+x .git/hooks/commit-msg shell: $(EXEC_PHP_INTERACTIVE) bash shell-root: $(EXEC_PHP_INTERACTIVE_ROOT) bash # Suivi temps réel des logs dev logs-dev: $(EXEC_PHP_INTERACTIVE) sh -lc "tail -f var/log/dev.log" # Force la version node node-use: bash -lc 'source "$$HOME/.nvm/nvm.sh" && nvm install && nvm use' # Utilisé par le pre-commit pour fix les fichiers modifiés php-cs-fixer-allow-risky: @echo "Fixing files: $(FILES)" $(EXEC_PHP_CS_FIXER) fix --config=.php-cs-fixer.dist.php --allow-risky=yes $(FILES) test: $(EXEC_PHP) php -d memory_limit="512M" vendor/bin/phpunit $(FILES) # Lance l'ensemble des tests (PHPUnit back + Vitest front) test-all: test nuxt-test wait: sleep 10