Fichiers
gastinel-garde/src/test/java/com/gastinelgarde/hub/FileEtCleTest.java
T
gastineltetClaude Sonnet 5.5 fb0643f0a3 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>
2026-10-20 02:42:52 +02:00

196 lignes
8.5 KiB
Java

package com.gastinelgarde.hub;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertNull;
import static org.junit.jupiter.api.Assertions.assertTrue;
import com.gastinelgarde.core.Controle;
import com.gastinelgarde.core.Sanction;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;
import java.util.Map;
import java.util.UUID;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.io.TempDir;
/** File bornée, file sur disque, suivi des paliers, lecture de la clé. */
class FileEtCleTest {
static Detection det(int n, long survenueMs) {
return new Detection(String.format("00000000-0000-0000-0000-%012d:portee:alerte:%d", n, survenueMs),
"123e4567-e89b-12d3-a456-426614174000", "portee", 1, "enforce", 1.0, survenueMs, Map.of("controle", "portee"));
}
// --- File bornée ---
@Test
void laFileEstBorneeEtAbandonneLesPlusAnciennes() {
FileEnvoi f = new FileEnvoi(10);
for (int i = 0; i < 25; i++) f.ajouter(det(i, 1000 + i));
assertEquals(10, f.taille());
assertEquals(15, f.abandonnees());
List<Detection> lot = f.prendre(50, 1_000_000);
assertEquals(10, lot.size());
assertEquals(1015, lot.get(0).survenueMs()); // les plus récentes sont gardées
assertEquals(1024, lot.get(9).survenueMs());
}
@Test
void lotBorneEnNombreEtEnOctets() {
FileEnvoi f = new FileEnvoi(1000);
for (int i = 0; i < 100; i++) f.ajouter(det(i, 1000 + i));
assertEquals(50, f.prendre(50, 1_000_000).size());
int un = det(0, 1000).json().getBytes(StandardCharsets.UTF_8).length + 1;
List<Detection> petit = f.prendre(50, un * 3 + 1);
assertEquals(3, petit.size());
assertEquals(47, f.taille());
// une seule détection plus grosse que la limite part quand même (sinon la file serait bloquée)
assertEquals(1, f.prendre(50, 1).size());
}
@Test
void remettreRetrouveLOrdreEtPurgerEnleveLesVieilles() {
FileEnvoi f = new FileEnvoi(100);
for (int i = 0; i < 6; i++) f.ajouter(det(i, 1000 + i));
List<Detection> lot = f.prendre(3, 1_000_000);
f.remettre(lot);
assertEquals(6, f.taille());
List<Detection> tout = f.prendre(6, 1_000_000);
for (int i = 0; i < 6; i++) assertEquals(1000 + i, tout.get(i).survenueMs());
f.remettre(tout);
assertEquals(3, f.purgerAvant(1003));
assertEquals(3, f.taille());
}
// --- Disque ---
@Test
void fileSurDisqueEcritureAtomiqueEtRelecture(@TempDir Path tmp) throws IOException {
Spool s = new Spool(tmp.resolve("sous/dossier/file.jsonl"));
assertTrue(s.lire(0).isEmpty());
s.ecrire(List.of(det(1, 5000), det(2, 6000), det(3, 100)));
assertTrue(s.existe());
assertFalse(Files.exists(tmp.resolve("sous/dossier/file.jsonl.tmp")));
List<Detection> l = s.lire(1000); // la 3e est trop ancienne
assertEquals(2, l.size());
assertEquals(det(1, 5000), l.get(0)); // même identifiant, mêmes valeurs : la relecture ne change rien
s.ecrire(List.of());
assertFalse(s.existe());
}
@Test
void ligneAbimeeIgnoreeLesSuivantesRestent(@TempDir Path tmp) throws IOException {
Path p = tmp.resolve("file.jsonl");
Files.writeString(p, det(1, 5000).json() + "\n{pas du json\n" + det(2, 6000).json().substring(0, 40) + "\n"
+ det(3, 7000).json() + "\n", StandardCharsets.UTF_8);
List<Detection> l = new Spool(p).lire(0);
assertEquals(2, l.size());
assertEquals(5000, l.get(0).survenueMs());
assertEquals(7000, l.get(1).survenueMs());
}
// --- Suivi des paliers ---
@Test
void unPalierEstSignaleUneFoisParEpisodePuisSeulementSiPlusHaut() {
SuiviPaliers s = new SuiviPaliers(600_000, Sanction.ALERTE);
UUID j = UUID.randomUUID();
assertTrue(s.franchit(j, Controle.PORTEE, Sanction.ALERTE, 0));
assertFalse(s.franchit(j, Controle.PORTEE, Sanction.ALERTE, 1000));
assertTrue(s.franchit(j, Controle.PORTEE, Sanction.SETBACK, 2000));
assertFalse(s.franchit(j, Controle.PORTEE, Sanction.SETBACK, 3000));
assertFalse(s.franchit(j, Controle.PORTEE, Sanction.ALERTE, 4000)); // jamais de redescente
assertTrue(s.franchit(j, Controle.PORTEE, Sanction.EXPULSION, 5000));
assertTrue(s.franchit(j, Controle.VOL, Sanction.ALERTE, 5000)); // un autre contrôle : un autre épisode
assertTrue(s.franchit(j, Controle.PORTEE, Sanction.ALERTE, 700_000)); // l'épisode est fini
assertFalse(s.franchit(j, Controle.HITBOX, Sanction.JOURNAL, 0)); // sous le palier minimum
assertFalse(s.franchit(j, Controle.HITBOX, Sanction.AUCUNE, 0));
}
@Test
void joueurPartiOublieEtMemoireBornee() {
SuiviPaliers s = new SuiviPaliers(600_000, Sanction.ALERTE);
UUID j = UUID.randomUUID();
s.franchit(j, Controle.PORTEE, Sanction.ALERTE, 0);
s.oublier(j);
assertEquals(0, s.taille());
for (int i = 0; i < 20_000; i++) s.franchit(UUID.randomUUID(), Controle.PORTEE, Sanction.ALERTE, 0);
assertTrue(s.taille() <= 4096, "taille " + s.taille());
}
// --- Clé ---
private static final String CLE_TEST = "cle-de-test-0123456789-0123456789-ABCDEF"; // valeur factice, pas une vraie clé
@Test
void cleLueSansEtatsDAme(@TempDir Path tmp) throws IOException {
Path f = tmp.resolve("k.key");
Files.writeString(f, "# commentaire\n\n " + CLE_TEST + " \n", StandardCharsets.UTF_8);
LecteurCle.Resultat r = LecteurCle.lire(f);
assertTrue(r.ok());
assertEquals(CLE_TEST, r.cle());
assertFalse(r.toString().contains(CLE_TEST));
}
@Test
void cleAbsenteVideCourteOuPiegee(@TempDir Path tmp) throws IOException {
assertEquals(LecteurCle.Raison.ABSENTE, LecteurCle.lire(tmp.resolve("rien")).raison());
assertEquals(LecteurCle.Raison.ABSENTE, LecteurCle.lire(null).raison());
Path f = tmp.resolve("k.key");
Files.writeString(f, "# rien\n");
assertEquals(LecteurCle.Raison.VIDE, LecteurCle.lire(f).raison());
Files.writeString(f, "trop-court\n");
assertEquals(LecteurCle.Raison.TROP_COURTE, LecteurCle.lire(f).raison());
Files.writeString(f, CLE_TEST + " avec espace\n");
assertEquals(LecteurCle.Raison.CARACTERES_INVALIDES, LecteurCle.lire(f).raison());
Files.writeString(f, "x".repeat(5000));
assertEquals(LecteurCle.Raison.TROP_LONGUE, LecteurCle.lire(f).raison());
assertNull(LecteurCle.lire(f).cle());
}
@Test
void messagesDErreurSansLeContenuDeLaCle(@TempDir Path tmp) throws IOException {
Path f = tmp.resolve("k.key");
Files.writeString(f, CLE_TEST + " espace\n");
LecteurCle.Resultat r = LecteurCle.lire(f);
for (LecteurCle.Raison raison : LecteurCle.Raison.values()) {
assertFalse(LecteurCle.message(f, raison).contains("cle-de-test"), raison.name());
}
assertNull(r.cle());
}
// --- Réglages ---
@Test
void adresseDeLApiAcceptSeulementHttpSansIdentifiants(@TempDir Path tmp) {
assertEquals("http://hub:8080/internal/detections", cfg("http://hub:8080", tmp).adresseApi().toString());
assertEquals("https://hub/internal/detections", cfg("https://hub/", tmp).adresseApi().toString());
assertNull(cfg("", tmp).adresseApi());
assertNull(cfg("ftp://hub", tmp).adresseApi());
assertNull(cfg("http://utilisateur:secret@hub", tmp).adresseApi());
assertNull(cfg("http://hub?x=1", tmp).adresseApi());
assertNull(cfg("pas une adresse", tmp).adresseApi());
}
@Test
void reglagesBornes(@TempDir Path tmp) {
HubConfig c = new HubConfig(true, "http://hub", Path.of("k"), false, Sanction.JOURNAL, 999, 1, 1, Long.MAX_VALUE,
0, 0, 0, 0, true, tmp);
assertEquals(Sanction.ALERTE, c.palierMin());
assertEquals(50, c.lotMax());
assertTrue(c.ageMaxMs() < HubConfig.AGE_MAX_API_MS);
assertTrue(c.fileMax() >= 10);
assertTrue(c.debitMaxParMinute() >= 1);
assertFalse(HubConfig.defaut(tmp).envoi());
}
private static HubConfig cfg(String url, Path tmp) {
return new HubConfig(true, url, Path.of("k"), false, Sanction.ALERTE, 50, 2000, 100, 3600_000L, 50, 600_000L, 1000, 1000,
true, tmp);
}
}