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
 )

backend/app/models/objekt.py

@@ -33,3 +33,9 @@ class Objekt(Base):
     zustaendiger_server_id: Mapped[int] = mapped_column(
         ForeignKey("systemknoten.id"), nullable=False
     )
+    # Fahrzeug/Anhänger-Kopplung (Nutzer-Vorgabe): optional, beide Fälle möglich -
+    # Anhänger als eigenständiges Objekt (NULL) oder fest einem Zugfahrzeug
+    # zugeordnet. Selbstreferenzierend, kein eigener Anhänger-Objekttyp nötig.
+    gezogen_von_objekt_id: Mapped[int | None] = mapped_column(
+        ForeignKey("objekt.id", ondelete="SET NULL")
+    )

backend/app/schemas/objekt.py

@@ -14,6 +14,7 @@ class ObjektCreate(BaseModel):
     objekttyp_id: int
     vorlage_id: int
     standort_id: int
+    gezogen_von_objekt_id: int | None = None
 
 
 class ObjektRead(BaseModel):
@@ -25,6 +26,11 @@ class ObjektRead(BaseModel):
     vorlage_id: int | None
     standort_id: int
     status: ObjektStatus
+    gezogen_von_objekt_id: int | None
+
+
+class ObjektUpdate(BaseModel):
+    gezogen_von_objekt_id: int | None = None
 
 
 class ObjektDuplizierenRequest(BaseModel):

backend/app/services/objekte.py

@@ -56,9 +56,12 @@ async def objekt_aus_vorlage(
     standort_id: int,
     vorlage: Beladungsvorlage,
     zustaendiger_server_id: int,
+    gezogen_von_objekt_id: int | None = None,
 ) -> Objekt:
     """Prompt 09 (Neuanlage, nicht Duplizieren): Objektpositionen werden aus den
-    Vorlagenpositionen initialisiert, Ist-Menge startet bei 0 ("nicht kontrolliert")."""
+    Vorlagenpositionen initialisiert, Ist-Menge startet bei 0 ("nicht kontrolliert").
+    gezogen_von_objekt_id: optionale Fahrzeug/Anhänger-Kopplung (Nutzer-Vorgabe),
+    beide Fälle möglich - unabhängiges Objekt (NULL) oder fest zugeordnet."""
     objekt = Objekt(
         code=code,
         name=name,
@@ -66,6 +69,7 @@ async def objekt_aus_vorlage(
         vorlage_id=vorlage.id,
         standort_id=standort_id,
         zustaendiger_server_id=zustaendiger_server_id,
+        gezogen_von_objekt_id=gezogen_von_objekt_id,
     )
     db.add(objekt)
     await db.flush()