feat(dokumente,identity): DOC-003 Versionierung + QR-Code-Etiketten

Dokument-Versionierung: vorgaenger_id verkettet Versionen (Migration 0027),
POST /dokumente/{id}/ersetzen legt neue Version an statt zu überschreiben,
alte Fassung bleibt als Historie erhalten. GET /dokumente/{id}/versionen
liefert die Kette (neueste zuerst), respektiert DOC-005-Zugriffsrechte.
Liste zeigt nur die jeweils aktuelle Version. Löschen der aktuellen Version
gibt automatisch den Vorgänger als neue "aktuelle" frei. Frontend:
"Ersetzen"-Button + aufklappbare Versionshistorie im DokumentePanel.

QR-Code-Etiketten: bisher nur Code128-Barcode möglich. generiere_qr_label_pdf
(reportlab-eigenes QR-Widget, keine neue Abhängigkeit) als Alternative,
?format=qr|code128 an /objekte/{id}/label.pdf und /objektpositionen/{id}/
label.pdf. AktePage bekommt "Etikett (Barcode)"/"Etikett (QR)"-Buttons
(vorher gab es dafür noch gar keinen UI-Zugang im Web-Frontend).

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

backend/app/services/dokument.py

@@ -44,7 +44,7 @@ def _upload_pfad() -> Path:
     return pfad
 
 
-async def speichere_dokument(
+async def _pruefe_und_speichere(
     db: AsyncSession,
     *,
     entitaet_typ: str,
@@ -55,6 +55,7 @@ async def speichere_dokument(
     dokumenttyp: DokumentTyp,
     beschreibung: str | None,
     hochgeladen_von: int,
+    vorgaenger_id: uuid.UUID | None,
 ) -> Dokument:
     if mime_type not in ERLAUBTE_MIME_TYPES:
         raise DateityperlaubtError(mime_type)
@@ -92,12 +93,81 @@ async def speichere_dokument(
         beschreibung=beschreibung,
         hochgeladen_von=hochgeladen_von,
         hochgeladen_am=datetime.now(timezone.utc),
+        vorgaenger_id=vorgaenger_id,
     )
     db.add(dokument)
     await db.flush()
     return dokument
 
 
+async def speichere_dokument(
+    db: AsyncSession,
+    *,
+    entitaet_typ: str,
+    entitaet_id: str,
+    dateiname: str,
+    mime_type: str,
+    inhalt: bytes,
+    dokumenttyp: DokumentTyp,
+    beschreibung: str | None,
+    hochgeladen_von: int,
+) -> Dokument:
+    return await _pruefe_und_speichere(
+        db,
+        entitaet_typ=entitaet_typ,
+        entitaet_id=entitaet_id,
+        dateiname=dateiname,
+        mime_type=mime_type,
+        inhalt=inhalt,
+        dokumenttyp=dokumenttyp,
+        beschreibung=beschreibung,
+        hochgeladen_von=hochgeladen_von,
+        vorgaenger_id=None,
+    )
+
+
+async def ersetze_dokument(
+    db: AsyncSession,
+    *,
+    altes_dokument: Dokument,
+    dateiname: str,
+    mime_type: str,
+    inhalt: bytes,
+    beschreibung: str | None,
+    hochgeladen_von: int,
+) -> Dokument:
+    """DOC-003: neue Version anlegen statt zu überschreiben - altes_dokument
+    bleibt unverändert als Historieneintrag erhalten, entitaet_typ/entitaet_id/
+    dokumenttyp werden von ihm übernommen (nicht neu wählbar, es ist dieselbe
+    Sache in neuer Fassung)."""
+    return await _pruefe_und_speichere(
+        db,
+        entitaet_typ=altes_dokument.entitaet_typ,
+        entitaet_id=altes_dokument.entitaet_id,
+        dateiname=dateiname,
+        mime_type=mime_type,
+        inhalt=inhalt,
+        dokumenttyp=altes_dokument.dokumenttyp,
+        beschreibung=beschreibung,
+        hochgeladen_von=hochgeladen_von,
+        vorgaenger_id=altes_dokument.id,
+    )
+
+
+async def versionshistorie(db: AsyncSession, dokument: Dokument) -> list[Dokument]:
+    """Kette rückwärts über vorgaenger_id, neueste zuerst (inkl. übergebenem
+    Dokument selbst als erstem Eintrag)."""
+    kette = [dokument]
+    aktuelles = dokument
+    while aktuelles.vorgaenger_id is not None:
+        vorgaenger = await db.get(Dokument, aktuelles.vorgaenger_id)
+        if vorgaenger is None:
+            break
+        kette.append(vorgaenger)
+        aktuelles = vorgaenger
+    return kette
+
+
 async def liste_fuer_entitaet(
     db: AsyncSession,
     *,
@@ -106,7 +176,14 @@ async def liste_fuer_entitaet(
     dokumenttyp: DokumentTyp | None = None,
     darf_eingeschraenkte_sehen: bool = True,
 ) -> list[Dokument]:
-    bedingungen = [Dokument.entitaet_typ == entitaet_typ, Dokument.entitaet_id == entitaet_id]
+    # DOC-003: nur die jeweils aktuelle Version je Dokument zeigen - "aktuell"
+    # heißt, kein anderes Dokument hat vorgaenger_id auf dieses gesetzt.
+    ersetzte_ids = select(Dokument.vorgaenger_id).where(Dokument.vorgaenger_id.isnot(None))
+    bedingungen = [
+        Dokument.entitaet_typ == entitaet_typ,
+        Dokument.entitaet_id == entitaet_id,
+        Dokument.id.notin_(ersetzte_ids),
+    ]
     if dokumenttyp is not None:
         bedingungen.append(Dokument.dokumenttyp == dokumenttyp)
     if not darf_eingeschraenkte_sehen: