Sprint 2: Beladungsvorlagen (Versionierung), Objekte anlegen/duplizieren, Override-Logik

- Beladungsvorlage/Vorlagenposition-Modelle + Endpunkte: erstellen, neue Version
  (Prompt 08 Punkt 4 - alte Version bleibt unverändert lesbar statt überschrieben)
- Objekt-Anlage aus Vorlage: Objektpositionen werden initialisiert, Ist-Menge startet
  bei 0 ("nicht kontrolliert", Prompt 09)
- Duplizieren: Struktur/Sollmengen-Override kopiert, Ist-Menge/SN/Ablauf/Charge NICHT,
  neuer Code Pflicht (409 bei Kollision)
- Sollmengen-Auflösung (Prompt 10): Override schlägt Vorlagenwert, sonst dynamisch aus
  aktueller Vorlagenposition des Objekts
- GET /objekte/code/{code} bewusst vor /objekte/{id} registriert (Routing-Reihenfolge)
- Bugfix: app.models muss vollständig importiert werden (main.py + conftest.py), sonst
  schlägt FK-Auflösung zwischen Modellen fehl, die noch von keinem Endpoint berührt
  werden (Fund im dritten echten CI-Lauf)
- Tests: U8 (Override schlägt Vorlage), U9 (Duplizieren-Kopierregeln + Code-Konflikt),
  U10 (neue Version, alte bleibt lesbar), Rollenrechte

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

backend/tests/conftest.py

@@ -3,13 +3,17 @@ import pytest_asyncio
 from httpx import ASGITransport, AsyncClient
 from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
 
+import app.models  # noqa: F401  (registriert ALLE ORM-Modelle an Base.metadata, auch
+# solche, die noch von keinem API-Endpunkt importiert werden - sonst schlägt die
+# FK-Auflösung für andere Modelle fehl, sobald z. B. Objekt.vorlage_id auf eine noch
+# nicht importierte Tabelle zeigt. Fund im dritten echten CI-Lauf.)
 from app.core.app_settings import settings
 from app.core.security import hash_password
 from app.db.session import get_db
 from app.main import app
 from app.models.auth import Benutzer, BenutzerRolle, RolleTyp
 from app.models.objekt import Objekt
-from app.models.stammdaten import Bereich, Objekttyp, Standort
+from app.models.stammdaten import Bereich, Material, MaterialTyp, Objekttyp, Standort
 
 
 @pytest_asyncio.fixture
@@ -144,3 +148,28 @@ async def objekt_factory(db_session, hauptserver_id):
         return objekt
 
     return _make
+
+
+@pytest_asyncio.fixture
+async def material_factory(db_session):
+    async def _make(name: str) -> Material:
+        material = Material(name=name, einheit="Stück", materialtyp=MaterialTyp.standard)
+        db_session.add(material)
+        await db_session.flush()
+        return material
+
+    return _make
+
+
+@pytest_asyncio.fixture
+async def objekttyp_factory(db_session):
+    async def _make(name: str) -> Objekttyp:
+        bereich = Bereich(name=f"Bereich-{name}")
+        db_session.add(bereich)
+        await db_session.flush()
+        objekttyp = Objekttyp(bereich_id=bereich.id, name=name)
+        db_session.add(objekttyp)
+        await db_session.flush()
+        return objekttyp
+
+    return _make

backend/tests/test_objekte.py

@@ -0,0 +1,168 @@
+import pytest
+
+from app.services.vorlagen import erstelle_vorlage
+from app.schemas.vorlage import VorlagenpositionCreate
+from tests.conftest import auth_header, login
+
+
+@pytest.mark.asyncio
+async def test_objekt_aus_vorlage_startet_unkontrolliert(
+    client, db_session, objekttyp_factory, material_factory, standort_factory, admin_user
+):
+    objekttyp = await objekttyp_factory("Rucksack Handball")
+    material = await material_factory("Kompresse")
+    standort = await standort_factory("Wache A")
+    vorlage = await erstelle_vorlage(
+        db_session,
+        objekttyp_id=objekttyp.id,
+        name="Rucksack Handball Standard",
+        positionen=[VorlagenpositionCreate(material_id=material.id, sollmenge=10)],
+    )
+
+    token = await login(client, "admin1")
+    response = await client.post(
+        "/api/v1/objekte",
+        json={
+            "code": "RH-01",
+            "name": "Rucksack Handball 1",
+            "objekttyp_id": objekttyp.id,
+            "vorlage_id": vorlage.id,
+            "standort_id": standort.id,
+        },
+        headers=auth_header(token),
+    )
+    assert response.status_code == 201
+    objekt_id = response.json()["id"]
+
+    positionen_response = await client.get(
+        f"/api/v1/objekte/{objekt_id}/positionen", headers=auth_header(token)
+    )
+    assert positionen_response.status_code == 200
+    positionen = positionen_response.json()
+    assert len(positionen) == 1
+    assert float(positionen[0]["istmenge"]) == 0
+    assert float(positionen[0]["sollmenge_effektiv"]) == 10
+
+
+@pytest.mark.asyncio
+async def test_duplizieren_kopiert_struktur_nicht_zustand(
+    client, db_session, objekttyp_factory, material_factory, standort_factory, admin_user
+):
+    """U9: Struktur/Sollmengen ja, Ist-Menge/SN/Ablauf/Charge nein, neuer eindeutiger Code."""
+    objekttyp = await objekttyp_factory("Rucksack Handball")
+    material = await material_factory("Kompresse")
+    standort = await standort_factory("Wache A")
+    vorlage = await erstelle_vorlage(
+        db_session,
+        objekttyp_id=objekttyp.id,
+        name="Rucksack Handball Standard",
+        positionen=[VorlagenpositionCreate(material_id=material.id, sollmenge=10)],
+    )
+
+    token = await login(client, "admin1")
+    create_response = await client.post(
+        "/api/v1/objekte",
+        json={
+            "code": "RH-02",
+            "name": "Rucksack Handball 2",
+            "objekttyp_id": objekttyp.id,
+            "vorlage_id": vorlage.id,
+            "standort_id": standort.id,
+        },
+        headers=auth_header(token),
+    )
+    objekt_id = create_response.json()["id"]
+
+    positionen = (
+        await client.get(f"/api/v1/objekte/{objekt_id}/positionen", headers=auth_header(token))
+    ).json()
+    position_id = positionen[0]["id"]
+    patch_response = await client.patch(
+        f"/api/v1/objekte/{objekt_id}/positionen/{position_id}",
+        json={"istmenge": "8", "seriennummer": "SN-123", "sollmenge_override": "12"},
+        headers=auth_header(token),
+    )
+    assert patch_response.status_code == 200
+
+    duplicate_response = await client.post(
+        f"/api/v1/objekte/{objekt_id}/duplizieren",
+        json={"neuer_code": "RH-03", "neuer_name": "Rucksack Handball 3", "neuer_standort_id": standort.id},
+        headers=auth_header(token),
+    )
+    assert duplicate_response.status_code == 201
+    neues_objekt_id = duplicate_response.json()["id"]
+
+    neue_positionen = (
+        await client.get(f"/api/v1/objekte/{neues_objekt_id}/positionen", headers=auth_header(token))
+    ).json()
+    assert len(neue_positionen) == 1
+    kopie = neue_positionen[0]
+    assert float(kopie["sollmenge_override"]) == 12  # Struktur/Override kopiert
+    assert float(kopie["istmenge"]) == 0  # Zustand NICHT kopiert
+    assert kopie["seriennummer"] is None  # Zustand NICHT kopiert
+
+
+@pytest.mark.asyncio
+async def test_duplizieren_mit_vergebenem_code_ist_409(
+    client, db_session, objekttyp_factory, standort_factory, admin_user
+):
+    objekttyp = await objekttyp_factory("Fahrzeug")
+    standort = await standort_factory("Wache B")
+    vorlage = await erstelle_vorlage(
+        db_session, objekttyp_id=objekttyp.id, name="Fahrzeug Standard", positionen=[]
+    )
+
+    token = await login(client, "admin1")
+    erst = await client.post(
+        "/api/v1/objekte",
+        json={
+            "code": "FZ-01",
+            "name": "Fahrzeug 1",
+            "objekttyp_id": objekttyp.id,
+            "vorlage_id": vorlage.id,
+            "standort_id": standort.id,
+        },
+        headers=auth_header(token),
+    )
+    objekt_id = erst.json()["id"]
+
+    # zweites Objekt mit Code, den wir gleich für die Duplizierung kollidieren lassen
+    await client.post(
+        "/api/v1/objekte",
+        json={
+            "code": "FZ-02",
+            "name": "Fahrzeug 2",
+            "objekttyp_id": objekttyp.id,
+            "vorlage_id": vorlage.id,
+            "standort_id": standort.id,
+        },
+        headers=auth_header(token),
+    )
+
+    konflikt_response = await client.post(
+        f"/api/v1/objekte/{objekt_id}/duplizieren",
+        json={"neuer_code": "FZ-02", "neuer_name": "Fahrzeug Kopie", "neuer_standort_id": standort.id},
+        headers=auth_header(token),
+    )
+    assert konflikt_response.status_code == 409
+
+
+@pytest.mark.asyncio
+async def test_mitarbeiter_kann_objekte_nicht_anlegen(
+    client, objekttyp_factory, standort_factory, mitarbeiter_user
+):
+    objekttyp = await objekttyp_factory("Rucksack")
+    standort = await standort_factory("Wache A")
+    token = await login(client, "mitarbeiter1")
+    response = await client.post(
+        "/api/v1/objekte",
+        json={
+            "code": "X-01",
+            "name": "X",
+            "objekttyp_id": objekttyp.id,
+            "vorlage_id": 999999,
+            "standort_id": standort.id,
+        },
+        headers=auth_header(token),
+    )
+    assert response.status_code == 403

backend/tests/test_vorlagen.py

@@ -0,0 +1,34 @@
+import pytest
+
+from app.services.vorlagen import erstelle_vorlage, hole_positionen, neue_version
+from app.schemas.vorlage import VorlagenpositionCreate
+
+
+@pytest.mark.asyncio
+async def test_neue_version_alte_bleibt_lesbar(db_session, objekttyp_factory, material_factory):
+    """U10: Vorlagenänderung erzeugt neue Version, alte Version bleibt unverändert lesbar."""
+    objekttyp = await objekttyp_factory("Rucksack Handball")
+    material = await material_factory("BZ-Messtreifen")
+
+    v1 = await erstelle_vorlage(
+        db_session,
+        objekttyp_id=objekttyp.id,
+        name="Rucksack Handball Standard",
+        positionen=[VorlagenpositionCreate(material_id=material.id, sollmenge=10)],
+    )
+    assert v1.version == 1
+
+    v2 = await neue_version(
+        db_session,
+        aktuelle_vorlage=v1,
+        positionen=[VorlagenpositionCreate(material_id=material.id, sollmenge=15)],
+    )
+
+    assert v2.version == 2
+    assert v2.status.value == "aktiv"
+    assert v1.status.value == "veraltet"
+
+    v1_positionen = await hole_positionen(db_session, v1.id)
+    v2_positionen = await hole_positionen(db_session, v2.id)
+    assert v1_positionen[0].sollmenge == 10
+    assert v2_positionen[0].sollmenge == 15