Sprint 1: Stammdaten-Modelle/-Endpunkte, Admin-Benutzerverwaltung, Zuständigkeits-Vererbung (E2)

- ORM-Modelle: Bereich, Kategorie, Standort, Objekttyp, Material (Prompt 06/07),
  minimales Objekt-Modell (voll ausgebaut erst Sprint 2), Zustaendigkeit/
  Kontrollverantwortung
- Admin-API 7a: GET/POST Stammdaten-Endpunkte, PATCH Material, Benutzerverwaltung
  (anlegen/Rollen ändern), Zuständigkeits-/Kontrollverantwortungs-CRUD
- Vererbungslogik E2 als eigener Service (app/services/zustaendigkeit.py):
  Standort-Zuordnung vererbt sich auf alle Objekte, Objekt-Zeile ist Vereinigung
  statt Ersatz - GET /zustaendigkeiten/benutzer/{id}/objekte exponiert das
- Tests: Stammdaten-CRUD + Rollenrechte, Benutzerverwaltung (inkl. 409 bei
  Login-Duplikat), E2-Vererbungslogik (Standort-only, Standort+Objekt-Vereinigung,
  End-to-End über den Endpunkt)

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

backend/app/models/__init__.py

@@ -1,3 +1,22 @@
 from app.models.auth import Benutzer, BenutzerRolle, RolleTyp, Systemknoten, KnotenTyp
+from app.models.objekt import Objekt, ObjektStatus
+from app.models.stammdaten import Bereich, Kategorie, Material, MaterialTyp, Objekttyp, Standort
+from app.models.zustaendigkeit import Kontrollverantwortung, Zustaendigkeit
 
-__all__ = ["Benutzer", "BenutzerRolle", "RolleTyp", "Systemknoten", "KnotenTyp"]
+__all__ = [
+    "Benutzer",
+    "BenutzerRolle",
+    "RolleTyp",
+    "Systemknoten",
+    "KnotenTyp",
+    "Objekt",
+    "ObjektStatus",
+    "Bereich",
+    "Kategorie",
+    "Material",
+    "MaterialTyp",
+    "Objekttyp",
+    "Standort",
+    "Kontrollverantwortung",
+    "Zustaendigkeit",
+]

backend/app/models/objekt.py

@@ -0,0 +1,35 @@
+import enum
+
+from sqlalchemy import ForeignKey, String
+from sqlalchemy.dialects.postgresql import ENUM as PgEnum
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.db.base import Base
+
+
+class ObjektStatus(str, enum.Enum):
+    aktiv = "aktiv"
+    ausser_dienst = "ausser_dienst"
+
+
+objekt_status_pg = PgEnum(ObjektStatus, name="objekt_status", create_type=False)
+
+
+class Objekt(Base):
+    """Minimales Modell für Sprint 1 (nur für Zuständigkeits-Vererbung, Karte 04/E2
+    benötigt). Volle Objekt-Verwaltung (Vorlagen-Referenz, Duplizieren, Objektpositionen)
+    folgt Sprint 2 (Prompt 08/09/10) – dann kommt u.a. `vorlage_id` dazu."""
+
+    __tablename__ = "objekt"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    code: Mapped[str] = mapped_column(String, unique=True, nullable=False)
+    name: Mapped[str] = mapped_column(String, nullable=False)
+    objekttyp_id: Mapped[int] = mapped_column(ForeignKey("objekttyp.id"), nullable=False)
+    standort_id: Mapped[int] = mapped_column(ForeignKey("standort.id"), nullable=False)
+    status: Mapped[ObjektStatus] = mapped_column(
+        objekt_status_pg, nullable=False, default=ObjektStatus.aktiv
+    )
+    zustaendiger_server_id: Mapped[int] = mapped_column(
+        ForeignKey("systemknoten.id"), nullable=False
+    )

backend/app/models/stammdaten.py

@@ -0,0 +1,66 @@
+import enum
+
+from sqlalchemy import Boolean, ForeignKey, String, Text
+from sqlalchemy.dialects.postgresql import ENUM as PgEnum
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.db.base import Base
+
+
+class MaterialTyp(str, enum.Enum):
+    standard = "standard"
+    ablauf_charge = "ablauf_charge"
+    geraet_sn = "geraet_sn"
+
+
+materialtyp_pg = PgEnum(MaterialTyp, name="materialtyp", create_type=False)
+
+
+class Bereich(Base):
+    __tablename__ = "bereich"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    name: Mapped[str] = mapped_column(String, unique=True, nullable=False)
+    beschreibung: Mapped[str | None] = mapped_column(Text)
+
+
+class Kategorie(Base):
+    __tablename__ = "kategorie"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    bereich_id: Mapped[int] = mapped_column(ForeignKey("bereich.id"), nullable=False)
+    name: Mapped[str] = mapped_column(String, nullable=False)
+    ueberkategorie_id: Mapped[int | None] = mapped_column(ForeignKey("kategorie.id"))
+
+
+class Standort(Base):
+    __tablename__ = "standort"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    name: Mapped[str] = mapped_column(String, unique=True, nullable=False)
+    adresse: Mapped[str | None] = mapped_column(Text)
+
+
+class Objekttyp(Base):
+    __tablename__ = "objekttyp"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    bereich_id: Mapped[int] = mapped_column(ForeignKey("bereich.id"), nullable=False)
+    kategorie_id: Mapped[int | None] = mapped_column(ForeignKey("kategorie.id"))
+    name: Mapped[str] = mapped_column(String, nullable=False)
+
+
+class Material(Base):
+    __tablename__ = "material"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    name: Mapped[str] = mapped_column(String, nullable=False)
+    artikelnummer: Mapped[str | None] = mapped_column(String)
+    einheit: Mapped[str] = mapped_column(String, nullable=False)
+    materialtyp: Mapped[MaterialTyp] = mapped_column(materialtyp_pg, nullable=False)
+    kategorie_id: Mapped[int | None] = mapped_column(ForeignKey("kategorie.id"))
+    hersteller: Mapped[str | None] = mapped_column(String)
+    beschreibung: Mapped[str | None] = mapped_column(Text)
+    code: Mapped[str | None] = mapped_column(String, unique=True)
+    warnzeitraum_tage: Mapped[int | None] = mapped_column()
+    aktiv: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True)

backend/app/models/zustaendigkeit.py

@@ -0,0 +1,37 @@
+import uuid
+
+from sqlalchemy import CheckConstraint, ForeignKey, String
+from sqlalchemy.dialects.postgresql import UUID
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.db.base import Base
+
+
+class Zustaendigkeit(Base):
+    """Karte 04 / Sprintplan E2: Standort-Zuordnung vererbt sich auf alle Objekte
+    am Standort, Objekt-Zeile ist feinere Ergänzung (Vereinigung, kein Ersatz).
+    Siehe app/services/zustaendigkeit.py für die Auswertelogik."""
+
+    __tablename__ = "zustaendigkeit"
+    __table_args__ = (
+        CheckConstraint(
+            "standort_id IS NOT NULL OR objekt_id IS NOT NULL",
+            name="zustaendigkeit_standort_oder_objekt",
+        ),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    benutzer_id: Mapped[int] = mapped_column(ForeignKey("benutzer.id"), nullable=False)
+    standort_id: Mapped[int | None] = mapped_column(ForeignKey("standort.id"))
+    objekt_id: Mapped[int | None] = mapped_column(ForeignKey("objekt.id"))
+
+
+class Kontrollverantwortung(Base):
+    """Karte 01 / Sprintplan E3: reine Sichtbarkeit/Priorisierung, keine Pflichtkontrolle."""
+
+    __tablename__ = "kontrollverantwortung"
+
+    id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    objekt_id: Mapped[int] = mapped_column(ForeignKey("objekt.id"), nullable=False)
+    benutzer_id: Mapped[int | None] = mapped_column(ForeignKey("benutzer.id"))
+    gruppe: Mapped[str | None] = mapped_column(String)