Server+Client: REST-API für Entität Projekt, Kontakt auf REST umgestellt, ID-basiertes Laden, CLI-Musterprojekte, VS-Code Task

- Server: ORM-Modell Projekt (Tabelle projekte) mit FK kunden_id, Relationship zu Kunde
- Server: Geschäftslogik projekt.py (get/create/update/delete)
- Server: DB-Migration V01_02 (projekte-Tabelle)
- Server: REST-Endpunkte /xhr/projekt/* mit Autorisierung
- Server: CLI init-db legt Muster-Projekte je Kunde an (1-3)
- Client: kontakt.ts auf REST umgestellt, In-Memory entfernt, snake_case
- Client: projekt.ts auf REST umgestellt, In-Memory behalten für call_log/kontaktadresse
- Client: ID-basiertes Laden (nur ID in Route-Params, fetchById im oninit)
- Client: Kundenname in Überschrift von Kontaktliste/View und Projektliste/View
- Client: Select-Widget entfernt (Kunde voreingestellt), Hidden-Input für kunden_id
- Client: kunde.ts showProjekte/showKontakte auf kunden_id geändert
- Client: call_log.ts/kontaktadresse.ts Feldzugriffe auf iProjekt snake_case angepasst
- AGENTS.md: Vorgehensweise ID-basiertes Laden hinterlegt, Branch-Regel formuliert
- VS-Code Task "Flask: init-db" mit venv-Pfaden

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>

App_Server/root/crm/model/kontakt.py

@@ -0,0 +1,120 @@
+"""
+Geschäftslogik für die Entität Kontakt.
+
+Diese Funktionen kapseln den DB-Zugriff und die fachlichen Validierungen.
+Aufgerufen werden sie aus crm/routes.py; die Autorisierungsprüfung erfolgt
+dort über den Decorator authorisation_required.
+
+:author:  Mistral Vibe <vibe@mistral.ai>
+:date:    2026-09-03
+:version: 1.0
+"""
+from db import dbapp
+from crm.model import Kontakt, Kunde
+
+from auth.model.errors import ApplicationError, HtmlStatusCode
+
+session = dbapp.session
+
+
+def get_kontakte():
+    """
+    Liefert alle Kontakte, sortiert nach Name.
+    """
+    return Kontakt.query.order_by(Kontakt.name).all()
+
+
+def get_kontakt(kontakt_id: int) -> Kontakt:
+    """
+    Liefert einen einzelnen Kontakt anhand seiner ID.
+    Wirft ApplicationError (404), falls der Kontakt nicht existiert.
+    """
+    kontakt = Kontakt.query.get(kontakt_id)
+    if kontakt is None:
+        raise ApplicationError(
+            "Kontakt mit der ID {} wurde nicht gefunden.".format(kontakt_id),
+            htmlstatus=HtmlStatusCode.Not_Found,
+        )
+    return kontakt
+
+
+def create_kontakt(data: dict) -> Kontakt:
+    """
+    Legt einen neuen Kontakt an. Die vom Client übergebene ID wird ignoriert;
+    die ID wird serverseitig per Auto-Increment vergeben.
+
+    - data: dict mit den Feldern kunden_id, anrede, name, position, telefon,
+            email, notiz
+    """
+    kunden_id = data.get("kunden_id")
+    if kunden_id is None:
+        raise ApplicationError(
+            "Es muss ein Kunde ausgewählt werden.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    kunde = Kunde.query.get(int(kunden_id))
+    if kunde is None:
+        raise ApplicationError(
+            "Der ausgewählte Kunde existiert nicht.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    if not data.get("name") or not str(data["name"]).strip():
+        raise ApplicationError(
+            "Der Kontaktname darf nicht leer sein.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    kontakt = Kontakt()
+    kontakt.kunden_id = int(kunden_id)
+    kontakt.anrede = (data.get("anrede") or "").strip() or None
+    kontakt.name = data["name"].strip()
+    kontakt.position = (data.get("position") or "").strip() or None
+    kontakt.telefon = (data.get("telefon") or "").strip() or None
+    kontakt.email = (data.get("email") or "").strip() or None
+    kontakt.notiz = (data.get("notiz") or "").strip() or None
+    session.add(kontakt)
+    session.commit()
+    return kontakt
+
+
+def update_kontakt(data: dict) -> Kontakt:
+    """
+    Aktualisiert einen bestehenden Kontakt. Die ID im data-Dict bestimmt den
+    zu ändernden Datensatz.
+    """
+    kontakt = get_kontakt(data["id"])
+    kunden_id = data.get("kunden_id")
+    if kunden_id is None:
+        raise ApplicationError(
+            "Es muss ein Kunde ausgewählt werden.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    kunde = Kunde.query.get(int(kunden_id))
+    if kunde is None:
+        raise ApplicationError(
+            "Der ausgewählte Kunde existiert nicht.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    if not data.get("name") or not str(data["name"]).strip():
+        raise ApplicationError(
+            "Der Kontaktname darf nicht leer sein.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    kontakt.kunden_id = int(kunden_id)
+    kontakt.anrede = (data.get("anrede") or "").strip() or None
+    kontakt.name = data["name"].strip()
+    kontakt.position = (data.get("position") or "").strip() or None
+    kontakt.telefon = (data.get("telefon") or "").strip() or None
+    kontakt.email = (data.get("email") or "").strip() or None
+    kontakt.notiz = (data.get("notiz") or "").strip() or None
+    session.commit()
+    return kontakt
+
+
+def delete_kontakt(kontakt_id: int):
+    """
+    Löscht einen Kontakt anhand seiner ID.
+    Wirft ApplicationError (404), falls der Kontakt nicht existiert.
+    """
+    kontakt = get_kontakt(kontakt_id)
+    session.delete(kontakt)
+    session.commit()