feat(fach): Duplikate case-insensitiv verhindern, Verwendung anzeigen und ersetzen/zusammenführen

Anlegen prüft jetzt case-insensitiv auf Duplikate (409 statt "Fach A"
neben "fach a"). Neuer Endpunkt GET /faecher/{id}/objekte zeigt, welche
Objekte ein Fach über ihre Vorlage tatsächlich nutzen. POST
/faecher/{id}/ersetzen benennt um und zieht alle Vorlagenpositionen
mit; landet der neue Name auf einem bereits bestehenden Fach, werden
beide zusammengeführt. Frontend: Fach anklicken öffnet Verwendung +
Ersetzen-Eingabe direkt in der Fächer-Verwaltung.

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

backend/app/api/v1/endpoints/stammdaten.py

@@ -1,18 +1,22 @@
 from fastapi import APIRouter, Depends, HTTPException, status
-from sqlalchemy import select
+from sqlalchemy import func, select
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.api.deps import get_current_user, require_roles, require_roles_or_permission
 from app.db.session import get_db
 from app.models.auth import RolleTyp
+from app.models.objekt import Objekt
 from app.models.stammdaten import Bereich, Fach, Kategorie, Material, Objekttyp, Standort
+from app.models.vorlage import Beladungsvorlage, Vorlagenposition
 from app.schemas.stammdaten import (
     BereichCreate,
     BereichRead,
     BereichUpdate,
     FachCreate,
+    FachErsetzen,
     FachRead,
     FachUpdate,
+    FachVerwendungObjekt,
     KategorieCreate,
     KategorieRead,
     KategorieUpdate,
@@ -198,12 +202,92 @@ async def erstelle_fach(
     db: AsyncSession = Depends(get_db),
     _=Depends(require_roles(RolleTyp.administration)),
 ) -> Fach:
+    vorhanden = await db.execute(
+        select(Fach).where(
+            Fach.objekttyp_id == payload.objekttyp_id, func.lower(Fach.name) == payload.name.strip().lower()
+        )
+    )
+    if vorhanden.scalar_one_or_none() is not None:
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail="Fach existiert für diesen Objekttyp bereits (Groß-/Kleinschreibung ignoriert)",
+        )
     fach = Fach(**payload.model_dump())
     db.add(fach)
     await db.flush()
     return fach
 
 
+@router.get("/faecher/{fach_id}/objekte", response_model=list[FachVerwendungObjekt])
+async def hole_fach_verwendung(
+    fach_id: int, db: AsyncSession = Depends(get_db), _=Depends(require_roles(RolleTyp.administration))
+) -> list[Objekt]:
+    """Nutzer-Vorgabe: vor dem Umbenennen/Zusammenführen sehen, welche Objekte
+    ein Fach tatsächlich verwenden (über die Vorlage, aus der sie entstanden sind)."""
+    fach = await db.get(Fach, fach_id)
+    if fach is None:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Fach nicht gefunden")
+
+    result = await db.execute(
+        select(Objekt)
+        .join(Beladungsvorlage, Objekt.vorlage_id == Beladungsvorlage.id)
+        .join(Vorlagenposition, Vorlagenposition.vorlage_id == Beladungsvorlage.id)
+        .where(
+            Beladungsvorlage.objekttyp_id == fach.objekttyp_id,
+            func.lower(Vorlagenposition.fach) == fach.name.strip().lower(),
+        )
+        .distinct()
+    )
+    return list(result.scalars().all())
+
+
+@router.post("/faecher/{fach_id}/ersetzen", response_model=FachRead)
+async def ersetze_fach(
+    fach_id: int,
+    payload: FachErsetzen,
+    db: AsyncSession = Depends(get_db),
+    _=Depends(require_roles(RolleTyp.administration)),
+) -> Fach:
+    """Benennt ein Fach um und zieht alle Vorlagenpositionen mit - landet der
+    neue Name auf einem bereits bestehenden Fach desselben Objekttyps, werden
+    beide zusammengeführt (dieses Fach verschwindet, das Ziel bleibt)."""
+    fach = await db.get(Fach, fach_id)
+    if fach is None:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Fach nicht gefunden")
+
+    neuer_name = payload.neuer_name.strip()
+    if not neuer_name:
+        raise HTTPException(status_code=status.HTTP_422_UNPROCESSABLE_ENTITY, detail="Name darf nicht leer sein")
+
+    positionen = await db.execute(
+        select(Vorlagenposition)
+        .join(Beladungsvorlage, Vorlagenposition.vorlage_id == Beladungsvorlage.id)
+        .where(
+            Beladungsvorlage.objekttyp_id == fach.objekttyp_id,
+            func.lower(Vorlagenposition.fach) == fach.name.strip().lower(),
+        )
+    )
+    for position in positionen.scalars().all():
+        position.fach = neuer_name
+
+    ziel_result = await db.execute(
+        select(Fach).where(
+            Fach.objekttyp_id == fach.objekttyp_id,
+            func.lower(Fach.name) == neuer_name.lower(),
+            Fach.id != fach.id,
+        )
+    )
+    ziel = ziel_result.scalar_one_or_none()
+    if ziel is not None:
+        await db.delete(fach)
+        await db.flush()
+        return ziel
+
+    fach.name = neuer_name
+    await db.flush()
+    return fach
+
+
 @router.patch("/faecher/{fach_id}", response_model=FachRead)
 async def aendere_fach(
     fach_id: int,

backend/app/schemas/stammdaten.py

@@ -85,6 +85,16 @@ class FachUpdate(BaseModel):
     sortierung: int | None = None
 
 
+class FachErsetzen(BaseModel):
+    neuer_name: str
+
+
+class FachVerwendungObjekt(BaseModel):
+    id: int
+    name: str
+    code: str
+
+
 class MaterialCreate(BaseModel):
     name: str
     artikelnummer: str | None = None

backend/app/services/vorlagen.py

@@ -17,9 +17,10 @@ async def _stelle_faecher_sicher(
     if not benoetigt:
         return
     result = await db.execute(select(Fach.name).where(Fach.objekttyp_id == objekttyp_id))
-    vorhanden = set(result.scalars().all())
-    for name in benoetigt - vorhanden:
-        db.add(Fach(objekttyp_id=objekttyp_id, name=name))
+    vorhanden_klein = {name.strip().lower() for name in result.scalars().all()}
+    for name in benoetigt:
+        if name.strip().lower() not in vorhanden_klein:
+            db.add(Fach(objekttyp_id=objekttyp_id, name=name))
     await db.flush()