Server: Die list-Endpunkte für Kontakt, Projekt, Kontaktadresse und CallLog akzeptieren nun einen optionalen Query-Parameter (kunden_id bzw. projekt_id) und filtern im ORM-Query. Neue Migration V01.05 legt Indizes auf den FK-Spalten an. Client: Die fetch-Funktionen erhalten einen optionalen Parent-ID-Parameter. Die Listen-Komponenten übergeben die Parent-ID aus den Route-Params an den Server und laden nur noch benötigte Daten. Statt kompletter Eltern-Listen wird per fetchXxxById ein einzelner Datensatz für die Namensauflösung geladen. Die CallLog-Bearbeitungsmaske behält ihre ungesfilterten Dropdown-Abrufe. Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
128 lines
4.2 KiB
Python
128 lines
4.2 KiB
Python
"""
|
|
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(kunden_id: int | None = None):
|
|
"""
|
|
Liefert Kontakte, sortiert nach Name.
|
|
|
|
Ist kunden_id gesetzt, werden nur die Kontakte dieses Kunden
|
|
zurückgegeben (serverseitige Filterung). Ohne kunden_id werden
|
|
alle Kontakte geliefert.
|
|
"""
|
|
query = Kontakt.query
|
|
if kunden_id is not None:
|
|
query = query.filter(Kontakt.kunden_id == kunden_id)
|
|
return 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()
|