GastinelGarde : signalement des detections au Hub (desactive par defaut)

Nouveau paquet hub (Java pur) : envoi asynchrone des franchissements de palier
(alerte, setback, expulsion) vers POST /internal/detections du Hub, selon la
conception du bloc 2 (section 2) et les contraintes de la revue de securite du Hub.

- fil d'envoi a part, file bornee sans verrou, copie sur disque, nouvelles tentatives
  exponentielles (1 s a 5 min), Retry-After, identifiant d'idempotence conserve ;
- le tick serveur n'ajoute qu'un objet en file : aucune entree-sortie, aucune attente ;
- cle de la source lue dans un fichier, jamais en dur, jamais journalisee ;
- champs conformes au Hub (controle, dimension, version_mod, exemptions), aucune IP ;
- reglages [hub] (envoi = false par defaut), commande /garde hub, ANNEXE-HUB.md ;
- 55 tests unitaires hors ligne (faux serveur HTTP local).

Non compile avec NeoForge ici (Garde, GardeSpec, GardeCommands) : a verifier au build.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Cette révision appartient à :
gastineltetClaude Sonnet 5.5 a révisé 2026-10-20 02:42:52 +02:00
1 Parent b2e5189d8a
révision fb0643f0a3
23 fichiers modifiés
+2903 -1

Aucun fichier ne correspond à votre recherche

+72
Voir le fichier
@@ -0,0 +1,72 @@
package com.gastinelgarde.hub;
import com.gastinelgarde.core.Sanction;
import java.net.URI;
import java.nio.file.Path;
/**
* Réglages du signalement au Hub. Valeurs par défaut : tout est coupé ({@code envoi = false}) ; rien ne part tant
* que Théo n'a pas activé, renseigné l'adresse et posé le fichier de clé.
*
* @param envoi interrupteur général (défaut : false)
* @param url adresse de base du Hub (réseau Docker interne), sans le chemin ; vide = pas d'envoi
* @param fichierCle fichier qui contient la clé de la source (jamais dans le fichier de réglages)
* @param envoyerObserve envoyer aussi les contrôles en OBSERVE (marqués {@code observe}, jamais comptés par le Hub)
* @param palierMin plus petit palier envoyé : ALERTE, SETBACK ou EXPULSION
* @param lotMax détections par requête (le Hub accepte 1 à 50)
* @param intervalleMs attente entre deux envois quand tout va bien
* @param fileMax détections gardées au plus ; au-delà, les plus anciennes sont abandonnées
* @param ageMaxMs âge au-delà duquel une détection n'est plus envoyée (le Hub refuse plus de 24 h)
* @param debitMaxParMinute détections envoyées au plus par minute (le Hub limite à 60 par défaut)
* @param episodeMs durée pendant laquelle un même palier d'un même contrôle n'est signalé qu'une fois
* @param delaiConnexionMs délai de connexion
* @param delaiRequeteMs délai total d'une requête
* @param coordonnees joindre la position arrondie au bloc et la dimension
* @param dossierEtat dossier de la file d'attente sur disque
*/
public record HubConfig(boolean envoi, String url, Path fichierCle, boolean envoyerObserve, Sanction palierMin,
int lotMax, long intervalleMs, int fileMax, long ageMaxMs, int debitMaxParMinute,
long episodeMs, int delaiConnexionMs, int delaiRequeteMs, boolean coordonnees,
Path dossierEtat) {
public static final String CHEMIN_API = "/internal/detections";
public static final long AGE_MAX_API_MS = 24L * 3600_000L;
public HubConfig {
if (palierMin == null || palierMin.ordinal() < Sanction.ALERTE.ordinal()) palierMin = Sanction.ALERTE;
lotMax = Math.max(1, Math.min(50, lotMax));
intervalleMs = Math.max(200, intervalleMs);
fileMax = Math.max(10, fileMax);
// le Hub refuse toute détection de plus de 24 h : inutile d'en garder (ni d'en renvoyer) plus longtemps
ageMaxMs = Math.max(60_000L, Math.min(ageMaxMs, AGE_MAX_API_MS - 3600_000L));
debitMaxParMinute = Math.max(1, debitMaxParMinute);
episodeMs = Math.max(1000, episodeMs);
delaiConnexionMs = Math.max(200, delaiConnexionMs);
delaiRequeteMs = Math.max(500, delaiRequeteMs);
url = url == null ? "" : url.trim();
}
/** Tout coupé. */
public static HubConfig defaut(Path dossierEtat) {
return new HubConfig(false, "", Path.of("config", "gastinelgarde-hub.key"), false, Sanction.ALERTE,
50, 2000, 10_000, 23L * 3600_000L, 50, 600_000L, 3000, 5000, true, dossierEtat);
}
/**
* Adresse complète de l'API, ou {@code null} si l'adresse de base est absente ou refusée (http/https seulement,
* pas d'identifiants dans l'adresse, ni paramètre, ni fragment).
*/
public URI adresseApi() {
if (url.isEmpty()) return null;
try {
URI u = URI.create(url);
String s = u.getScheme();
if (s == null || !(s.equalsIgnoreCase("http") || s.equalsIgnoreCase("https"))) return null;
if (u.getHost() == null || u.getUserInfo() != null || u.getRawQuery() != null || u.getRawFragment() != null) return null;
String base = url.endsWith("/") ? url.substring(0, url.length() - 1) : url;
return URI.create(base + CHEMIN_API);
} catch (IllegalArgumentException e) {
return null;
}
}
}