Files
kbcrm/App_Server/root/crm/model/kontakt.py
T
gg 93827dde0f Serverseitige Filterung für Listen-Endpunkte und Einzelabrufe in Listen-Komponenten
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>
2026-09-04 15:43:43 +02:00

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()