From ea488c0b117840772a58d85d546d008d458167c3 Mon Sep 17 00:00:00 2001
From: toto <antitbone@jefaismonrhum.sdv.fr>
Date: Thu, 9 Apr 2026 22:22:25 +0200
Subject: [PATCH] feat: add make help with all targets documented

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 Makefile | 47 +++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 45 insertions(+), 2 deletions(-)

diff --git a/Makefile b/Makefile
index 37aafee..83b5a8c 100644
--- a/Makefile
+++ b/Makefile
@@ -4,9 +4,9 @@
 #   sentinel, correlator, bot-detector, dashboard, mod-reqin-log
 # =============================================================================
 
-.PHONY: build-all test-all rpm-all dist \
+.PHONY: help build-all test-all rpm-all dist \
         build-sentinel test-sentinel rpm-sentinel \
-        test-integration \
+        test-integration test-integration-keep test-integration-down \
         test-mod-reqin-log rpm-mod-reqin-log \
         build-correlator test-correlator rpm-correlator \
         build-bot-detector test-bot-detector \
@@ -15,6 +15,49 @@
         reload-prod-logs init-stack import-prod-data init-and-import \
         purge-db
 
+.DEFAULT_GOAL := help
+
+help: ## Affiche cette aide
+	@echo ""
+	@echo "  ja4-platform — Makefile"
+	@echo "  ─────────────────────────────────────────────────────"
+	@echo ""
+	@echo "  Build"
+	@echo "    make build-all              Construit toutes les images Docker"
+	@echo "    make build-sentinel         Image sentinel (capture TLS/TCP)"
+	@echo "    make build-correlator       Image correlator (corrélation logs)"
+	@echo "    make build-bot-detector     Image bot-detector (détection ML)"
+	@echo "    make build-dashboard        Image dashboard (SOC UI)"
+	@echo ""
+	@echo "  Tests"
+	@echo "    make test-all               Lance tous les tests unitaires"
+	@echo "    make test-sentinel          Tests Go sentinel (NET_RAW)"
+	@echo "    make test-correlator        Tests Go correlator (80% coverage)"
+	@echo "    make test-bot-detector      Tests Python bot-detector (36 tests)"
+	@echo "    make test-dashboard         Tests Python dashboard"
+	@echo "    make test-ja4common-python  Tests Python ja4_common"
+	@echo "    make test-mod-reqin-log     Tests C mod-reqin-log (cmocka)"
+	@echo ""
+	@echo "  Intégration"
+	@echo "    make test-integration       Tests full-stack (Docker Compose)"
+	@echo "    make test-integration-keep  Idem, stack reste active après"
+	@echo "    make test-integration-down  Arrête la stack d'intégration"
+	@echo ""
+	@echo "  RPM"
+	@echo "    make rpm-all                Construit tous les RPMs (el8/el9/el10)"
+	@echo "    make rpm-sentinel           RPM sentinel"
+	@echo "    make rpm-correlator         RPM correlator"
+	@echo "    make rpm-mod-reqin-log      RPM mod-reqin-log"
+	@echo "    make dist                   Alias de rpm-all"
+	@echo ""
+	@echo "  Base de données"
+	@echo "    make init-stack             Initialise ClickHouse (schéma complet)"
+	@echo "    make import-prod-data       Importe les données prod (date shift)"
+	@echo "    make init-and-import        init-stack + import-prod-data"
+	@echo "    make reload-prod-logs       Exporte prod → importe en dev"
+	@echo "    make purge-db               Supprime et recrée les bases ja4_*"
+	@echo ""
+
 # --- Root -------------------------------------------------------------------
 
 build-all: build-sentinel build-correlator build-bot-detector build-dashboard