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>
This commit is contained in:
Scarriffle
2026-09-22 14:08:11 +02:00
co-authored by Claude Opus 5
parent ca4e9a2264
commit a3fd9819c4
18 changed files with 1012 additions and 17 deletions
+34
View File
@@ -778,6 +778,9 @@ class LoanCreate(BaseModel):
lent_on: date | None = None
# Erwartete Rückgabe – optional, siehe ItemLoan.
due_on: date | None = None
# Zubehörteile, die mitgehen. Leer = nur das Gerät selbst. Die Oberfläche
# fragt danach; der Server nimmt nie ungefragt etwas mit.
mit_zubehoer: list[int] = []
class LoanUpdate(BaseModel):
@@ -792,6 +795,9 @@ class LoanUpdate(BaseModel):
class LoanReturn(BaseModel):
"""Rückgabe buchen. Leeres Datum = heute."""
returned_on: date | None = None
# Zubehörteile, die mit zurückkommen. Spiegelbild zu LoanCreate: ohne das
# käme das Gerät zurück und sein Netzteil bliebe ewig „verliehen".
mit_zubehoer: list[int] = []
class LoanOut(BaseModel):
@@ -818,6 +824,30 @@ class LoanOut(BaseModel):
location_name: str | None = None
class ItemKurz(BaseModel):
"""Ein Einzelstueck in Kurzform – fuer Zubehoer-Listen in beide Richtungen.
Bewusst nicht das volle ItemOut: sonst zoege das Geraet seine Teile und jedes
Teil wieder sein Geraet nach, endlos.
"""
model_config = ConfigDict(from_attributes=True)
id: int
uid: str
product_id: int
product_name: str | None = None
product_brand: str | None = None
location_name: str | None = None
# Damit die Oberflaeche ein mitverliehenes Teil kennzeichnen kann.
verliehen: bool = False
class ZubehoerZuordnen(BaseModel):
"""Welches Stueck als Zubehoer an dieses Geraet gehaengt wird."""
child_item_id: int
class ItemOut(BaseModel):
model_config = ConfigDict(from_attributes=True)
id: int
@@ -842,6 +872,10 @@ class ItemOut(BaseModel):
# Der offene Verleih, falls das Stück gerade draußen ist – sonst None.
# Der Lagerort bleibt daneben stehen: dorthin gehört es zurück.
loan: LoanOut | None = None
# Zubehör: die Teile dieses Geräts und, umgekehrt, das Gerät, zu dem dieses
# Stück gehört. Beide Richtungen, weil beide Fragen im Alltag vorkommen.
zubehoer: list[ItemKurz] = []
gehoert_zu: ItemKurz | None = None
# ---- Views ----