Squelette du dépôt : Makefile, tests, lint, crédits, journal

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 12:56:46 +01:00
parent 6d4ff4e7b4
commit 7fd23031ca
9 changed files with 250 additions and 1 deletions
@@ -0,0 +1,44 @@
+# Makefile d'Ustagammon : toutes les opérations du projet passent par ici.
+# Chaque cible documentée par « ## » apparaît dans `make help`.
+
+SHELL := /bin/bash
+.DEFAULT_GOAL := help
+
+# Machine de développement modeste : jamais plus de deux tâches en parallèle.
+MAKEFLAGS += -j2 --no-print-directory
+
+BUILD_DIR := build
+
+# Outils lancés dans Docker (aucune installation sur le PC).
+SHELLCHECK_IMAGE := koalaman/shellcheck-alpine:v0.10.0
+
+export SHELLCHECK_IMAGE
+
+.PHONY: help setup build test lint deploy clean
+
+help: ## Liste les commandes disponibles
+	@echo "Ustagammon : commandes disponibles"
+	@grep -E '^[a-zA-Z0-9_-]+:.*## ' $(MAKEFILE_LIST) \
+		| awk 'BEGIN { FS = ":.*## " } { printf "  make %-12s %s\n", $$1, $$2 }'
+
+setup: ## Installe la chaîne d'outils (images Docker) ; sans effet si déjà fait
+	@command -v docker >/dev/null || { echo "Docker est requis : sudo apt install docker.io"; exit 1; }
+	@docker image inspect $(SHELLCHECK_IMAGE) >/dev/null 2>&1 \
+		|| docker pull $(SHELLCHECK_IMAGE)
+	@echo "Chaîne d'outils prête."
+
+build: ## Compile le moteur (si nécessaire) puis l'application
+	@echo "Rien à compiler pour l'instant : le moteur arrive à l'étape 0a."
+
+test: ## Lance tous les tests
+	@tests/run.sh
+
+lint: ## Vérifie le style et les erreurs courantes
+	@tests/lint.sh
+
+deploy: ## Installe l'application sur le téléphone (pas encore disponible)
+	@echo "Pas encore disponible : le socle (PWA ou Android) sera choisi à la fin de l'étape 0."
+	@exit 1
+
+clean: ## Supprime les artefacts de build (garde les images Docker)
+	rm -rf $(BUILD_DIR)