Karte 10: Geräte-Code für Objektpositionen (Code128-Vorbereitung) + Code-Vorschlag

objektposition.code (nullable, unique) für Geräte-Etiketten, separat von
seriennummer. Lookup-Endpunkt für Geräte-Scan (GET /objektpositionen/code/{code})
sowie Auto-Vorschlag PRAEFIX-NNN für Objekt- und Objektposition-Codes
(GET /objekte/naechster-code, GET /objektpositionen/naechster-code).

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

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

@@ -19,7 +19,13 @@ from app.schemas.objekt import (
     ObjektpositionUpdate,
     ObjektRead,
 )
-from app.services.objekte import dupliziere_objekt, objekt_aus_vorlage, sollmenge_effektiv, sollmenge_map
+from app.services.objekte import (
+    dupliziere_objekt,
+    naechster_freier_code,
+    objekt_aus_vorlage,
+    sollmenge_effektiv,
+    sollmenge_map,
+)
 
 router = APIRouter()
 
@@ -53,6 +59,53 @@ async def hole_objekt_per_code(
     return objekt
 
 
+@router.get("/objekte/naechster-code")
+async def naechster_objekt_code(
+    praefix: str, db: AsyncSession = Depends(get_db), _=Depends(get_current_user)
+) -> dict[str, str]:
+    """Code-Vorschlag beim Anlegen/Duplizieren (Konzept-Ergänzung Karte 10/Prompt 09).
+    Vorschlag ist überschreibbar, Eindeutigkeit erzwingt weiterhin objekt.code UNIQUE."""
+    return {"code": await naechster_freier_code(db, Objekt.code, praefix)}
+
+
+@router.get("/objektpositionen/naechster-code")
+async def naechster_objektposition_code(
+    praefix: str, db: AsyncSession = Depends(get_db), _=Depends(get_current_user)
+) -> dict[str, str]:
+    """Code-Vorschlag für Geräte-Exemplare (objektposition.code, eigener
+    Nummernkreis je Präfix, unabhängig von objekt.code)."""
+    return {"code": await naechster_freier_code(db, Objektposition.code, praefix)}
+
+
+@router.get("/objektpositionen/code/{code}", response_model=ObjektpositionRead)
+async def hole_objektposition_per_code(
+    code: str, db: AsyncSession = Depends(get_db), _=Depends(get_current_user)
+) -> ObjektpositionRead:
+    """Geräte-Scan (Konzept-Ergänzung Karte 10/Prompt 09): Code128-Etikett am
+    Exemplar identifiziert die Objektposition direkt, unabhängig vom Objekt-Code -
+    löst SN-vorbelegte Kontroll-Erfassung ohne Umweg über Objekt-Scan aus."""
+    result = await db.execute(select(Objektposition).where(Objektposition.code == code))
+    position = result.scalar_one_or_none()
+    if position is None:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Objektposition nicht gefunden")
+
+    objekt = await db.get(Objekt, position.objekt_id)
+    vorlagen_sollmengen = await sollmenge_map(db, objekt.vorlage_id if objekt else None)
+    return ObjektpositionRead(
+        id=position.id,
+        objekt_id=position.objekt_id,
+        material_id=position.material_id,
+        sollmenge_override=position.sollmenge_override,
+        sollmenge_effektiv=sollmenge_effektiv(position, vorlagen_sollmengen),
+        ist_status=position.ist_status,
+        istmenge=position.istmenge,
+        seriennummer=position.seriennummer,
+        ablaufdatum=position.ablaufdatum,
+        chargennummer=position.chargennummer,
+        code=position.code,
+    )
+
+
 @router.get("/objekte/{objekt_id}", response_model=ObjektRead)
 async def hole_objekt(
     objekt_id: int, db: AsyncSession = Depends(get_db), _=Depends(get_current_user)
@@ -86,6 +139,7 @@ async def liste_objektpositionen(
             seriennummer=p.seriennummer,
             ablaufdatum=p.ablaufdatum,
             chargennummer=p.chargennummer,
+            code=p.code,
         )
         for p in positionen
     ]
@@ -176,6 +230,7 @@ async def aendere_objektposition(
         seriennummer=position.seriennummer,
         ablaufdatum=position.ablaufdatum,
         chargennummer=position.chargennummer,
+        code=position.code,
     )
 
 
@@ -219,4 +274,5 @@ async def fuege_zusatzposition_hinzu(
         seriennummer=position.seriennummer,
         ablaufdatum=position.ablaufdatum,
         chargennummer=position.chargennummer,
+        code=position.code,
     )