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>
73 lignes
3.9 KiB
Java
73 lignes
3.9 KiB
Java
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;
|
|
}
|
|
}
|
|
}
|