Rueckgabe sichtbar machen, Zubehoerteile am Einzelstueck

RUECKGABE
Der Knopf war da, nur nicht zu finden: ein 16-px-Symbol in einer Spalte ohne
Ueberschrift, 52 px breit, ganz rechts in einer horizontal scrollenden Tabelle.
Beschriftet war er allein ueber title= - ein Tooltip, den auf einem Touchgeraet
nie jemand sieht.

Jetzt traegt er Text ("Zuruecknehmen"), die Spalte heisst "Verleih" und ist
breit genug, und beide Knoepfe haben ein aria-label. Dazu eine neue Seite
"Verliehen" in der Seitenleiste: alles Draussene an einem Ort, Rueckgabe direkt
aus der Liste. Bisher gab es diese Uebersicht nur als zwei Dashboard-Karten, und
die stehen nicht im Standard-Layout - wer sie nicht selbst hinzufuegte, hatte
gar keine.

In der App fuehrte der einzige Weg ueber das Bearbeiten-Formular des Stuecks;
jetzt geht es per Wischgeste und Kontextmenue direkt aus der Liste. Der
Verleih-Filter dort sass hinter einem nackten Symbol und ist beschriftet.

Zurueckgenommen wird nur noch nach Rueckfrage, in Web und App.

ZUBEHOER
Ein Netzteil gehoert zu einem Laptop: items.parent_item_id, genau ein Geraet je
Teil, beliebig viele Teile je Geraet. Eine Spalte genuegt dafuer, es braucht
keine Verknuepfungstabelle. ON DELETE SET NULL, damit das Netzteil den Laptop
ueberlebt statt mitgeloescht zu werden - und weil SQLite Fremdschluessel nicht
erzwingt, loest der Router die Zuordnung beim Loeschen zusaetzlich selbst.

Ringe (A traegt B, B traegt A) weist die Zuordnung mit 409 ab; die Elternkette
wird dafuer hochgelaufen, wie beim Kategoriebaum.

Die Beziehung laeuft ueber eigene Endpunkte und bewusst NICHT ueber ItemUpdate:
dessen Schema sendet immer alle Felder mit, auch leere, damit sich Felder
loeschen lassen. Genau so gingen schon einmal Kaufpreis und Waehrung verloren,
als ein Aufrufer ein Feld vergass.

Beim Verleihen fragt die Oberflaeche, welche Teile mitgehen (vorausgewaehlt:
alles, was im Haus ist), beim Zuruecknehmen kommen sie zusammen zurueck. Ohne
das Spiegelbild kaeme das Geraet zurueck und sein Netzteil bliebe ewig
"verliehen", weil niemand mehr danach sucht. Ungefragt nimmt der Server nie
etwas mit.

In der App sind zubehoer und gehoert_zu optional dekodiert: Die App spricht mit
mehreren Serverprofilen, und ein aelterer Server schickt die Felder nicht - ein
Vorgabewert reicht dafuer nicht, Swift nimmt ihn beim Dekodieren nicht her.

12 neue Tests (320 gesamt). Der Umlauf ist ausserdem gegen ein lokales Backend
im Browser durchgespielt: verleihen mit Zubehoer, Rueckfrage, beide zusammen
zurueck.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

backend/app/routers/items.py

@@ -31,6 +31,7 @@ from ..schemas import (
     ItemOut,
     ItemRemove,
     ItemUpdate,
+    ZubehoerZuordnen,
 )
 from ..services.items import generate_uid, item_to_out
 from ..services.warranty import (
@@ -56,6 +57,18 @@ def _product_or_404(db: Session, product_id: int) -> Product:
     return product
 
 
+def _zubehoer_freigeben(item: Item) -> None:
+    """Zubehoer vom Geraet loesen, bevor das Geraet verschwindet.
+
+    ON DELETE SET NULL steht zwar am Fremdschluessel, aber SQLite erzwingt
+    Fremdschluessel nicht - in den Tests bliebe sonst eine tote Zuordnung
+    stehen. Dieselbe Vorsicht wie beim Loeschen einer Gruppe.
+    """
+    for teil in list(item.zubehoer):
+        teil.parent_item_id = None
+    item.parent_item_id = None
+
+
 def _item_or_404(db: Session, item_id: int) -> Item:
     item = db.get(Item, item_id)
     if item is None:
@@ -208,6 +221,7 @@ def remove_item(
 ) -> None:
     """Einzelstück mit Grund entfernen – als Bewegung protokolliert (Statistik je Modell)."""
     item = _item_or_404(db, item_id)
+    _zubehoer_freigeben(item)
     db.add(
         Movement(
             product_id=item.product_id,
@@ -232,7 +246,83 @@ def delete_item(
     _: User = Depends(require_admin),
 ) -> None:
     """Einzelstück ohne Grund löschen (Korrektur)."""
-    db.delete(_item_or_404(db, item_id))
+    item = _item_or_404(db, item_id)
+    _zubehoer_freigeben(item)
+    db.delete(item)
+    db.commit()
+
+
+
+# --------------------------------------------------------------------------
+# Zubehoer: ein Einzelstueck gehoert zu einem anderen (Netzteil -> Laptop)
+# --------------------------------------------------------------------------
+def _ringpruefung(db: Session, geraet: Item, teil: Item) -> None:
+    """Verhindert, dass ein Stueck ueber Umwege sein eigenes Zubehoer wird.
+
+    Mit nur einem Elternteil je Teil ist die Kette kurz, aber A->B->A waere
+    ohne Pruefung moeglich - und danach liefe jedes Hochlaufen der Kette
+    endlos. Deshalb vom Geraet aus nach oben gehen, wie beim Kategoriebaum.
+    """
+    if geraet.id == teil.id:
+        raise HTTPException(
+            status.HTTP_409_CONFLICT, "Ein Einzelstück kann nicht sein eigenes Zubehör sein"
+        )
+    gesehen: set[int] = set()
+    lauf = geraet.gehoert_zu
+    while lauf is not None and lauf.id not in gesehen:
+        if lauf.id == teil.id:
+            raise HTTPException(
+                status.HTTP_409_CONFLICT,
+                f"„{teil.uid}“ ist bereits weiter oben in dieser Zubehör-Kette",
+            )
+        gesehen.add(lauf.id)
+        lauf = lauf.gehoert_zu
+
+
+@router.post("/items/{item_id}/zubehoer", response_model=ItemOut)
+def zubehoer_zuordnen(
+    item_id: int,
+    payload: ZubehoerZuordnen,
+    db: Session = Depends(get_db),
+    _: User = Depends(require_admin),
+) -> ItemOut:
+    """Ein Einzelstück als Zubehör an dieses Gerät hängen.
+
+    Eigener Endpunkt und nicht über ``ItemUpdate``: Das Schema sendet bewusst
+    immer alle Felder mit, auch leere, damit sich Felder loeschen lassen. Eine
+    Beziehung darueber zu pflegen hiesse, dass ein Aufrufer sie still kappt,
+    sobald er das Feld vergisst - genau so gingen schon einmal Kaufpreis und
+    Waehrung verloren.
+    """
+    geraet = _item_or_404(db, item_id)
+    teil = _item_or_404(db, payload.child_item_id)
+    _ringpruefung(db, geraet, teil)
+    # Ein Teil haengt an genau einem Geraet - ein Wechsel ist deshalb einfach
+    # ein Umhaengen und braucht kein vorheriges Loesen.
+    teil.parent_item_id = geraet.id
+    db.commit()
+    db.refresh(geraet)
+    return item_to_out(geraet)
+
+
+@router.delete(
+    "/items/{item_id}/zubehoer/{child_item_id}", status_code=status.HTTP_204_NO_CONTENT
+)
+def zubehoer_loesen(
+    item_id: int,
+    child_item_id: int,
+    db: Session = Depends(get_db),
+    _: User = Depends(require_admin),
+) -> None:
+    """Zubehör vom Gerät lösen. Das Stück selbst bleibt bestehen."""
+    geraet = _item_or_404(db, item_id)
+    teil = _item_or_404(db, child_item_id)
+    if teil.parent_item_id != geraet.id:
+        raise HTTPException(
+            status.HTTP_404_NOT_FOUND,
+            f"„{teil.uid}“ gehört nicht zu „{geraet.uid}“",
+        )
+    teil.parent_item_id = None
     db.commit()
 
 

backend/app/routers/loans.py

@@ -51,6 +51,28 @@ def _pruefe_zeitfolge(lent_on: date, due_on: date | None, returned_on: date | No
         )
 
 
+def _zubehoer_pruefen(db: Session, geraet: Item, ids: list[int]) -> list[Item]:
+    """Die benannten Teile holen und pruefen, dass sie zu diesem Geraet gehoeren.
+
+    Ohne die Pruefung koennte ein Aufrufer ueber diesen Weg ein beliebiges
+    fremdes Stueck mitverleihen.
+    """
+    teile: list[Item] = []
+    for teil_id in dict.fromkeys(ids):
+        teil = db.get(Item, teil_id)
+        if teil is None:
+            raise HTTPException(
+                status.HTTP_404_NOT_FOUND, "Zubehörteil nicht gefunden"
+            )
+        if teil.parent_item_id != geraet.id:
+            raise HTTPException(
+                status.HTTP_400_BAD_REQUEST,
+                f"„{teil.uid}“ ist kein Zubehör von „{geraet.uid}“",
+            )
+        teile.append(teil)
+    return teile
+
+
 @router.post(
     "/items/{item_id}/loan", response_model=LoanOut, status_code=status.HTTP_201_CREATED
 )
@@ -81,6 +103,27 @@ def lend_item(
         user_id=user.id,
     )
     db.add(loan)
+
+    # Zubehoer geht nur mit, wenn es ausdruecklich benannt wurde - die
+    # Oberflaeche fragt danach. Ein Netzteil, das im Schrank bleibt, darf nicht
+    # als verliehen gefuehrt werden, nur weil es am Geraet haengt.
+    for teil in _zubehoer_pruefen(db, item, payload.mit_zubehoer):
+        if offener_verleih(db, teil.id) is not None:
+            raise HTTPException(
+                status.HTTP_409_CONFLICT,
+                f"„{teil.uid}“ ist bereits verliehen.",
+            )
+        db.add(
+            ItemLoan(
+                item_id=teil.id,
+                borrower=name,
+                reason=(payload.reason or "").strip() or None,
+                lent_on=lent_on,
+                due_on=payload.due_on,
+                user_id=user.id,
+            )
+        )
+
     db.commit()
     db.refresh(loan)
     return loan_to_out(loan)
@@ -103,6 +146,16 @@ def return_item(
     returned_on = payload.returned_on or date.today()
     _pruefe_zeitfolge(loan.lent_on, loan.due_on, returned_on)
     loan.returned_on = returned_on
+
+    # Spiegelbild zum Verleihen: Ohne das kaeme das Geraet zurueck und sein
+    # Netzteil bliebe ewig „verliehen“, weil niemand mehr danach sucht.
+    for teil in _zubehoer_pruefen(db, item, payload.mit_zubehoer):
+        offen = offener_verleih(db, teil.id)
+        if offen is None:
+            continue  # war gar nicht mit draussen – kein Fehler, nur nichts zu tun
+        _pruefe_zeitfolge(offen.lent_on, offen.due_on, returned_on)
+        offen.returned_on = returned_on
+
     db.commit()
     db.refresh(loan)
     return loan_to_out(loan)