feat(warehouse): WH-005 Umlagerung zwischen Lagerplätzen

Atomare Aus+Ein-Buchung in einer Materialbewegung-Zeile statt zwei
Einzelschritten. NOTIF-001 war bereits produktiv umgesetzt, Backlog
war nur veraltet - korrigiert.

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

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

@@ -17,8 +17,15 @@ from app.schemas.lager import (
     LagerplatzCreate,
     LagerplatzRead,
     MaterialbewegungRead,
+    UmlagernRequest,
+)
+from app.services.lager import (
+    GleicherLagerplatzError,
+    NichtGenugBestandError,
+    auslagern,
+    einlagern,
+    umlagern,
 )
-from app.services.lager import NichtGenugBestandError, auslagern, einlagern
 
 router = APIRouter()
 
@@ -154,6 +161,38 @@ async def route_auslagern(
         raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail="Nicht genug Bestand am Lagerplatz") from exc
 
 
+@router.post(
+    "/lagerplaetze/{lagerplatz_id}/umlagern",
+    response_model=MaterialbewegungRead,
+    status_code=status.HTTP_201_CREATED,
+)
+async def route_umlagern(
+    lagerplatz_id: int,
+    payload: UmlagernRequest,
+    db: AsyncSession = Depends(get_db),
+    current_user=Depends(get_current_user),
+) -> Materialbewegung:
+    """WH-005: Verschieben in einem Schritt statt Aus+Ein manuell."""
+    await _get_or_404(db, Lagerplatz, lagerplatz_id, "Quell-Lagerplatz nicht gefunden")
+    await _get_or_404(db, Lagerplatz, payload.nach_lagerplatz_id, "Ziel-Lagerplatz nicht gefunden")
+    try:
+        return await umlagern(
+            db,
+            von_lagerplatz_id=lagerplatz_id,
+            nach_lagerplatz_id=payload.nach_lagerplatz_id,
+            material_id=payload.material_id,
+            menge=payload.menge,
+            benutzer_id=current_user.id,
+            grund=payload.grund,
+        )
+    except GleicherLagerplatzError as exc:
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT, detail="Quell- und Ziel-Lagerplatz sind identisch"
+        ) from exc
+    except NichtGenugBestandError as exc:
+        raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail="Nicht genug Bestand am Lagerplatz") from exc
+
+
 # -- Materialbewegung (WH-007) --------------------------------------------------
 
 @router.get("/materialbewegungen", response_model=list[MaterialbewegungRead])

backend/app/schemas/lager.py

@@ -55,6 +55,13 @@ class EinAuslagernRequest(BaseModel):
     grund: str | None = None
 
 
+class UmlagernRequest(BaseModel):
+    nach_lagerplatz_id: int
+    material_id: int
+    menge: Decimal
+    grund: str | None = None
+
+
 class MaterialbewegungRead(BaseModel):
     model_config = ConfigDict(from_attributes=True)
     id: uuid.UUID

backend/app/services/lager.py

@@ -42,6 +42,51 @@ async def einlagern(
     return bewegung
 
 
+class GleicherLagerplatzError(Exception):
+    pass
+
+
+async def umlagern(
+    db: AsyncSession,
+    *,
+    von_lagerplatz_id: int,
+    nach_lagerplatz_id: int,
+    material_id: int,
+    menge: Decimal,
+    benutzer_id: int,
+    grund: str | None,
+) -> Materialbewegung:
+    """WH-005: Aus- und Einlagerung atomar in einer Transaktion (get_db committet
+    erst nach Request-Ende), eine einzige Materialbewegung-Zeile mit Von+Nach
+    statt zwei Einzelbuchungen wie bei WH-004."""
+    if von_lagerplatz_id == nach_lagerplatz_id:
+        raise GleicherLagerplatzError
+
+    quelle = await _bestand_zeile(db, von_lagerplatz_id, material_id)
+    if quelle is None or quelle.menge < menge:
+        raise NichtGenugBestandError
+    quelle.menge -= menge
+
+    ziel = await _bestand_zeile(db, nach_lagerplatz_id, material_id)
+    if ziel is None:
+        ziel = Bestand(lagerplatz_id=nach_lagerplatz_id, material_id=material_id, menge=Decimal(0))
+        db.add(ziel)
+    ziel.menge += menge
+
+    bewegung = Materialbewegung(
+        material_id=material_id,
+        menge=menge,
+        von_lagerplatz_id=von_lagerplatz_id,
+        nach_lagerplatz_id=nach_lagerplatz_id,
+        benutzer_id=benutzer_id,
+        zeitpunkt=datetime.now(timezone.utc),
+        grund=grund,
+    )
+    db.add(bewegung)
+    await db.flush()
+    return bewegung
+
+
 async def auslagern(
     db: AsyncSession, *, lagerplatz_id: int, material_id: int, menge: Decimal, benutzer_id: int, grund: str | None
 ) -> Materialbewegung:

backend/tests/test_lager.py

@@ -82,3 +82,58 @@ async def test_ein_und_auslagerung_veraendert_bestand_korrekt(client, admin_user
         f"/api/v1/materialbewegungen?lagerplatz_id={platz_id}", headers=auth_header(token)
     )
     assert len(bewegungen.json()) == 2
+
+
+@pytest.mark.asyncio
+async def test_umlagerung_verschiebt_bestand_atomar(client, admin_user, material_factory):
+    token = await login(client, "admin1")
+    material = await material_factory("Beatmungsbeutel")
+
+    lagerort = await client.post(
+        "/api/v1/lagerorte", json={"name": "Lager Y", "typ": "lager"}, headers=auth_header(token)
+    )
+    quelle = await client.post(
+        "/api/v1/lagerplaetze",
+        json={"lagerort_id": lagerort.json()["id"], "code": "QUELLE-1"},
+        headers=auth_header(token),
+    )
+    ziel = await client.post(
+        "/api/v1/lagerplaetze",
+        json={"lagerort_id": lagerort.json()["id"], "code": "ZIEL-1"},
+        headers=auth_header(token),
+    )
+    quelle_id, ziel_id = quelle.json()["id"], ziel.json()["id"]
+
+    await client.post(
+        f"/api/v1/lagerplaetze/{quelle_id}/einlagern",
+        json={"material_id": material.id, "menge": "10"},
+        headers=auth_header(token),
+    )
+
+    um = await client.post(
+        f"/api/v1/lagerplaetze/{quelle_id}/umlagern",
+        json={"nach_lagerplatz_id": ziel_id, "material_id": material.id, "menge": "4"},
+        headers=auth_header(token),
+    )
+    assert um.status_code == 201
+    assert um.json()["von_lagerplatz_id"] == quelle_id
+    assert um.json()["nach_lagerplatz_id"] == ziel_id
+
+    bestand_quelle = await client.get(f"/api/v1/lagerplaetze/{quelle_id}/bestand", headers=auth_header(token))
+    assert bestand_quelle.json()[0]["menge"] == "6"
+    bestand_ziel = await client.get(f"/api/v1/lagerplaetze/{ziel_id}/bestand", headers=auth_header(token))
+    assert bestand_ziel.json()[0]["menge"] == "4"
+
+    gleich = await client.post(
+        f"/api/v1/lagerplaetze/{quelle_id}/umlagern",
+        json={"nach_lagerplatz_id": quelle_id, "material_id": material.id, "menge": "1"},
+        headers=auth_header(token),
+    )
+    assert gleich.status_code == 409
+
+    zu_viel = await client.post(
+        f"/api/v1/lagerplaetze/{quelle_id}/umlagern",
+        json={"nach_lagerplatz_id": ziel_id, "material_id": material.id, "menge": "999"},
+        headers=auth_header(token),
+    )
+    assert zu_viel.status_code == 409