Fahrzeug/Anhänger-Kopplung (objekt.gezogen_von_objekt_id)

Nutzer-Vorgabe: Fahrzeug und Anhänger beide als eigenständige Objekte
möglich, optional fest gekoppelt. Selbstreferenzierende nullable FK, kein
eigener Anhänger-Objekttyp nötig (Objekt bleibt generisch, Karte 11).
POST /objekte übergibt das Feld, neuer PATCH /objekte/{id} zum
nachträglichen Setzen/Lösen.

Von postgres-expert gegengeprüft, Fixes übernommen: ON DELETE SET NULL
(Zugfahrzeug entfernen blockiert Anhänger nicht), CHECK-Constraint gegen
Selbstbezug, Existenzprüfung + direkter Zyklus-Check (A↔B) im Endpoint statt
unhandled 500. Mehrstufige Ketten bewusst nicht geprüft (kein Anwendungsfall).

Tests: Anlage mit/ohne Kopplung, nachträglich setzen/lösen, Selbstbezug,
ungültiges Ziel, direkter Zyklus.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CVgbozhYmuEhiEJHffRXCV

backend/app/api/v1/endpoints/objekte.py

@@ -20,6 +20,7 @@ from app.schemas.objekt import (
     ObjektpositionRead,
     ObjektpositionUpdate,
     ObjektRead,
+    ObjektUpdate,
 )
 from app.services.objekte import (
     dupliziere_objekt,
@@ -192,6 +193,9 @@ async def erstelle_objekt(
     vorlage = await db.get(Beladungsvorlage, payload.vorlage_id)
     if vorlage is None:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Vorlage nicht gefunden")
+    if payload.gezogen_von_objekt_id is not None:
+        if await db.get(Objekt, payload.gezogen_von_objekt_id) is None:
+            raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Zugfahrzeug nicht gefunden")
 
     hauptserver = await db.execute(select(Systemknoten.id).where(Systemknoten.typ == KnotenTyp.haupt))
     zustaendiger_server_id = hauptserver.scalar_one()
@@ -204,11 +208,45 @@ async def erstelle_objekt(
             standort_id=payload.standort_id,
             vorlage=vorlage,
             zustaendiger_server_id=zustaendiger_server_id,
+            gezogen_von_objekt_id=payload.gezogen_von_objekt_id,
         )
     except IntegrityError as exc:
         raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail="Code bereits vergeben") from exc
 
 
+@router.patch("/objekte/{objekt_id}", response_model=ObjektRead)
+async def aendere_objekt(
+    objekt_id: int, payload: ObjektUpdate, db: AsyncSession = Depends(get_db), _=Depends(_admin_only)
+) -> Objekt:
+    """Fahrzeug/Anhänger-Kopplung nachträglich setzen/lösen (Nutzer-Vorgabe).
+    postgres-expert-Review-Fund: Zielobjekt-Existenz und direkter Zyklus (A↔B)
+    werden hier geprüft, mehrstufige Ketten sind fachlich nicht vorgesehen und
+    bewusst nicht geprüft (Aufwand/Nutzen)."""
+    objekt = await db.get(Objekt, objekt_id)
+    if objekt is None:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Objekt nicht gefunden")
+
+    daten = payload.model_dump(exclude_unset=True)
+    ziel_id = daten.get("gezogen_von_objekt_id")
+    if ziel_id is not None:
+        ziel = await db.get(Objekt, ziel_id)
+        if ziel is None:
+            raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Zugfahrzeug nicht gefunden")
+        if ziel.gezogen_von_objekt_id == objekt_id:
+            raise HTTPException(
+                status_code=status.HTTP_409_CONFLICT,
+                detail="Zyklus: Zielobjekt wird bereits von diesem Objekt gezogen",
+            )
+
+    for feld, wert in daten.items():
+        setattr(objekt, feld, wert)
+    try:
+        await db.flush()
+    except IntegrityError as exc:
+        raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail="Ungültige Zuordnung") from exc
+    return objekt
+
+
 @router.post(
     "/objekte/{objekt_id}/duplizieren", response_model=ObjektRead, status_code=status.HTTP_201_CREATED
 )