api/src/core/config.py

@@ -93,6 +93,12 @@ class Settings(BaseSettings):
                     "SCAN_HOTFOLDER_MODE=smb требует OPENBAO__SMB__SMB_HOST/SMB_PATH/SMB_LOGIN/SMB_PASSWORD; "
                     f"не заданы: {', '.join(missing)}"
                 )
+        if self.SCAN_SETTLE_SECONDS >= self.SCAN_TIMEOUT_SECONDS:
+            raise ValueError(
+                f"SCAN_SETTLE_SECONDS ({self.SCAN_SETTLE_SECONDS}) должен быть меньше SCAN_TIMEOUT_SECONDS "
+                f"({self.SCAN_TIMEOUT_SECONDS}): иначе набор ответа не успеет настояться и каждое задание завершится "
+                "TIMEOUT"
+            )
         return self
 
 

api/tests/unit/test_config.py

@@ -80,6 +80,23 @@ def test_negative_settle_seconds_rejected(monkeypatch):
         get_settings()
 
 
+@pytest.mark.parametrize("settle", ["10", "11"])
+def test_settle_not_less_than_timeout_rejected(monkeypatch, settle):
+    """M-4: набор не может настояться за срок, который короче или равен settle — каждое задание давало бы TIMEOUT."""
+    monkeypatch.setenv("SCAN_TIMEOUT_SECONDS", "10")
+    monkeypatch.setenv("SCAN_SETTLE_SECONDS", settle)
+
+    with pytest.raises(ValidationError, match="SCAN_SETTLE_SECONDS .* меньше SCAN_TIMEOUT_SECONDS"):
+        get_settings()
+
+
+def test_settle_less_than_timeout_is_allowed(monkeypatch):
+    monkeypatch.setenv("SCAN_TIMEOUT_SECONDS", "10")
+    monkeypatch.setenv("SCAN_SETTLE_SECONDS", "9.9")
+
+    assert get_settings().SCAN_SETTLE_SECONDS == 9.9
+
+
 def test_unknown_hotfolder_mode_rejected(monkeypatch):
     monkeypatch.setenv("SCAN_HOTFOLDER_MODE", "ftp")