SYNOMAP — DOCUMENTATION MÉTIER V5
Bloc H (Gestion des torrents orphelins SRC)
Version : 5.0
Date : 2025-11-16

0. OBJET
Le Bloc H gère les situations où les données sources (SRC) de qBittorrent ne sont plus fiables :
- dossiers manquants,
- fichiers partiels,
- répertoires illisibles,
- montages NFS cassés,
- suppressions manuelles sur OMV.

H est un bloc de signalisation et de blocage :
- aucun correctif n’est tenté,
- l’information est taggée pour l’interface métier,
- les flux ABC/G/D sont suspendus pour ce torrent jusqu’à correction manuelle.

1. PHILOSOPHIE
Le Bloc H garantit que Synomap ne tente jamais de manipuler un torrent dont la source disque est incohérente.
H protège contre :
- les reconstructions hasardeuses,
- les setLocation mal placés,
- les corrections qB dangereuses en présence de données manquantes.

H signifie : « Le système ne peut plus faire confiance à SRC. Intervention manuelle nécessaire. »

2. CONDITIONS D’ACTIVATION (Définition SRC orphelin)
Un torrent devient “orphelin SRC” (H1/H2/H3) dès que l’une des conditions suivantes est vraie :
- SRC_ROOT n’existe plus,
- SRC_ROOT existe mais certains fichiers du mapping sont manquants,
- SRC_ROOT existe mais est illisible (droits, I/O, montage).

Le mapping et le dossier DST ne sont jamais utilisés pour tenter une reconstruction automatique.

3. EFFETS MÉTIER LORSQUE H EST ACTIF
H applique :
- le tag : SYNO_ERR_FS,
- le retrait systématique du tag : SYNO_OK,
- le blocage complet des blocs G, ABC et D pour ce torrent.

Le torrent n’est ni migré ni corrigé tant que SRC n’est pas revenu à un état cohérent.

4. INVARIANTS MÉTIER
INV_H1 — Position dans la boucle
H intervient après E (mapping ok), ABC (intention connue) et G (contrôle FS).

INV_H2 — Déclencheurs
H1/H2/H3 déclenchés uniquement sur problèmes SRC.

INV_H3 — Aucune réparation automatique
H ne corrige jamais les données. H ne reconstruit rien.

INV_H4 — Aucune suppression
H ne supprime pas de fichiers (ni SRC, ni DST, ni Plex).

INV_H5 — Tag H1b : SYNO_ERR_FS + suppression SYNO_OK
Assure que l’état “C OK” ne reste pas affiché à tort.

INV_H6 — Blocage flux
Un torrent H est sorti du flux normal tant que SRC est incohérent.

INV_H7 — Réévaluation à chaque run
Si SRC redevient complet, flux normal réactivé.

INV_H8 — Priorité H2a : FS > UNSAFE qB
Si H et D3 sont vrais, l’erreur principale est H (« SRC cassé »).

5. ÉTATS DU BLOC H
H0 — SRC OK
Aucun problème. Flux normal.

H1 — SRC partiellement manquant
Dossier SRC présent mais fichiers du mapping incomplets.

H2 — SRC totalement absent
Dossier SRC supprimé/déplacé.

H3 — SRC inaccessible
Dossier SRC illisible (droits/I/O/NFS cassé).

Tous les états H1/H2/H3 entraînent :
- SYNO_ERR_FS,
- suppression SYNO_OK,
- blocage flux.

6. LOGGING (H3b validé)
H génère un logging détaillé :
- nature de l’erreur (H1/H2/H3),
- chemin SRC_ROOT,
- liste des fichiers manquants ou inaccessibles (chemins relatifs),
- code d’erreur métier.

Ce niveau de détail est conçu pour le diagnostic direct sur OMV.

7. IMPACTS MÉTIER
Le Bloc H protège :
- contre les opérations qB dangereuses,
- contre les boucles ABC inutiles,
- contre les reconstructions DST hasardeuses,
- contre les modifications intempestives en cas de données manquantes.

Pour un chef de projet, H indique un « point d’intervention humaine obligatoire ».

FIN DU DOCUMENT MÉTIER V5