feat: manual full-pass sync Langflow -> files -> DB+LFX with admin guide

backend/tests/test_sync.py

@@ -118,20 +118,102 @@ async def test_sync_rename_updates_definition_name(session, lfx_server, tmp_path
     assert definition.name == "umbenannt"
 
 
-async def test_sync_endpoint_returns_report(client, lfx_server, tmp_path, monkeypatch, login):
+async def test_sync_endpoint_returns_report(
+    client, lfx_server, tmp_path, monkeypatch, login, override_langflow
+):
     await login()
+    override_langflow()  # empty Langflow: file-only pass
     monkeypatch.setattr(settings, "flows_dir", str(tmp_path))
     _seed_dir(tmp_path)
     response = await client.post("/api/flows/sync")
     assert response.status_code == 200, response.text
     body = response.json()
     assert body["added"] == ["simple_rule"]
+    assert body["pulled"] == []
     assert body["errors"] == {}
 
     response = await client.post("/api/flows/sync")
     assert response.json()["skipped"] == ["simple_rule"]
 
 
+def _langflow_doc(name: str, langflow_id: str) -> dict:
+    doc = load_fixture("simple_rule.json")
+    return {
+        "id": langflow_id,
+        "name": name,
+        "description": "aus Langflow",
+        "endpoint_name": None,
+        "data": doc["data"],
+        "tags": [],
+        "webhook": False,
+        "is_component": False,
+    }
+
+
+async def test_sync_endpoint_pulls_from_langflow_then_syncs(
+    client, lfx_server, tmp_path, monkeypatch, login, override_langflow
+):
+    await login()
+    monkeypatch.setattr(settings, "flows_dir", str(tmp_path))
+    langflow_id = "22222222-3333-4444-8555-666666666666"
+    override_langflow(
+        flows=[{"id": langflow_id, "name": "Gehaltserhöhung"}],
+        docs={langflow_id: _langflow_doc("Gehaltserhöhung", langflow_id)},
+    )
+    response = await client.post("/api/flows/sync")
+    assert response.status_code == 200, response.text
+    body = response.json()
+    assert body["pulled"] == ["gehaltserh-hung"]
+    assert body["added"] == ["gehaltserh-hung"]
+    assert body["errors"] == {}
+    assert (tmp_path / "gehaltserh-hung.json").is_file()
+
+    # Second pass: same content pulls again but syncs nothing new.
+    response = await client.post("/api/flows/sync")
+    assert response.status_code == 200, response.text
+    body = response.json()
+    assert body["pulled"] == ["gehaltserh-hung"]
+    assert body["skipped"] == ["gehaltserh-hung"]
+
+
+async def test_sync_endpoint_pull_error_continues(
+    client, lfx_server, tmp_path, monkeypatch, login, override_langflow
+):
+    await login()
+    monkeypatch.setattr(settings, "flows_dir", str(tmp_path))
+    good_id = "33333333-4444-4555-8666-777777777777"
+    override_langflow(
+        flows=[{"id": good_id, "name": "Gut"}, {"id": "kaputt-id", "name": "Kaputt"}],
+        docs={good_id: _langflow_doc("Gut", good_id)},
+    )
+    response = await client.post("/api/flows/sync")
+    assert response.status_code == 200, response.text
+    body = response.json()
+    assert body["pulled"] == ["gut"]
+    assert body["added"] == ["gut"]
+    assert "kaputt-id" in body["errors"]
+
+
+async def test_sync_endpoint_langflow_unreachable(
+    client, lfx_server, tmp_path, monkeypatch, login, override_langflow
+):
+    await login()
+    monkeypatch.setattr(settings, "flows_dir", str(tmp_path))
+    override_langflow(flows=[], list_status=0)
+    response = await client.post("/api/flows/sync")
+    assert response.status_code == 503
+
+
+async def test_sync_endpoint_langflow_error(
+    client, lfx_server, tmp_path, monkeypatch, login, override_langflow
+):
+    await login()
+    monkeypatch.setattr(settings, "flows_dir", str(tmp_path))
+    override_langflow(flows=[], list_status=500)
+    response = await client.post("/api/flows/sync")
+    assert response.status_code == 502
+
+
 async def test_watch_forever_triggers_on_file_change(tmp_path):
     import contextlib