fileflows/README.md

@@ -15,12 +15,27 @@ Exportiert aus FileFlows am 17.07.2026.
 | Radarr_Trigger_Manual_Import | 0e522a46-... | Radarr Import trigger |
 | Sonarr_Trigger_Manual_Import | 8fe63a47-... | Sonarr Import trigger |
 
+## Sicherheit beim Arr-Import
+
+- Radarr-Import arbeitet nur mit dem exakten `Variables['file.FullName']`.
+- Die konfigurierte `ImportPath` dient ausschließlich als Zuständigkeits-Guard für UHD/FHD.
+- Filmzuordnung erfolgt über einen eindeutigen Release-Match in Radarr Queue bzw. Grab-History; Radarr-Parsing ist nur Fallback.
+- Ohne eindeutige Movie-ID oder exakten ManualImport-Kandidaten schlägt der Flow sicher fehl und lässt die Datei zur manuellen Wiederherstellung liegen.
+- Ein Scan des gesamten `/tdarr/converted/video/`- oder `/video4k/`-Roots ist ausdrücklich verboten.
+
+Regressionstests:
+
+```bash
+python3 -m unittest discover -s fileflows/tests -v
+node --check fileflows/scripts/Radarr_-_Trigger_Manual_Import.js
+```
+
 ## Bekannte Issues
 
 - QSV-Namen sind falsch, Code verwendet NVENC/cuda
 - AV1/HEVC Flow-Parameter passen nicht zur Script-Signatur
 - 05_Finalize_Move hat Datenverlust-Bug bei fehlgeschlagener SRT-Extraktion
-- Arr-Import wird immer fuer alle 4 Instanzen ausgefuehrt
+- Der Flow ruft weiterhin alle vier Arr-Nodes seriell auf; deren Pfad-Guards verhindern unzuständige API-Imports.
 
 ## Flow JSON