Ohm comme client de téléchargement Sonarr (API compatible qBittorrent)

- /api/v2/* : login SID (mot de passe = clé Torznab), app/version,
  torrents/info (progression temps réel), properties (content_path),
  add (rejoue le grab encodé dans le .torrent de service, dédupliqué
  par infohash SHA-1), delete (± fichiers), pause/resume
- Les grabs Sonarr sont marqués « sonarr:<hash>| » dans source_key →
  suivis de bout en bout : Sonarr importe, renomme et range les épisodes
  dans sa bibliothèque, puis retire le torrent de la file Ohm
- L'indexeur Torznab embarque les paramètres du grab dans l'announce
- README : nouveau mode « client de téléchargement » recommandé (Remote
  Path Mapping documenté), blackhole en variante minimale
- 3 nouveaux tests (flux complet add → suivi → import → delete)

app/routers/torznab.py

@@ -6,12 +6,13 @@ des sessions utilisateurs — aucun cookie requis.
 
 import logging
 import secrets
+from urllib.parse import urlencode
 
 from fastapi import APIRouter, Request, Response
 
 from app.scrapers.base import ScrapeError
 from app.services.settings import get_torznab_apikey
-from app.services.torznab import torrent_stub, torznab
+from app.services.torznab import build_stub, torznab
 
 logger = logging.getLogger(__name__)
 
@@ -92,10 +93,12 @@ async def torznab_download(
     series: str | None = None,
     apikey: str | None = None,
 ) -> Response:
-    """Grab : Sonarr récupère le « .torrent » ; OhmStreaming télécharge l'épisode.
+    """Grab : Sonarr récupère le « .torrent » ; Ohm télécharge l'épisode.
 
-    Le flux retourne un .torrent de service (blackhole-friendly) pendant que
-    l'épisode réel entre dans la file de téléchargements interne.
+    Le flux retourne un .torrent de service : avec un client « Torrent
+    Blackhole » c'est un simple accusé de réception ; avec le client
+    qBittumber (l'API /api/v2 d'Ohm), Sonarr le renvoie et le grab est
+    rejoué/dédupliqué, puis suivi comme un téléchargement classique.
     """
     error = await _auth_error(request, apikey)
     if error is not None:
@@ -106,8 +109,17 @@ async def torznab_download(
             media_type="application/xml",
             status_code=400,
         )
+    name = f"{series} S{season:02d}E{ep:02d}"
+    announce = (
+        _base_url(request)
+        + "/torznab/api?"
+        + urlencode(
+            {"source": source, "sid": sid, "season": season, "ep": ep, "series": series}
+        )
+    )
+    stub, infohash = build_stub(announce, name)
     try:
-        result = await torznab.grab(source, sid, season, ep, series)
+        result = await torznab.grab(source, sid, season, ep, series, sonarr_hash=infohash)
         logger.info("Torznab grab OK : %s → download %s", series, result.get("id"))
     except ScrapeError as exc:
         logger.error("Torznab grab KO : %s", exc)
@@ -116,9 +128,13 @@ async def torznab_download(
             media_type="application/xml",
             status_code=502,
         )
-    stub = torrent_stub(_base_url(request) + "/torznab/api", f"{series} S{season:02d}E{ep:02d}")
     return Response(
         stub,
         media_type="application/x-bittorrent",
-        headers={"Content-Disposition": f'attachment; filename="ohm-{series.replace("/", "-")}-S{season:02d}E{ep:02d}.torrent"'},
+        headers={
+            "Content-Disposition": (
+                f'attachment; filename="ohm-{series.replace("/", "-")}'
+                f"-S{season:02d}E{ep:02d}.torrent"
+            )
+        },
     )