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/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)